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)