.Dd May 19, 2025
.Dt IRCD 8
.Os
.Sh NAME
.Nm ircd
.Nd Internet Relay Chat daemon, part of the SDM IRC Suite
.Sh SYNOPSIS
.Nm
.Op Fl abciqstv
.Op Fl f Ar config-file
.Op Fl h Ar hostname
.Op Fl p Ar mode
.Op Fl x Ar loglevel
.Op Fl T Ar tunefile
.Sh DESCRIPTION
.Nm
is the server (daemon) program for the Internet Relay Chat
protocol.
.Sh OPTIONS
.Bl -tag -width 11n
.It Fl a
Instructs the server to automatically die off if it loses all of its clients
.It Fl b
If the
.Pa ircd.tune
file is corrupted, by default the server will not start.
This option will make the server start anyways, with the default values
(ignoring the corrupted file)
.It Fl c
This flag must be given if you are running
.Nm
from
.Pa /dev/console
or any other situation where fd 0 isn't a tty and you want the server to fork
off and run in the background.
This needs to be given if you are starting
.Nm
from an
.Pa rc
(such as rc.local) file.
.It Fl f
Specifies the
.Pa ircd.conf
file to be used for this IRC daemon.
The option is used to override the default
.Pa ircd.conf
given at compile time.
.It Fl h
Allows the user to manually set the server name at startup.
.It Fl i
The server was started by
.Xr inetd 8
and it should start accepting connections
from standard input.
.It Fl p
Specify whether the server should enable built-in
protections against various type of user abuse that is
commonly found on big public networks.
.It Fl q
Using this option stops the server from doing DNS lookups on all the
servers in your
.Pa ircd.conf
file when it boots.
This can take a lengthy amount of time if you have a large number of servers and they are not all close by.
.It Fl s
When this option is specified,
.Nm iauth
will not be started.
This means that the IRC daemon will perform "ident
lookups" (RFC 1413) internally to attempt to authenticate
incoming connections.
No other authentication mechanism will be used.
.It Fl t
Instructs the server to direct debugging output to standard output and to
not fork nor detach from terminal.
.It Fl v
This option prevents the server from starting, and dumps
some information about the version instead.
.It Fl x
Defines the debuglevel for
.Nm
The higher the debuglevel, the more stuff
gets directed to debugging file (or standard output if -t option was used
as well).
.It Fl T
Specifies the ircd.tune file to be used for this server.
The option is used to override the default
.Pa ircd.tune
given at compile time.
If no tune file is given, reading and writing of tune file is disabled.
.El
.Sh HISTORY
Nishi, one of the employees of Yakumo Laboratories, forked the original project recently.
Based on the last released version, some major changes were done to it, such as adding support
for Microsoft Windows, modifying the configuration schema, and introducing extra flags such as
skipping checks for Ident and SSL/TLS support in the P-lines.
.Pp
It also features a Services package of its own, provided with the distribution, exclusively made
for this project.
.Sh COPYRIGHT
.Sy (c) 1988-1989 University of Oulu, Computing Center, Finland
.Pp
.Sy (c) 1988-1989 Department of Information Processing Science, University of Oulu, Finland
.Pp
.Sy (c) 1988-1991 Jarkko Oikarinen
.Pp
For full COPYRIGHT see LICENSE file included with the distribution
.Sh AUTHORS
.An Jarkko Oikarinen, et. al
.An Nishi Aq Mt nishi@nishi.boats
.Pp
This manual page is based on the original material
found in later releases by IRCnet, rewritten in
.Xr mdoc 7
by
.An Izuru Yakumo Aq Mt eternal-servant@yakumo.dev
.Sh BUGS
.Nm
will freeze under certain conditions and stop working altogether.
.Pp
Maybe
.Xr kqueue 2
et al. would be really handy here