Compaq AAR04BCTE manual Esnmpinit

eSNMP API Routines esnmp_init

esnmp_init

Initializes the Extensible SNMP (eSNMP) subagent and initiates communication with the master agent.

Format

int esnmp_init (int *socket,

char *subagent_identifier ) ;

Arguments

socket

The address of the integer that receives the socket descriptor used by eSNMP.

subagent_identifier

The address of a null-terminated string that uniquely identifies this subagent (usually a program name).

Description

Call this routine during program initialization or to restart the eSNMP protocol. If you are restarting, the esnmp_init routine clears all registrations so each subtree must be registered again.

You should attempt to create a unique subagent identifier, perhaps using the program name argv[0] and additional descriptive text. The master agent does not open communications with a subagent whose subagent identifier is already in use.

This routine does not block waiting for a response from the master agent. After calling the esnmp_init routine, call the esnmp_register routine for each subtree that is to be handled by the subagent.

Return Values

ESNMP_LIB_NO_	Could not initialize or communicate with the
CONNECTION	master agent. Try again after a delay.
ESNMP_LIB_OK	The esnmp_init routine has completed
	successfully.
ESNMP_LIB_NOTOK	Could not allocate memory for the subagent.

Example

#include <esnmp_h> int socket;

status = esnmp_init(&socket, "gated");

5–2eSNMP API Routines