# irc - interface to the Internet Relay Chat system - man(1) - [phpMan] [_IRCII_(1)](https://www.chedong.com/phpMan.php/man/IRCII/1/markdown) General Commands Manual [_IRCII_(1)](https://www.chedong.com/phpMan.php/man/IRCII/1/markdown) ## NAME ircII — interface to the Internet Relay Chat system ## SYNOPSIS **irc **[**-abdFfqrSsTtv**] [**-c _**chan_] [**-D _**level_] [**-e _**protocol_ _level_] [**-H _**host_[_:port_]] [**-h _**host_[_:port_]] [**-I _**ircrcquick_] [**-icb**] [**-irc**] [**-l _**ircrc_] [**-o _**file_] [**-P _**portno_] [**-p _**portno_] [**-R _**host_[_:port_]] [_nickname_ [_server_ _list_]] [**--**] ## DESCRIPTION The **ircII **program is a full screen, termcap based interface to Internet Relay Chat. It gives full access to all of the normal IRC functions, plus a variety of additional options. ## OPTIONS The following options are supported: ### -a servers. ### -b ### -c _ ### -d and all output goes to stdout without using any of the [_termcap_(5)](https://www.chedong.com/phpMan.php/man/termcap/5/markdown) screen control codes. ### -D _ built with -DDEBUG. ### -e _ Currently, only "IRC" is supported for the _protocol_ and the values that _level_ can take are "check", "nocheck", and "off". Please also see the description of the "server list" below. ### -F switch is ignored if the **-d **switch is used. ### -f are both bound to other functions within **ircII**. This switch is ignored if the **-d **switch is used. ### -H _ for DCC, and works otherwise identically to the **-h **option. ### -h _ Useful only on multi-homed hosts. If the optional port segment is in‐ cluded, **ircII **will attempt to bind to this local port as well as local host address. If _host_ is an IPv6 "number", it must be provided in the common _file_ _..._ [12:34:ab:cd] format. This means for an IPv6 "number" and port, it would be written _[12:34:ab:cd]:6669_. ### -icb ### -irc ### -l _ ### -o _ **ircII **is built with -DDEBUG. ### -P _ ### -p _ Only supply this if you connect to a server which uses a port other than 6667. ### -q file set by the ### -I ### -R _ ### -r ### -S ### -s ### -T exist. ### -t fault). ### -v **-- **End all option processing. The remaining command line arguments are: **• _**nickname_ Set the nickname (overrides the environment variable IRCNICK; default: the user‐ name). **• _**server_ _list_ Set the list of servers with which **ircII **will try to connect upon startup. This list is also used by the program's **/server **command. For IRC connections, the format is: _host_[_:portno_[_:password_[_:nick_]]] For ICB connections, the format is: _ICB/host_ [_:portno_[_:nick_[_:group_[_:mode_]]]] with _group_ being the initial group and _mode_ being the initial group mode. See **/HELP ICB **for more information about ICB. If the _host_ is in the format _:servergroup:host.com_ then _servergroup_ is taken to be the Server Group for this server entry. If the _host_ is prefixed with **SSLIRC/ **or **SSLIRCNOCHECK/ **then an attempt will be made to initi‐ ate an SSL/TLS connection for this host. The **SSLIRCNOCHECK/ **form does not verify the remote server's certificate, which may have security implications. Please see SSL/TLS documentation for more information. If the _host_ is prefixed with **PROXY/host:port/ **then this server will be connected via speci‐ fied HTTP proxy server. The **NO_PROXY/ **prefix will disable any global proxy setting for this server. ## DETAILED DESCRIPTION ### The Screen The screen is split into two parts, separated by an inverse-video status line (if supported). The upper (larger) part of the screen displays responses from the IRC server. The lower part of the screen (a single line) accepts keyboard input. Some terminals do not support certain features required by **ircII**, in which case you receive a message stating this. If this occurs, try changing the terminal type or run **ircII **with the ### -d ### IRC Commands Any line beginning with the slash character (‘/’) is regarded as an **ircII **command (the com‐ mand character may be changed; type **/help set cmdchar**). Any line not beginning with this character is treated as a message to be sent to the current channel. To produce a listing of commands, type **/help ?**. To receive information about the commands type **/help **. ### The .ircrc File When **ircII **is executed, it checks the user's home directory for a _.ircrc_ file, executing the commands in the file. Commands in this file do not need to have a leading slash character (‘/’). This allows predefinition of aliases and other features. ## ENVIRONMENT It can be helpful to predefine certain variables in in the _.cshrc_, _.profile_, or _.login_ file: IRCNICK The user's **ircII **nickname. IRCNAME The user's IRC realname (otherwise retrieved from _/etc/passwd_) IRCSERVER The default IRC server(s) (see server option for details) IRCSERVERSFILE The file containing the default list of server(s), usually _PREFIX/share/irc/ircII.servers_. This file should contain one server entry per line. HOME Overrides the default home path in _/etc/passwd_. TERM The type of terminal in use. ## FILES _~/.ircrc_ default initialization file _~/.irc/_ directory into which you can put your own **ircII **scripts, that can then be loaded with **/load** _.../share/irc/_ directory containing message-of-the-day, master initialization, help files, and **ircII **scripts _.../share/irc/script/global_ file loaded at the start of every **ircII **session. _PREFIX/share/irc/ircII.servers_ The initial list of servers if none are provided on the command line. _PREFIX/share/irc/ircII.motd_ Message of the day. This file is displayed only once each time it is changed. ## EXAMPLES **irc -c #users -p 5555** Connect IRC to port number 5555 of the default host and enter on channel #users. **irc Mermaid** Use the nickname “Mermaid”. **irc Mermaid server1:5000 [server2::passwd](https://www.chedong.com/phpMan.php/perldoc/server2%3A%3Apasswd/markdown) server3** Use the nickname “Mermaid” and the modified server list. **irc piglet3 :ln:irc1.lamenet.org :ln:irc.us.lamenet.org** Use the nickname “piglet3”, initially connecting to irc.au.lamenet.org, with also irc.us.lamenet.org added to the server list, both having a server group name “ln”. **irc oink ICB/www.icb.net** Use the nick “oink” making an ICB connection to www.icb.net. **irc -d** Use dumb mode. **irc -f** Allow use of ^S/^Q to stop/start screen display. **irc -e elisa** Interface IRC with a program called “elisa”. setenv IRCNICK Mermaid setenv IRCNAME irc Set the username (if not specified elsewhere) to “Mermaid”. The user's name (when provided inside parentheses in response to a **WHOIS **command) is set to “The one and only :)”. ## THE HELP FILES All of the **ircII **commands are fully described in the help files package. The best way to start here is with the **/HELP ? **command as this prints a listing of all available help files. ## SIGNALS **ircII **handles the following signals SIGUSR1 Closes all DCC connections and EXEC'ed processes. SIGUSR2 Drops **ircII **back to the command line. ## SEE ALSO [_irc_(1)](https://www.chedong.com/phpMan.php/man/irc/1/markdown), [_ircd_(8)](https://www.chedong.com/phpMan.php/man/ircd/8/markdown) ## AUTHORS Program written by Michael Sandrof <_ms5n+@andrew.cmu.edu_>. Now being maintained by Matthew Green <<_mrg@eterna.com.au_>> Names of contributors and contact address can be retrieved with the **/info **command. This manual page written by Darren Reed <<_avalon@coombs.anu.EDU.AU_>>, revised by R. P. C. Rodgers <<_rodgers@maxwell.mmwb.ucsf.edu_>>, by the lynX, and by Matthew Green <<_mrg@eterna.com.au_>>. ## BUGS Please notify the current developer of the software of any bugs in current versions. Debian June 6, 2017 [_IRCII_(1)](https://www.chedong.com/phpMan.php/man/IRCII/1/markdown)