Tinyircd is a small, standalone IRC server. This means that it will not talk
to other IRC servers, but only to clients that connect directly to it.
Tinyircd should run on most Unix-ish systems.

You will probably want to have the following packages installed:
  - daemontools 
    http://cr.yp.to/daemontools.html
  - ucspi-tcp
    http://cr.yp.to/ucspi-tcp.html

These packages aren't strictly necessary (you can run tinyircd out of inetd,
for example), the installation instructions assume their presence.

INSTALLING

1. Edit conf-* to specify your compiler, etc.

2. Build and install the binaries.
   $ make setup check

3. Create "tinyircd" and "irclog" accounts for your server to run as. Note
   that the user adding commands may be different for your system.
   $ adduser tinyircd
   $ adduser irclog

3. Configure tinyircd to run. The SERVER_NAME should be replaced with the
   name of your server. It's not really important what this value is, but
   it will be shown in the banner message when clients connect.
   $ tinyircd-conf tinyircd irclog /var/tinyircd SERVER_NAME

4. Configure passfd. Tinyircd doesn't accept network connections; it expects
   other programs to pass file descriptors to it over a UNIX domain socket.
   This allows you to have several different listening sockets connect to
   the same IRC server. The following command sets up a listener on the
   loopback interface, port 6667.
   $ passfd-conf tinyircd irclog /var/tinyircd-listen 127.0.0.1 6667 \
      /var/tinyircd/sock/incoming

5. Tell svscan to start your services.
   $ ln -s /var/tinyircd /service/tinyircd
   $ ln -s /var/tinyircd-listen /service/tinyircd-listen

You can provide as many passfd listeners as you want for a given tinyircd
server. Just point them all at the same "incoming" socket. Passfd-conf uses
tcpserver to listen for connections. You can edit the
/var/tinyircd-listen/run script to use other ucspi servers, such as
sslserver.
