beautypg.com

Esnmp_init – Compaq AAR04BCTE User Manual

Page 60

background image

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_

CONNECTION

Could not initialize or communicate with the
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
int socket;
status = esnmp_init(&socket, "gated");

5–2 eSNMP API Routines