the-binary - Command 2 - Handler specification

Purpose:

This command is used to inform the agent who its handler is.

Format:

A handler sends the following command to specify the ip of the handler  (xxx = don't care):
 
2 xxx xxx 2
multi
ip list...
padding for a minimum packet size
of 201 bytes including the IP header
NOTE: the shaded bytes must be encoded prior to transmission to the agent.  Any other value for multi will behave as if the value 1 had been passed.

multi: indicates how the agent should communicate with the handler

0 - The agent sends output to the handler only.  The ip of the intended recipient (usually the handler?) must be specified as the first ip in the ip list.
1 - The agent sends output to the handler and 9 random IP addresses. The ip of the intended recipient (usually the handler?) must be specified as the first ip in the ip list.  This ip will be inserted randomly into a list of 10 randomly generated ip addresses. Whenever the agent is required to send output it sends identical output to each of the 10 addresses.  Thus the handler address is not learned by observing traffic, but it can be narrowed down to one of 10.
2 - The agent sends output to the 10 IP addresses named in IP list.  The handler ip may be among the 10 ip addresses specified in the ip list.  Whenever the agent is required to send output it sends identical output to each of the 10 addresses, in the order in which they appear in the list.  Thus the handler address is not learned by observing traffic, but it can be narrowed down to one of 10.
ip list: A single IP if multi is 0 or 1, or a list of 10 ip addresses if multi is 2.  All IPs in network byte order.  See descriptions above for usage of this list.

Action:

The agent sends no response to this message.  It simply configures its transmission list according to the multi flag passed in the message.