netmgt_request_agent_id manual page
Table of Contents

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)


Table of Contents