---
name: "sirc"
section: "1"
platform: "linux"
package: "sirc"
version: "2.211-9.1"
release: "Debian 6.0 (Squeeze)"
platforms: ["linux"]
url: "https://new.carta.tech/sirc"
---

# sirc(1)

an IRC client in perl

## 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.

## SEE ALSO

[**ssfe**(1)](/ssfe/1.md), [**irc**(1)](/irc/1.md), [**ircd**(8)](/ircd/8.md), [**talk**(1)](/talk/1.md), [**ytalk**(1)](/ytalk/1.md)

## 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)](/ssfe/1.md))

- **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\>.