IRCC(1) Commands Manual IRCC(1) NAME ircc - simple client interface to the Internet Relay Chat system SYNOPSIS ircc [-l] [-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 -l Legacy mode. DCC SEND command will not include the filesize parameter. -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. /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. /offer Launch a DCC server for a file transfer. The recipient must accept your offer with a /download command. /download Starts a file transfer by direct client connection. The sender must first have offered the file with an /offer command. /dccinfo Shows existing uploads and downloads. Number of bytes downloaded and uploaded MUST be shown. In the case of uploads, filesize MUST also be shown 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. Another user with the nick 'harry' joins the channel and talks to you: *** harry has joined channel #ro2 hi there! STEP9. The new user offers you a file to download /offer main.cc alcortes *** Sent offer request of file main.cc to alcortes STEP10. You receive the request and download the file *** File offer from harry *** use "/download main.cc 127.0.0.1:53037" to download /download main.cc 127.0.0.1:53037 *** Downloading file main.cc *** Download finished STEP11. User harry will know when your start and finish the download *** alcortes is downloading file main.cc *** alcortes finished the download of file main.cc STEP12. Leave the current channel /leave *** alcortes has left channel #ro2 STEP13. Disconnect from server /disconnect *** Disconnected from server STEP14. 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 -s 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. September 21, 2010 IRCC(1)