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;
        u_long agent_prog;
        u_long agent_vers;
        struct  timeval timeout;

DESCRIPTION

netmgt_request_agent_ID gets information identifying an agent.

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)