IPPL(8) 						      System Manager's Manual							   IPPL(8)

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)