This is the source of pringd, the parallel ring daemon.

Pringd will listen to your modem and execute commands when the phone
rings, guided by rules.

The current version is 1.0.

A full installation consists of:

    pringd        - the executable
    man8/pringd.8 - the manual page
    pringd.conf   - the run time configuration file

The binary goes into the directory indicated with SBINDIR in the Makefile.
The manual page goes into the directory indicated with MANDIR in the
Makefile.

You must make the run time configuration file yourself.  An example
is provided in the distribution, but you will have to modify it for
your situation.  Read the manual page for information on what it should
look like.

The compile time configuration is done with a sed script, called subst.
It is used to generate some source files (config.c,pringd.man) from
corresponding templates.  The defaults in subst are probably okay if
you use FSSTND, but you can modify it if your system's configuration
is different.

Requirements to compile:

(1) C compiler.
(2) Flex scanner generator (lex probably will do).
(3) Bison parser generator (yacc probably won't do).
(4) Sed.

Requirements to run:

(1) A modem with a RI (Ring Indication) line connected to a serial port.
    An internal modem will probably do.
(2) A reasonably recent Linux with TIOCMIWAIT ioctl.

How to install:

(1) Unpack the archive.
(2) Edit the `Makefile' to determine where executable and manpage go.
(3) Edit `subst' to define your compile time configuration.
(4) Do a `make'.
(5) Do a `make install', probably as root.
(6) Make the run time configuration file from template `pringd.conf'
(7) Install the run time configuration file.
(8) Start pringd by hand and/or arrange to have it started at system boot.

Pringd need not run as root.  However, it needs access to the modem
device, so be sure the permissions are right.
