| 1 |
.\" @(#)ircd.8 7b10 25 Oct 2001 |
| 2 |
.\" $Id$ |
| 3 |
.TH IRCD 8 "14 May 2003" "ircd-hybrid-7" |
| 4 |
.SH NAME |
| 5 |
ircd \- The IRCD-Hybrid Internet Relay Chat server |
| 6 |
.SH SYNOPSIS |
| 7 |
.hy 0 |
| 8 |
.IP \fBircd\fP |
| 9 |
[-configfile filename] [-dlinefile filename] [-klinefile filename] |
| 10 |
[-xlinefile filename] [-logfile filename] [-pidfile filename] [-foreground] |
| 11 |
[-version] |
| 12 |
.SH DESCRIPTION |
| 13 |
.LP |
| 14 |
\fIircd\fP is the server (daemon) program for the Internet Relay Chat |
| 15 |
Program. The \fIircd\fP is a server in that its function is to "serve" |
| 16 |
the client program \fIirc(1)\fP and other compatible programs with |
| 17 |
messages and commands. All commands and user messages are passed |
| 18 |
directly to the \fIircd\fP for processing and relaying to other IRC |
| 19 |
servers. |
| 20 |
|
| 21 |
This is \fIircd-hybrid\fP, the highly modified (and hopefully improved) |
| 22 |
variant of the original ircd program by Jarkko Oikarinen. |
| 23 |
.SH OPTIONS |
| 24 |
.TP |
| 25 |
.B \-configfile filename |
| 26 |
Specifies the ircd.conf file to be used for this \fIircd\fP. The option |
| 27 |
is used to override the default ircd.conf given at compile time. By default, |
| 28 |
this is "etc/ircd.conf" within the prefix you installed the \fIircd\fP in. |
| 29 |
.TP |
| 30 |
.B \-dlinefile filename |
| 31 |
.TP |
| 32 |
.B \-klinefile filename |
| 33 |
.TP |
| 34 |
.B \-xlinefile filename |
| 35 |
Specifies the files to be used for D-lines (host bans), K-lines (hostmask bans), |
| 36 |
and X-lines (gecos bans), which by default are within the etc/ directory of your |
| 37 |
installation prefix as dline.conf, kline.conf, and xline.conf. |
| 38 |
.TP |
| 39 |
.B \-logfile filename |
| 40 |
Specifies an alternative logfile to be used than that specified in defaults.h |
| 41 |
.TP |
| 42 |
.B \-pidfile filename |
| 43 |
Specifies the file used by the \fIircd\fP to store its process ID. The option is |
| 44 |
used to override the default ircd.pid given at compile time. |
| 45 |
.TP |
| 46 |
.B \-foreground |
| 47 |
Makes \fIircd\fP run in the foreground |
| 48 |
.TP |
| 49 |
.B \-version |
| 50 |
Makes \fIircd\fP print its version, and exit. |
| 51 |
.SH USAGE |
| 52 |
If you plan to connect your \fIircd\fP server to an existing IRC network, |
| 53 |
you will need to alter your local IRC configuration file (typically named |
| 54 |
"ircd.conf") so that it will accept and make connections to other \fIIRC\fP |
| 55 |
servers. This file contains the hostnames, IP addresses, and sometimes |
| 56 |
passwords for connections to other ircds around the world. |
| 57 |
|
| 58 |
The example ircd.conf in the etc/ directory documents itself. Read it |
| 59 |
carefully or you may expose a risk on your network simply by having your |
| 60 |
ircd running! |
| 61 |
.LP |
| 62 |
.SH BOOTING THE SERVER |
| 63 |
It is sufficient to type \fBircd\fP at the command line to start |
| 64 |
ircd-hybrid into the background. If you wish to run ircd in the |
| 65 |
foreground (perhaps for debugging purposes), use the \fB-foreground\fP |
| 66 |
parameter. |
| 67 |
|
| 68 |
The ircd-hybrid package in your distribution may ship with an rc-script |
| 69 |
which handles this for you. In Debian, it is \fB/etc/init.d/ircd-hybrid.\fP |
| 70 |
|
| 71 |
.SH EXAMPLE |
| 72 |
# ircd -configfile /usr/share/ircd/ircd.conf -logfile /var/log/ircd.log |
| 73 |
|
| 74 |
Starts \fBircd\fP with the config file /usr/share/ircd/ircd.conf and |
| 75 |
with a log file /var/log/ircd.log. It implicitly forks back to the |
| 76 |
console -- to prevent this use -foreground. |
| 77 |
|
| 78 |
Many of the above paths are hardcoded at compile time in the |
| 79 |
\fBinclude/defaults.h\fP file, so it may be convenient to edit these to |
| 80 |
suit your needs before you compile the ircd. |
| 81 |
.SH COPYRIGHT |
| 82 |
(c) 1988,1989 University of Oulu, Computing Center, Finland, |
| 83 |
.LP |
| 84 |
(c) 1988,1989 Department of Information Processing Science, |
| 85 |
University of Oulu, Finland |
| 86 |
.LP |
| 87 |
(c) 1988-1991 Jarkko Oikarinen |
| 88 |
.LP |
| 89 |
(c) 1997-2003 The IRCD-Hybrid project. |
| 90 |
.LP |
| 91 |
For full COPYRIGHT see the LICENSE file within the IRC source package. |
| 92 |
.LP |
| 93 |
.RE |
| 94 |
.SH BUGS |
| 95 |
If you find a bug and you have a core file from ircd as a result, use a |
| 96 |
debugger like \fBgdb(1)\fP to process the core file and send a backtrace |
| 97 |
to \fBbugs@ircd-hybrid.org\fP. |
| 98 |
|
| 99 |
.SH AUTHORS |
| 100 |
irc2.8 and earlier: Jarkko Oikarinen, currently jto@tolsun.oulu.fi. See |
| 101 |
doc/old/Authors for more credits. |
| 102 |
.LP |
| 103 |
ircd-hybrid-7: the IRCD-Hybrid Project, bugs@ircd-hybrid.org. |
| 104 |
.LP |
| 105 |
Manual page written by Jeff Trim, jtrim@orion.cair.du.edu, |
| 106 |
later modified by jto@tolsun.oulu.fi. |
| 107 |
.LP |
| 108 |
Updated by W. Campbell, wcampbel@botbay.net, Edward Brocklesby, |
| 109 |
ejb@klamath.uucp.leguin.org.uk, and highly revised by Joshua Kwan |
| 110 |
(joshk@triplehelix.org) for the Debian distribution. |
