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)