Provided by: ircd-irc2_2.11.0-1_i386 bug

NAME

       ircd - The Internet Relay Chat Program Server

SYNOPSIS

       ircd   [  -abcioqst ] [ -f configfile ] [ -x debuglevel ] [ -h hostname
              ] [ -T tunefile ] [ -p mode ]

       ircd   -v

DESCRIPTION

       ircd is the  server  (daemon)  program  for  the  Internet  Relay  Chat
       Program.   The  ircd is a server in that its function is to "serve" the
       client program irc(1) with messages and  commands.   All  commands  and
       user  messages  are  passed  directly  to  the  ircd for processing and
       relaying to other ircd sites.  The irc(1) program  depends  upon  there
       being  an ircd server running somewhere (either on your local UNIX site
       or a remote ircd site) so that it will have somewhere to connect to and
       thus allow the user to begin talking to other users.

       ircd  will  reread its configuration file whenever it received a hangup
       signal, SIGHUP.

       Sending an interrupt signal to ircd process will cause it to restart.

OPTIONS

       -a     Instructs the server to automatically die off if  it  loses  all
              it’s clients.

       -b     If  the  ircd.tune file is corrupted, by default the server will
              not start.  This option will make the server start anyways, with
              the default values (ignoring the corrupted file).

       -c     This   flag   must  be  given  if  you  are  running  ircd  from
              /dev/console or any other situation where fd 0 isnt  a  tty  and
              you  want the server to fork off and run in the background. This
              needs to be given if you are starting ircd from an rc  (such  as
              /etc/rc.local) file.

       -i     The  server  was  started by inetd and it should start accepting
              connections from standard input. The  following  inetd.conf-line
              could be used to start up ircd automatically when needed:

       ircd stream tcp wait irc /etc/ircd ircd -i

              allows inetd to start up ircd on request.

       -q     Using this option stops the server from doing DNS lookups on all
              the servers in your ircd.conf file when it boots. This can  take
              a  lengthy  amount of time if you have a large number of servers
              and they are not all close by.

       -s     When this option is specified, iauth will not be started.   This
              means  that  the  IRC  daemon  will perform "ident lookups" (RFC
              1413)   internally   to   attempt   to   authenticate   incoming
              connections.  No other authentication mechanism will be used.

       -t     Instructs  the  server  to  direct  debugging output to standard
              output.

       -f filename
              Specifies the ircd.conf file to be used for this ircdaemon.  The
              option  is  used  to  override  the  default  ircd.conf given at
              compile time.

       -x #   Defines the debuglevel for ircd. The higher the debuglevel,  the
              more  stuff  gets directed to debugging file (or standard output
              if -t option was used as well).

       -h hostname
              Allows the user to manually set the server name at startup.  The
              default name is hostname.domainname.

       -p mode
              Specify  whether  the  server should enable built-in protections
              against various type of user abuse that is commonly found on big
              public  networks.   Possible  modes are strict (default), on and
              off.  The strict option enables the protections, and refuses  to
              establish a link to a server not running with this option.  This
              is useful to force all servers on an IRC network to enable them.

       -T tunefile
              Specifies  the ircd.tune file to be used for this ircdaemon. The
              option is used  to  override  the  default  ircd.tune  given  at
              compile  time.  If no tune file is given, reading and writing of
              tune file is disabled.

       -v     This option prevents the server from starting,  and  dumps  some
              information about the version instead.

       If you plan to connect your ircd server to an existing Irc-Network,
              you  will  need  to  alter  your  local  IRC  CONFIGURATION FILE
              (typically named "ircd.conf") so that it will  accept  and  make
              connections  to  other  ircd  servers.   This  file contains the
              hostnames,  Network  Addresses,  and  sometimes  passwords   for
              connections   to   other   ircds   around  the  world.   Because
              description of the actual file format of the "ircd.conf" file is
              beyond  the  scope  of  this  document, please refer to the file
              INSTALL in the IRC source files documentation directory.

       BOOTING THE SERVER:  The ircd server can be started as part of the UNIX
       boot  procedure  or  just  by  placing the server into Unix Background.
       Keep in mind that if it is *not* part of your UNIXES Boot-up  procedure
       then  you  will  have  to manually start the ircd server each time your
       UNIX is rebooted.  This means if your UNIX  is  prone  to  crashing  or
       going  for  for  repairs  a  lot  it would make sense to start the ircd
       server as part of your UNIX bootup procedure.  In some cases the irc(1)
       will  automatically  attempt  to boot the ircd server if the user is on
       the SAME UNIX that the ircd is supposed  to  be  running  on.   If  the
       irc(1)  cannot  connect  to  the  ircd  server it will try to start the
       server on it’s own and will then try to reconnect to the  newly  booted
       ircd server.

EXAMPLE

              tolsun% ircd

       Places  ircd  into  UNIX  Background  and starts up the server for use.
       Note:  You do not have to add the "&" to this command, the program will
       automatically detach itself from tty.

              tolsun% ircd -v
              ircd 2.9.3 AaCDEfFHiIkMsu_V1
                      zlib not used
                      Tue Apr 1 1997 at 20:17:50 EDT #1

       This  indicates  that this binary is the version 2.9.3 of the software.
       AaCDEfFHiIkMsu_V1 are the compile time options which were  used.   This
       binary  does  not  support compression of server-server links (does not
       use zlib) and was compiled on April the 1st.

COPYRIGHT

       (c) 1988,1989 University of Oulu, Computing Center, Finland,

       (c) 1988,1989 Department of Information Processing Science,  University
       of Oulu, Finland

       (c) 1988,1989,1990,1991 Jarkko Oikarinen

       For full COPYRIGHT see LICENSE file with IRC package.

FILES

        "ircd.conf"

SEE ALSO

       iauth(8) irc(1) ircdwatch(8)

BUGS

       None...   ;-)  if  somebody  finds  one,  please  send  mail  to  ircd-
       bugs@irc.org

AUTHOR

       Jarkko Oikarinen, currently jto@tolsun.oulu.fi, manual page written  by
       Jeff     Trim,     jtrim@orion.cair.du.edu,     later    modified    by
       jto@tolsun.oulu.fi.

                         $Date: 2004/11/16 16:59:19 $                  IRCD(8)