IRCC(1) Commands Manual IRCC(1) NAME ircc - simple client interface to the Internet Relay Chat system SYNOPSIS ircc [-s host:port] [-n nick] [-c channel] [-d] DESCRIPTION ircc is a simple Internet Relay Chat client that provides the basic IRC commands, plus additional functions to exchange files in direct client- to-client connections. OPTIONS -s Automatically connects to the IRC server on . -n Sets the nickname to . The rest of the parameters required for registration (username, realname) are also set to this value. -c Automatically joins . -d Debug mode. Developers use this option to show debug traces, that a normal user MUST NOT see. Note that none of the above options is mandatory to launch the ircc client. See the EXAMPLES section for more information. DETAILED DESCRIPTION COMANDS Any line beginning with the slash character '/' is regarded as an ircc command. Any line not beginning with this character is treated as a message to be sent to the current channel (equivalent to use /msg). Empty lines are allowed and interpreted as a /nop command (see bellow). The full list of commands that ircc implements is: /help Shows help /connect Connects to the IRC server on . /auth Authenticates with the server, sets nickname, username and real name to . /list Lists all current IRC channels, number of users, and topic. /join [] Joins channel . In case no is provided, it simply tells which is the current channel. If the user was already in a channel, this command make the user leave the cur- rent channel and join the new one. /leave Leaves your current channel. /who Lists users in current channel. /info Shows IP address information from . /msg Sends to the current channel. /disconnect Disconnects from server. /quit Closes program. /nop [] (Debugging) no operation, just echoes back. /sleep [] (Debugging) pauses for seconds. OUTPUT FORMATS The following conventions for output formatting are followed: Lines beginning with '*** ' are messages from the program. Lines beginning with ' ' are messages from the user with the nick 'user'. Lines beginning with 'DDD ' are debug messages from the program. Lines beginning with '> ' are your messages to other users. EXAMPLES A typical user session STEP1. Launch ircc: ircc STEP2. Connect to a IRC server that runs on the local machine, port 6691: /connect localhost:6691 *** Connected to server localhost:6691 STEP3. Resgister the user: /auth alcortes *** Welcome to the Internet Relay Network alcortes!~alcortes@local- host (from group021.ro2.uc3m.irc.net) *** Your host is group021.ro2.uc3m.irc.net, running version ngircd-16 (i686/pc/linux-gnu) *** This server has been started Mon Sep 13 2010 at 19:57:28 (CEST) *** umodes available aiorsw, channel modes available biIklmnoPstvz *** Unknown message from server with command <005> *** Unknown message from server with command <005> *** There are 2 users and 0 services on 1 servers *** 4 channels formed *** I have 2 users, 0 services and 0 servers *** Message received with a command unknown to RFC2812 (265) *** Message received with a command unknown to RFC2812 (266) *** Message received with a command unknown to RFC2812 (250) *** Message received with a command unknown to RFC2812 (375) *** - group021.ro2.uc3m.irc.netmessage of the day *** - "Today's MOTD is irrelevant" STEP4. List existing channels on the IRC network: /list *** #test1 1 Test channel 1 *** #test0 1 Test channel 0 *** #ro2 1 RO2 Channel *** &SERVER 0 Server Messages STEP5. Join a channel: /join #ro2 *** alcortes has joined channel #ro2 *** Topic for #ro2: RO2 Channel *** Message received with a command unknown to RFC2812 (333) *** Users in channel #ro2: alcortes ircII STEP6. Show users on the current channel /who *** #ro2 alcortes *** #ro2 ircII STEP7. Talk to users on the current channel: hello world! > hello world! STEP8. Leave the current channel /leave *** alcortes has left channel #ro2 STEP9. Disconnect from server /disconnect *** Disconnected from server STEP10. Exit ircc /quit *** bye! Note that depending on the initial invocation of ircc, STEPS 2, 3 and 5 can be automatically performed on startup. For example, the line: ircc localhost:6691 -n alcortes -c '#ro2' will launch the client, connect to the server on localhost:6691, regis- ter alcortes on the IRC network and join to #ro2 channel. So, (if no errors ocurred) we will have the following result when checking the current channel after the above execution line: /join *** You are on channel #ro2 Note that it has no sense to provide the nick and/or channel options to the command line if the server option has not been also provided and the program must exit in error. If the channel option is present at the command line but the nick and server option are missing, the pro- gram will exit in error. AUTHORS Teachers of Computer Networks II SEE ALSO RFC 2812 STANDARDS ircc is based on RFC 2812, but it is simplified for didactic purposes. October 6th, 2012 IRCC(1)