man pages section 1: User Commands

Exit Print View

Updated: July 2014

ircII (1)


ircII - interface to the Internet Relay Chat system


irc  [-c  chan]  [-p portno] [-P portno] [-b] [-f] [-F] [-s]
[-S] [-t] [-T] [-d] [nickname [server list]] [-a] [-v]  [-q]
[-h hostname ] [-icb] [-irc]


Misc. Reference Manual Pages                            IRCII(1L)

     ircII - interface to the Internet Relay Chat system

     irc  [-c  chan]  [-p portno] [-P portno] [-b] [-f] [-F] [-s]
     [-S] [-t] [-T] [-d] [nickname [server list]] [-a] [-v]  [-q]
     [-h hostname ] [-icb] [-irc]

     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.

     -c chan
          Automatically join channel chan .

     -p portno
          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.

     -P portno
          Set the ICB port number to portno (default:  7326,  the
          standard ICB port).

     -b   Load the .ircrc file before connection to a server, not

     -f   Use flow control (^S and ^Q) to stop/start the display.
          Normally 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

     -s   Don't  start up the ircio process to connect to the IRC
          server (default).

     -S   Start up the  ircio  process  to  connect  to  the  IRC

     -t   Don't use the termcap ti and te sequences when starting
          and exiting (default).

     -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 termcap(5) screen control codes.

SunOS 5.11         Last change: 31 October 2002                 1

Misc. Reference Manual Pages                            IRCII(1L)

          Set  the  nickname  (overrides the environment variable
          IRCNICK; default: the username).

          Set the list of servers with which irc will try to con-
          nect  upon startup.  This list is also used by the pro-
          gram's /server command.  The format for  lines  in  the
          list is:

          hostname  [:portno[:password[:nick]]]  for  IRC connec-
          tions.  For ICB connections, the format is:

          ICB/hostname   [:portno[::nick[:group[:mode]]]]    with
          group  being  the initial group and mode being the ini-
          tial group mode.  See /HELP ICB  for  more  information
          about ICB.

          If  the hostname is in the format
          then servergroup is taken to be the  Server  Group  for
          this server entry.

     -a   This  adds  the  normal  irc server list to the command
          line list of irc servers.

     -v   Print the version and release date of ircII and exit.

     -q   Start up irc quickly -- don't load the IRCRC file.

     -h hostname
          This option instructs ircII to use the  given  hostname
          as  the  local  address.   Useful  only  on multi-homed

     -icb Use ICB connections by default.

     -irc Use IRC connections by default.

  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

     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.

SunOS 5.11         Last change: 31 October 2002                 2

Misc. Reference Manual Pages                            IRCII(1L)

  Irc Commands:
     Any  line beginning with the slash character '/' is regarded
     as an ircII command (the command 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  <com-
     mand> '.

  The .ircrc File:
     When  ircII is executed, it checks the user's home directory
     for a .ircrc file, executing the commands in the file.  Com-
     mands in this file do not need to have a leading slash char-
     acter '/'.  This allows predefinition of aliases  and  other

     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 server3
          Use the nickname  "Mermaid"  and  the  modified  server

     irc piglet3
          Use  the  nickname  "piglet3",  initially connecting to
, with also  added
          to  the  server  list,  both having a server group name

     irc oink ICB/
          Use  the  nick  "oink"  making  an  ICB  connection  to

     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 "The one and only :)"

     irc  Set  the username (if not specified elsewhere) to "Mer-
          maid".   The  user's   name   (when   provided   inside

SunOS 5.11         Last change: 31 October 2002                 3

Misc. Reference Manual Pages                            IRCII(1L)

          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.

     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.

     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

          The  default  IRC  server(s)  (see  server  option  for

          The file containing the default list of server(s), usu-
          ally  PREFIX/lib/irc/ircII.servers.   This  file should
          contain one server entry per line.

SunOS 5.11         Last change: 31 October 2002                 4

Misc. Reference Manual Pages                            IRCII(1L)

     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 PREFIX/share/irc.

          The initial list of servers if none are provided on the
          command line.

          Message of the day.  This file is displayed  only  once
          each time it is changed.

     See   attributes(5)   for   descriptions  of  the  following

     |Availability   | network/chat/ircii |
     |Stability      | Uncommitted        |
     irc(1), ircd(8)

     Please notify the current developer of the software  of  any
     bugs in current versions.

     Program  written  by Michael Sandrof (
     Now being maintained by  Matthew  Green  (
     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
     (, by the lynX, and by Matthew
     Green (

     This   software   was   built   from   source  available  at   The   original
     community       source       was       downloaded       from

SunOS 5.11         Last change: 31 October 2002                 5

Misc. Reference Manual Pages                            IRCII(1L)

     Further information about this software can be found on  the
     open        source        community        website        at

SunOS 5.11         Last change: 31 October 2002                 6