NAME

       ippl - IP Protocols Logger

SYNOPSIS

       ippl [-hn] [-c file-name] [--help] [--nodaemon] [--config file-name]

DESCRIPTION

       ippl  is an IP protocols logger. It logs incoming TCP connections, UDP datagrams and ICMP packets sent to
       a host.

       ippl is based on the well-known iplogger written by Mike Edulla. The main drawback of iplogger is that it
       is not (easily) configurable.  ippl has been  written  keeping  in  mind  that  it  should  be  extremely
       configurable and it should be easy to extend its logging capabilities.

OPTIONS

       -c file-name, --config file-name
              file-name  specifies  an  alternate  configuration  file to use. By default, CONFIGURATION_FILE is
              used.

       -h, --help
              Print a usage message on standard output and exits successfully.

       -n, --nodaemon
              This option cause ippl not to place itself in the background. The log messages will be  logged  to
              standard output instead of using syslog.

SIGNALS

       ippl reacts to certain signal. An easy way to send it signals is to use the following command:

                  kill -SIGNAL `cat PID_FILE`

       SIGHUP This  causes  ippl  to close all the open sockets and log files, reread the configuration file and
              restart. Note that this signal should be sent to ippl if the log files are renamed or deleted.

       SIGTERM
              ippl will cleanly die.

       SIGINT If ippl has been started with th -n option, it will cleanly die.

FILES

        /etc/ippl.conf - configuration file
        /usr/share/doc/ippl/* - files worth reading if you still have a question
        /run/ippl/ippl.pid - file containing the PID of the running ippl

SEE ALSO

       ippl.conf(5), RFC768, RFC791, RFC792, RFC793, RFC1413

AUTHORS

       Hugo Haas (hugo@larve.net) Etienne Bernard (eb@via.ecp.fr)

       Information about ippl development can be found at http://larve.net/ippl/.

       New stable releases can be dowloaded via FTP on sunsite.unc.edu in /pub/Linux/system/network/daemons.

MAILING LISTS

       Two mailing lists have been setup. Send an email to listar@via.ecp.fr to subscribe  to  the  announcement
       list (ippl-announce) or to the development list (ippl).

BUGS

       If ippl spends too much time resolving host names, some packets may not be logged.

       The  logclosing  option logs TCP connection terminations. However, it logs terminations initiated by both
       ends, which is not the expected behavior.

       Please reports any bug to ippl@via.ecp.fr

                                           Last change: 21 April 2000                                    IPPL(8)