NAME
netmgt_request_agent_ID - request identification from an agent
SYNOPSIS
Netmgt_ident *
netmgt_request_agent_ID(agent_host, agent_prog, agent_vers, timeout) char *agent_host;
INPUT ARGUMENTS
agent_name
system where the agent is installed.
agent_prog
agent's RPC program number.
agent_vers
agent's RPC version number.
timeout
maximum time to wait for a response from the agent before failing with an error.
RETURN VALUE
Pointer to a structure (as defined in netmgt_agent.h) containing the following fields:
char name[NETMGT_NAMESIZ]
agent name as it appears in the rpc database.
u_int serial
agent serial number. This serial number changes with the agent schema; they should match.
char arch[NETMGT_NAMESIZ]
host ID (not architecture) of the machine where the agent is installed.
If an error is detected, the function returns NULL.
DIAGNOSTICS
If NULL is returned, global variable netmgt_error indicates the error. The caller can get the reason for the error with netmgt_fetch_error(3n).
FILES
netmgt_agent.h
SEE ALSO
hostid(1B), netmgt_fetch_error(3n)