IPWATCHD(8) IPWATCHD(8)
NAME
ipwatchd - runs a program when the primary IP address changes
SYNOPSIS
ipwatchd [-d] [-oname=value] [change_program]
DESCRIPTION
The ipwatchd daemon watches MacOS X's dynamic System Configuration
state for interface address changes, and runs the given program with
the new IP address.
This program is intended to be run and managed by the launchd(8) dae-
mon.
The ipwatch daemon watches the dynamic store string at State:/Net-
work/Global/IPv4[PrimaryService] to determine what the current "pri-
mary" interface number is (For example, "0", which is usually en0).
From this it watches the primary service's IP address(es) at
State:/Network/Service/$PrimaryService/IPv4[Addresses] and uses the
first IP address as the primary address of the host.
When the primary IP address change is detected, ipwatchd then waits for
a period of quiet (the "change delay") before running the change_pro-
gram with the new IP address as its first and only argument.
OPTIONS
-d This option enables debug (verbose) mode. It is equivalent to
-oDebug=true
-oname=value
Sets a configuration option by name as described in the section
below.
change_program
This argument is the same as -oChangeProgram=change_program
Configuration Options
The -o option can be used to set named options. Unknown options are
ignored. Known options are:
Debug (boolean)
Enables debug messages sent to standard error.
ChangeProgram (string)
The program to execute when the IP address changes. The exe-
cuted program is given the new IP address as its first argument.
This defaults to /opt/quest/sbin/dnsupdate
GlobalIPv4Key (string)
The name of the IPv4 key in the dynamic store. Defaults to
"State:/Network/Global/IPv4"
PrimaryIPv4KeyPattern (string)
The pattern to use when detecting interfaces. The "%" character
in this string is replaced with the primary service ID.
Defaults to "State:/Network/Service/%/IPv4".
ChangeDelay (float)
The delay in seconds to wait for quiescence after detecting an
IP address and before running the ChangeProgram. Values of zero
or lower are interpreted as meaning immediate application.
Defaults to 30 seconds.
FILES
/Library/LaunchDaemons/com.quest.rc.ipwatchd.plist
SEE ALSO
dnsupdate(8), launchd(8), http://rc.vintela.com/topics/ddns/
AUTHORS
Quest Software, Inc.
IPWATCHD(8)
