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
        /var/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)