IPWATCHD.CONF(5)

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)