addressAssigned

The addressAssigned routine can be used for accounting purposes or to add an external means of name and address association.

The hostname and domain arguments are selected based upon the A-record proxy update policy and the append domain policy (configured in the db_file database through the keywords proxyARec and appendDomain, respectively), as well as the defined and suggested hostname and domain options for the client.

The addressAssigned routine is called after the database has associated the address with the client and just before sending the BOOTP response or DHCP ACK to the client. If a DNS update is configured, the addressAssigned routine is called after the update has occurred or, at least, has been queued.

Parameters offered to the routine are read-only. The routine has no return code to prevent address and client binding. The structure of the addressAssigned routine follows:

void addressAssigned ( caddr_t hObjectInstance,
                       const struct dhcpclientid *cid,
                       const struct in_addr *addr,
                       const char *hostname,
                       const char *domain,
                       const struct dhcpmessage *outMessage,
                       size_t messageSize                     ) ;
Item Description
hObjectInstance Is the same configuration instance handle created when this object was initialized.
cid Is the client identifier of the client.
addr Is the address selected for the client.
hostname Is the host name which is (or should have been) associated with the client.
domain Is the domain in which the host name for the client was (or should have been) updated.
outMessage Is the outgoing message that is ready to be sent to the client.
messageSize Is the length, in bytes, of the outgoing message that is ready to be sent to the client.