NAME

       ipwatchd.conf - Configuration file of IPwatchD daemon

SYNOPSIS

       /etc/ipwatchd.conf

DESCRIPTION

       IPwatchD  daemon reads configuration from file specified with -c on command line. The file
       contains keyword-argument pairs, one per line. Lines beginning with # sign and empty lines
       are ignored.

       Possible keywords and their meanings are as follows:

       iface_configuration
              Specifies  configuration  mode  for  network interfaces. In automatic configuration
              mode IPwatchD  detects  all  network  interfaces  automatically  and  sets  passive
              protection  mode for them. In manual mode it is up to administrator to specify list
              of interfaces and protection  modes.  Accepted  values  are  automatic  or  manual.
              Default is automatic.

       iface  Specifies  network  interface  and  its  protection mode. Value is accepted only in
              manual configuration mode. In active protection mode IPwatchD  protects  your  host
              before  IP  takeover by answering Gratuitous ARP requests received from conflicting
              system. In passive protection mode it just records information  about  IP  conflict
              through  standard  syslog  interface. Specified interface must exist and protection
              mode must be passive or active.

       defend_interval
              Specifies minimum interval between defensive ARPs in  seconds.  Accepted  value  is
              number from 0 to 600. Default value is 0.

       user_script
              Specifies  absolute path to user-defined script called by IPwatchD when IP conflict
              occurs. When there is no script specified IPwatchD just generates syslog event  for
              every IP conflict. Specified file must exist. There is no default value.

       syslog_facility
              Specifies  facility  for logging. Accepted values are auth, authpriv, cron, daemon,
              kern, lpr, mail, news, syslog, user, uucp, local0, local1, local2, local3,  local4,
              local5, local6 and local7. Default value is daemon.

EXAMPLES

       Automatic configuration mode:

              iface_configuration automatic
              defend_interval 10
              user_script /usr/sbin/ipwatchd-script
              syslog_facility daemon

       Manual configuration mode:

              iface_configuration manual
              iface eth0 active
              iface eth0:0 passive
              defend_interval 10
              user_script /usr/sbin/ipwatchd-script
              syslog_facility daemon

AUTHOR

       This manual page was written by Jaroslav Imrich <jariq@jariq.sk>

SEE ALSO

       ipwatchd(8), ipwatchd-script(1)

                                                                                 IPWATCHD.CONF(5)