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 ~/.sircrc.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 sircrc.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 description 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 additional 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 modify it under the GNU General Public License as published by the Free Software Foundation. See the file LICENSE for details.

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(1))
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 ~/.sircrc.
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 (virtual) addresses.

BUGS

None known, please report to the author.

AUTHOR

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