SIRC(C)                                                   SIRC(C)



NAME
       sirc - an IRC client in perl

SYNOPSIS
       sirc [options] [nickname [server]]

OPTIONS
       -d     Starts  sirc  in dumb mode (without the full-screen
              front-end).

       -p <port>
              Specifies the port number to connect to.

       -i <name>
              Specifies the IRCNAME to  use  (the  default  being
              ``sirc user'').

       -n <nick>
              Sets the nickname.

       -s <server>
              Sets the server that sirc should connect to.

       -l <filename>
              Specifies  a  file  to be loaded instead of ~/.sir-
              crc.pl.

       -L <filename>
              Specifies a file of commands  to  run,  instead  of
              ~/.sircrc.

       -H <hostname>
              Specifies a hostname to bind to, as a virtual host.

       -q     Doesn't load ~/.sircrc.pl or the  system-wide  sir-
              crc.pl.

       -Q     Doesn't  run commands from ~/.sircrc or the system-
              wide sircrc.

       -R     Runs in restricted mode (no shell access, no access
              to files).

       -8     Runs  in  eight-bit mode, not stripping iso-latin-1
              accented characters.

ARGUMENTS
       nickname
              Specifies the nickname to use on IRC.  The  default
              is taken from the environment variables SIRCNAME or
              IRCNAME.

       server Specifies the IRC server to connect to; an optional
              port  and  connection  password can be given in the
              form server.host:port:passwd.


DESCRIPTION
       sirc is an IRC client that is designed to  act  much  like
       ircII,  except  for  the  scripting  interface, which uses
       perl.

       All IRC commands start with a /, and a  detailed  descrip-
       tion of them is given by the command /help.

       The standard IRC commands that sirc recognizes are:

            ADMIN,  ALIAS,  AWAY,  BYE, CD, CLEAR, CONNECT, CTCP,
            DCC, DESCRIBE, DIE, EVAL, EXIT, HELP,  IGNORE,  INFO,
            INVITE,  JOIN,  KICK, KILL, LEAVE, LINKS, LIST, LOAD,
            LUSERS, MAP, ME, MODE, MOTD, MSG, NAMES, NICK,  NOTE,
            NOTICE, NOTIFY, OPER, QUERY, PART, PING, QUERY, QUIT,
            QUOTE, RPING, SAY,  SERVER,  SET,  SIGNOFF,  SILENCE,
            SQUIT,  STATS,  TIME,  TOPIC, TRACE, UPING, USERHOST,
            USERS, VERSION, WALLOPS, WHO, WHOIS, WHOWAS.

       In addition, sirc understands these  shortcuts  and  addi-
       tional commands, which are also described in the /help:

            CL, D, DEOP, DE, HOP, IG, I, INV, J, K, LL, M, MO, N,
            NEXT, NO, O, OP, P, SYSTEM, T, UMODE, W, WI

       For  general  information  about  IRC,  please   look   at
       http://www.irchelp.org/.


COPYING
       sirc is free software. You can redistribute it and/or mod-
       ify it under the GNU General Public License  as  published
       by the Free Software Foundation.  See the file LICENSE for
       details.


SEE ALSO
       ssfe(e), irc(c), ircd(d), talk(k), ytalk(k)


FILES
       ~/.sircrc
              user commands to run on startup.

       ~/.sircrc.pl
              perl script to load on startup.

       ~/.sirc
              directory where sirc looks for files to  load  with
              the /LOAD command.

       README information about sirc, installing and using it.

       PROGRAMMING
              information  about  how to use perl to make scripts
              for sirc.


ENVIRONMENT VARIABLES
       SSFE   options to pass to ssfe (see also ssfe(e))

       SIRCSERVER, IRCSERVER
              default server to connect to.

       SIRCPORT, IRCPORT
              default port to connect to.

       SIRCNAME, IRCNAME
              default IRCNAME to use; this is usually  your  name
              or a quote.

       SIRCNICK, IRCNICK
              default nickname to use.

       SIRCRC location  of your .sircrc file; defaults to ~/.sir-
              crc.

       SIRCRCPL
              location  of  your  .sircrc.pl  file;  defaults  to
              ~/.sircrc.pl.

       IRCFINGER
              default reply to CTCP FINGERs.

       USERINFO
              default reply to CTCP USERINFOs.

       SIRCHOST, IRCHOST, LOCALHOST
              hostname to bind to, for hosts with  multiple (vir-
              tual) addresses.


BUGS
       None known, please report to the author.


AUTHOR
       sirc    was    written    by     Roger     Espel     Llima
       <roger.espel.llima@pobox.com>.




Roger Espel Llima                                         SIRC(C)