eSNMP API Routines esnmp_register
esnmp_register
Requests local registration of a single MIB subtree. This indicates to the master agent that the subagent instantiates MIB variables within the registered MIB subtree.
Format
int esnmp_register ( subtree *subtree, int timeout,
int priority ) ;
Arguments
subtree
A pointer to a subtree structure corresponding to the subtree to be handled. The code emitted by the MIB compiler files (subtree_TBL.C and subtree_TBL.H) externally declare and initialize the subtree structures. Refer to Chapter 3 for more information about these files.
Note
All memory pointed to by the subtree fields must have permanent storage since it is referenced by libesnmp for the duration of the program. You should use the data declarations emitted by the MIBCOMP program.
timeout
The number of seconds the master agent should wait for responses when requesting data in this subtree. This value must be between 0 (zero) and
300.If the value is 0, the default timeout is 3 seconds. Compaq recommends that you use the default. For information about modifying the default subagent timeout value, refer to Section 6.2.
priority
The registration priority. The priority argument allows you to coordinate cooperating subagents to handle different configurations. The range is 1 to 255.
The entry with the largest number has the highest priority. The subagent that registers a subtree with the highest priority over a range of object identifiers gets all requests for that range of OIDs.
Subtrees registered with the same priority are considered duplicate, and the registration is rejected by the master agent.
Description
Call the initialization routine esnmp_init prior to calling the esnmp_register. Call the esnmp_register function for each subtree structure corresponding to each subtree to be handled. At any time, subtrees can be unregistered by calling esnmp_unregister and then be reregistered by calling the esnmp_register.
When restarting the eSNMP protocol by calling esnmp_init, all registrations are cleared. All subtrees must be reregistered.
eSNMP API Routines