ircII - interface to the Internet Relay Chat system
SYNOPSISirc [-c chan] [-p portno] [-P portno] [-b] [-f] [-F] [-s] [-S] [-t]
[-T] [-d] [nickname [server list]] [-a] [-v] [-q] [-h hostname ] [-icb]
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.
Automatically join channel chan .
Set the IRC port number to portno (default: 6667, the standard
IRC port). Only supply this if you connect to a server which
uses a port other than 6667.
Set the ICB port number to portno (default: 7326, the standard
-b Load the .ircrc file before connection to a server, not after‐
-f Use flow control (^S and ^Q) to stop/start the display. Nor‐
mally these are both bound to other functions within irc. This
switch is ignored if the -d switch is used.
-F Don't use flow control (^S and ^Q) to stop start the display.
This switch is ignored if the -d switch is used.
-s Don't start up the ircio process to connect to the IRC server
-S Start up the ircio process to connect to the IRC server.
-t Don't use the termcap ti and te sequences when starting and
-T Do use the termcap ti and te sequences when starting and exiting
if they exist.
-d Start in "dumb" mode. All input is taken directly from stdin
and all output goes to stdout without using any of the term‐
cap(5) screen control codes.
Set the nickname (overrides the environment variable IRCNICK;
default: the username).
server Set the list of servers with which irc will try to connect upon
startup. This list is also used by the program's /server com‐
mand. The format for lines in the list is:
hostname [:portno[:password[:nick]]] for IRC connections. For
ICB connections, the format is:
ICB/hostname [: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 hostname is in the format :servergroup:host.com then
servergroup is taken to be the Server Group for this server
-a This adds the normal irc server list to the command line list of
-v Print the version and release date of ircII and exit.
-q Start up irc quickly -- don't load the IRCRC file.
This option instructs ircII to use the given hostname as the
local address. Useful only on multi-homed hosts.
-icb Use ICB connections by default.
-irc Use IRC connections by default.
The screen is split into two parts, separated by an inverse-video sta‐
tus line (if supported). The upper (larger) part of the screen dis‐
plays 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 option.
Any line beginning with the slash character '/' is regarded as an ircII
command (the command character may be changed; type '/help set cmd‐
char'). 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 <command> '.
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 predef‐
inition of aliases and other features.
EXAMPLESirc-c #users -p 5555
Connect IRC to port number 5555 of the default host and enter on
Use the nickname "Mermaid".
irc Mermaid server1:5000 server2::passwd server3
Use the nickname "Mermaid" and the modified server list.
irc piglet3 :ln:irc1.lamenet.org :ln:irc1.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.
Interface IRC with a program called elisa.
setenv IRCNICK Mermaid
setenv IRCNAME "The one and only :)"
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 :)".
.../bin/ircII the executable program
~/.ircrc default initialization file
~/.irc/ directory you can put your own ircII scripts
into, that can then be loaded with /load
.../lib/irc/ directory containing message-of-the-day, master
initialization, help files and ircII scripts
.../lib/irc/script/global file loaded at the
start of every ircII session.
THE HELP FILES
All of the ircII commands are fully described in the help files pack‐
age. The best way to start here is with the /HELP ? command as this
prints a listing of all available help files.
ircII handles the following signals
Closes all DCC connections and EXEC'ed processes.
Drops ircII back to the command line.
It can be helpful to predefine certain variables in in the .cshrc,
.profile, or .login file:
The user's IRC nickname.
The user's IRC realname (otherwise retreived from /etc/passwd)
The default IRC server(s) (see server option for details)
The file containing the default list of server(s), usually PRE‐
FIX/lib/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.
ircII uses the following files under the library directory, usually
The initial list of servers if none are provided on the command
Message of the day. This file is displayed only once each time
it is changed.
SEE ALSOirc(1), ircd(8)BUGS
Please notify the current developer of the software of any bugs in cur‐
Program written by Michael Sandrof (email@example.com). Now being
maintained by Matthew Green (firstname.lastname@example.org) Names of contributors
and contact address can be retrieved with the /info command. This man‐
ual page written by Darren Reed (email@example.com.EDU.AU), revised by
R. P. C. Rodgers (firstname.lastname@example.org), by the lynX, and by
Matthew Green (email@example.com).
31 October 2002 IRCII(1L)