netmgt_request_set manual page
Table of Contents
NAME
netmgt_request_set- send a set request to an agent
SYNOPSIS
bool_t
netmgt_request_set(agent_host, agent_prog, agent_vers, rendez_host, rendez_prog, rendez_vers, timeout, flags)
- char
- *agent_host;
- u_long
- agent_prog;
- u_long
- agent_vers;
- char
- *rendez_host;
- u_long
- rendez_prog;
- u_long
- rendez_vers; struct timeval timeout;
- u_int
- flags;
DESCRIPTION
netmgt_request_set sends a request to an agent to set the values of one or more group or table attributes. The caller must have previously called netmgt_set_instance(3n) to define the system containing the attributes. In addition, the caller must have previously called netmgt_set_value(3n) to specify the values to set the attributes. If any agentspecific options are to be set, the caller must have previously called netmgt_set_argument(3n).
The request is sent to the agent process on agent_host with RPC program number agent_prog and RPC version number agent_vers. The agent will report the results of the set operation to the rendezvous process on rendez_host with RPC program number rendez_prog and RPC version number rendez_vers.
INPUT ARGUMENTS
agent_host
host where the agent runs.
agent_prog
agent's RPC program number.
agent_vers
agent's RPC version number.
rendez_host
host where the rendezvous runs.
rendez_prog
rendezvous' RPC program number.
rendez_vers
rendezvous' RPC version number.
timeout
maximum time to wait for confirmation from the agent before the call fails.
flags
request option flags. One flag is currently defined:
- NETMGT_RESTART
- Restart the request if the agent abnormally terminates and is restarted. Otherwise, when the agent restarts, this request is forgotten. This flag is advisory; request restart is not guaranteed. The restart is not attempted until the agent parent is started (asked to start another request, or asked what requests it is working on), when all requests marked for restart will be restarted, if possible.
RETURN VALUE
TRUE if the agent verified it will attempt to perform the request, otherwise FALSE. The caller must run as a callback RPC server to receive a report indicating whether the agent succeeded in performing the set request.
DIAGNOSTICS
If FALSE is returned, global variable netmgt_error indicates the error. The caller can get the reason for the error with netmgt_fetch_error(3n).
SEE ALSO
- netmgt_fetch_error(3n),
- netmgt_set_value(3n), netmgt_set_argument(3n), netmgt_set_instance(3n)
Table of Contents