BitchX - an advanced Internet Relay Chat client

scr-bx - restore detached BitchX session

xbitchx - X wrapper for BitchX

bitchx [-aAbdfqxvBFRZP] [-H hostname] [-c channel] [-p port] [-r file] [-n nickname] [-l file] [-L file] [nickname] [server list] xbitchx scr-bx

BitchX is a VERY heavily modified ircII client. It includes many things such as built in CDCC (XDCC) offering, built in flood protection, etc. It is easier to script things in BitchX because unlike plain, vanilla ircII, half the script does not have to be devoted to changing the appearance of ircII. It also includes many other new features, such as port scanning, adcanced TCL, a CD player, a mail client, screening process, etc. BitchX - based on EPIC Software Labs epic ircII (1998). Version (BitchX-75p2-8) -- Date (19980708). xbitchx is a wrapper script that loads the BitchX X11 font configuration from /etc/bitchx/xfont file, and runs BitchX under a nice XTerm window. scr-bx is used to reattach screens after /detach.

-a

use the default servers list, as well as servers given on the command line.

-A

do not display the startup ANSI graphics.

-b

load .bitchxrc or .ircrc after connecting to a server (default).

-B

fork and return you to shell.

-c <channel>

automatically join the channel <channel> after connecting to a server. You usually need to escape the hash (#) character with backspace ().

-d

use a "dumb" terminal.

-f

your terminal uses flow control (^S/^Q), so BitchX should not use these chars.

-F

your terminal does not use flow control (default).

-h

display help, all available options.

-H <hostname>

use the virtual name <hostname> if possible.

-l <file>

use <file> instead of the usual .ircrc file.

-L <file>

use <file> instead of the usual .ircrc , and expand $ expandos.

-n <nickname>

set your IRC nickname to <nickname>.

-N

do not automatically connect to the first server.

-p <port>

use <port> as the default server connection port (normally 6667).

-P

toggle check pid.nickname for running program.

-q

don't load ~/.ircrc on startup.

-r <file>

read <file> to get a list of IRC-servers. The <file> is a whitespace-separated list of server names.

-ssl

Use SSL (default protocol 2/3) to connect to the initial server.

-ssl2

Use SSL (protocol 2 only) to connect to the initial server.

-ssl3

Use SSL (protocol 3 only) to connect to the initial server.

-v

show version.

-x

run in debug mode.

-Z

use NAT address when doing DCC. Lets you specify your real address if you're using a machine that is being nat'd Network Address Translation - when you map N-to-M (IP masquerading is a special case of N-to-1 NAT). See http://www.csn.tu-chemnitz.de/HyperNews/get/linux-ip-nat.html for more information.

BitchX has lots of internal documentation. Try using /ehelp, /bhelp, and /help. There is also documentation in /usr/share/doc/bitchx.

/usr/lib/bitchx/, /etc/bitchx/

System-wide configuration directories

~/.BitchX/BitchX.sav

Personal configuration file

~/.BitchX/BitchX.ircnames

Default random real name(s)

~/.BitchX/BitchX.formats

Personal BitchX display formats

~/.BitchX/BitchX.reasons

Default random kick message(s)

~/.BitchX/BitchX.quit

Default random quit message(s)

~/.Bitchx/BitchX.help

User help-file.

~/.Bitchx/screens/

Storage directory for BitchX session screens.

BitchX was written by Colten Edwards <panasync@bitchx.com> This manpage was written by Wichert Akkerman and later updated by Robert Durdle and Josip Rodin.