IPPL(8)							  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  con-
       nections, 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 sig-
       nals 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
	/usr/local/etc/ippl.conf - configuration file
	/usr/share/doc/ippl/* - files worth reading if you  still
       have a question
	/var/run/ippl.pid  -  file containing the PID of the run-
       ning 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  sun-
       site.unc.edu in /pub/Linux/system/network/daemons.


MAILING LISTS
       Two  mailing  lists have been setup. Send an email to lis-
       tar@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


