bootpd.1m (2010 09)

b
bootpd(1M) bootpd(1M)
callback-style=
OLD|NEW
Callbacks are a powerful feature that allow the system administrator to customize the opera-
tion of the server. A user-supplied executable file (typically a shell script) is executed each
time one of the main server actions is performed (example: granting a lease). An argument
list is passed in with information about the individual client and the lease. The
callback-style=
tag specifies whether the old (and confusing) argument list should be
used with the
call-on-xxx feature described below. The new (and recommended) argu-
ment list is much simpler to use, and is identical for all of the
call-on-xxx functions. The
new style simply inserts a value of "00" for fields that are not sensible for a particular call-
back. The new argument list is:
filename
: client-id htype haddr ipaddr subnet-mask lease-expiration hostname gateway
The old argument list is described for each of the individual callbacks below.
call-on-unrequited=
filename
This tag specifies an executable file filename that will be called when the server receives a
request to which it cannot send a response. Certain arguments will be passed in; the call exe-
cuted will be:
filename
: client-id htype haddr [gateway]
where client-id is the client ID in hex if present, or 00 if there is no client ID. htype is the
hardware type as per the ARP section of the "Assigned Numbers" RFC. haddr is the
hardware address in hex. gateway is the IP address of the
bootp relay agent. If the packet
was not relayed, then this field is absent.
The currently supported tags for
dhcp_pool_group
, dhcp_device_group, and
dhcp_default_client_settings
are:
allow-subnet-selection
This boolean tag specifies that this group supports the subnet selection option. However, if
this tag is not specified in the dhcp_server_settings
, then this option will also be
ignored. This tag is inappropriate for
dhcp_default_client_settings.
call-on-assignment=
filename
This tag specifies the fully qualified filename to be called when an IP address has been
assigned to a new client. Some arguments will be passed in, the call will be made as follows:
filename
: client-id htype haddr ipaddr subnet-mask lease-expiration [hostname]
where client-id is the client ID in hex if present, or 00 if there is no client ID. htype is the
hardware type as per the ARP section of the "Assigned Numbers" RFC. haddr is the
hardware address in hex. ipaddr is the IP address that was assigned to the client. subnet-
mask is the subnet mask of the client represented as an IP address. lease-expiration is the
bootpd internal representation of when the lease will expire (based on a C call to time()), a
value of ffffffff represents an infinite lease. If there is a hostname associated with this
address, then it is the final argument.
call-on-decline=filename
This tag specifies the fully qualified filename to be called when an IP address has been
declined by a new client. Some arguments will be passed in, the call will be made as follows:
filename
: client-id htype haddr ipaddr subnet-mask
where client-id is the client ID in hex if present, or 00 if there is no client ID. htype is the
hardware type as per the ARP section of the "Assigned Numbers" RFC. haddr is the
hardware address in hex. ipaddr is the IP address that was declined by the client. subnet-
mask is the subnet mask of the client represented as an IP address.
call-on-discard=filename
This tag specifies the fully qualified filename to be called when an IP address has been dis-
carded due to a conflict. Some arguments will be passed in, the call will be made as follows:
filename
: client-id htype haddr ipaddr subnet-mask
where client-id is the client ID in hex if present, or 00 if there is no client ID. htype is the
hardware type as per the ARP section of the "Assigned Numbers" RFC. haddr is the
hardware address in hex. ipaddr is the IP address that was declined by the client. subnet-
mask is the subnet mask of the client represented as an IP address.
8 Hewlett-Packard Company − 8 − HP-UX 11i Version 3: September 2010