instance: process individual MIB instances easily.
[leaf_handlers: process individual leaf objects]


Functions
netsnmp_mib_handler *	netsnmp_get_instance_handler (void)
	Creates an instance helper handler, calls netsnmp_create_handler, which then could be registered, using netsnmp_register_handler().
int	netsnmp_register_instance (netsnmp_handler_registration *reginfo)
	This function registers an instance helper handler, which is a way of registering an exact OID such that GENEXT requests are handled entirely by the helper.
int	netsnmp_register_read_only_instance (netsnmp_handler_registration *reginfo)
	This function injects a "read only" handler into the handler chain prior to serializing/registering the handler.
int	netsnmp_register_read_only_ulong_instance (const char name, oid reg_oid, size_t reg_oid_len, u_long it, Netsnmp_Node_Handler subhandler)
int	netsnmp_register_ulong_instance (const char name, oid reg_oid, size_t reg_oid_len, u_long it, Netsnmp_Node_Handler subhandler)
int	netsnmp_register_read_only_counter32_instance (const char name, oid reg_oid, size_t reg_oid_len, u_long it, Netsnmp_Node_Handler subhandler)
int	netsnmp_register_read_only_long_instance (const char name, oid reg_oid, size_t reg_oid_len, long it, Netsnmp_Node_Handler subhandler)
int	netsnmp_register_long_instance (const char name, oid reg_oid, size_t reg_oid_len, long it, Netsnmp_Node_Handler subhandler)
int	netsnmp_register_read_only_int_instance (const char name, oid reg_oid, size_t reg_oid_len, int it, Netsnmp_Node_Handler subhandler)
int	register_read_only_int_instance (const char name, oid reg_oid, size_t reg_oid_len, int it, Netsnmp_Node_Handler subhandler)
int	netsnmp_register_read_only_ulong_instance_context (const char name, oid reg_oid, size_t reg_oid_len, u_long it, Netsnmp_Node_Handler subhandler, const char *contextName)
int	netsnmp_register_ulong_instance_context (const char name, oid reg_oid, size_t reg_oid_len, u_long it, Netsnmp_Node_Handler subhandler, const char *contextName)
int	netsnmp_register_read_only_counter32_instance_context (const char name, oid reg_oid, size_t reg_oid_len, u_long it, Netsnmp_Node_Handler subhandler, const char *contextName)
int	netsnmp_register_read_only_long_instance_context (const char name, oid reg_oid, size_t reg_oid_len, long it, Netsnmp_Node_Handler subhandler, const char *contextName)
int	netsnmp_register_long_instance_context (const char name, oid reg_oid, size_t reg_oid_len, long it, Netsnmp_Node_Handler subhandler, const char *contextName)
int	netsnmp_register_int_instance_context (const char name, oid reg_oid, size_t reg_oid_len, int it, Netsnmp_Node_Handler subhandler, const char *contextName)
int	netsnmp_register_read_only_int_instance_context (const char name, oid reg_oid, size_t reg_oid_len, int it, Netsnmp_Node_Handler subhandler, const char *contextName)
int	register_read_only_int_instance_context (const char name, oid reg_oid, size_t reg_oid_len, int it, Netsnmp_Node_Handler subhandler, const char *contextName)
int	netsnmp_register_num_file_instance (const char name, oid reg_oid, size_t reg_oid_len, char file_name, int asn_type, int mode, Netsnmp_Node_Handler subhandler, const char *contextName)
int	netsnmp_register_int_instance (const char name, oid reg_oid, size_t reg_oid_len, int it, Netsnmp_Node_Handler subhandler)
	This function registers an int helper handler to a specified OID.
int	netsnmp_instance_ulong_handler (netsnmp_mib_handler handler, netsnmp_handler_registration reginfo, netsnmp_agent_request_info reqinfo, netsnmp_request_info requests)
int	netsnmp_instance_counter32_handler (netsnmp_mib_handler handler, netsnmp_handler_registration reginfo, netsnmp_agent_request_info reqinfo, netsnmp_request_info requests)
int	netsnmp_instance_long_handler (netsnmp_mib_handler handler, netsnmp_handler_registration reginfo, netsnmp_agent_request_info reqinfo, netsnmp_request_info requests)
int	netsnmp_instance_int_handler (netsnmp_mib_handler handler, netsnmp_handler_registration reginfo, netsnmp_agent_request_info reqinfo, netsnmp_request_info requests)
int	netsnmp_instance_num_file_handler (netsnmp_mib_handler handler, netsnmp_handler_registration reginfo, netsnmp_agent_request_info reqinfo, netsnmp_request_info requests)
int	netsnmp_instance_helper_handler (netsnmp_mib_handler handler, netsnmp_handler_registration reginfo, netsnmp_agent_request_info reqinfo, netsnmp_request_info requests)

Function Documentation

netsnmp_mib_handler* netsnmp_get_instance_handler

(

void

)

Creates an instance helper handler, calls netsnmp_create_handler, which then could be registered, using netsnmp_register_handler().

Parameters:

void

Returns:: Returns a pointer to a netsnmp_mib_handler struct which contains the handler's name and the access method

Definition at line 49 of file instance.c.

References netsnmp_create_handler().

Referenced by netsnmp_register_instance(), netsnmp_register_read_only_instance(), netsnmp_register_read_only_scalar(), and netsnmp_register_scalar().

int netsnmp_instance_num_file_handler	(	netsnmp_mib_handler *	handler,
		netsnmp_handler_registration *	reginfo,
		netsnmp_agent_request_info *	reqinfo,
		netsnmp_request_info *	requests
	)

fall through

Definition at line 708 of file instance.c.

References memdup(), netsnmp_agent_request_info_s::mode, netsnmp_mib_handler_s::myvoid, netsnmp_call_next_handler(), netsnmp_create_data_list(), netsnmp_handler_registration, netsnmp_mib_handler, netsnmp_request_add_list_data(), netsnmp_request_get_list_data(), netsnmp_set_request_error(), netsnmp_request_info_s::requestvb, snmp_set_var_typed_value(), variable_list::type, and variable_list::val.

int netsnmp_register_instance

(

netsnmp_handler_registration *

reginfo

)

This function registers an instance helper handler, which is a way of registering an exact OID such that GENEXT requests are handled entirely by the helper.

First need to inject it into the calling chain of the handler defined by the netsnmp_handler_registration struct, reginfo. The new handler is injected at the top of the list and will be the new handler to be called first. This function also injects a serialize handler before actually calling netsnmp_register_handle, registering reginfo.

Parameters:

reginfo

a handler registration structure which could get created using netsnmp_create_handler_registration. Used to register an instance helper handler.

Returns:: MIB_REGISTERED_OK is returned if the registration was a success. Failures are MIB_REGISTRATION_FAILED and MIB_DUPLICATE_REGISTRATION.

Examples:: delayed_instance.c.

Definition at line 74 of file instance.c.

References netsnmp_get_instance_handler(), netsnmp_handler_registration, netsnmp_inject_handler(), and netsnmp_register_serialize().

Referenced by netsnmp_register_int_instance().

int netsnmp_register_int_instance	(	const char *	name,
		oid *	reg_oid,
		size_t	reg_oid_len,
		int *	it,
		Netsnmp_Node_Handler *	subhandler
	)

This function registers an int helper handler to a specified OID.

Parameters:

	name	the name used for registration pruposes.
	reg_oid	the OID where you want to register your integer at
	reg_oid_len	the length of the OID
	it	the integer value to be registered during initialization
	subhandler	a handler to do whatever you want to do, otherwise use NULL to use the default int handler.

Returns:: MIB_REGISTERED_OK is returned if the registration was a success. Failures are MIB_REGISTRATION_FAILED and MIB_DUPLICATE_REGISTRATION.

Examples:: scalar_int.c.

Definition at line 427 of file instance.c.

References netsnmp_handler_registration, and netsnmp_register_instance().

int netsnmp_register_read_only_instance

(

netsnmp_handler_registration *

reginfo

)

This function injects a "read only" handler into the handler chain prior to serializing/registering the handler.

The only purpose of this "read only" handler is to return an appropriate error for any requests passed to it in a SET mode. Inserting it into your handler chain will ensure you're never asked to perform a SET request so you can ignore those error conditions.

Parameters:

reginfo

a handler registration structure which could get created using netsnmp_create_handler_registration. Used to register a read only instance helper handler.

Returns:: MIB_REGISTERED_OK is returned if the registration was a success. Failures are MIB_REGISTRATION_FAILED and MIB_DUPLICATE_REGISTRATION.

Definition at line 99 of file instance.c.

References netsnmp_get_instance_handler(), netsnmp_get_read_only_handler(), netsnmp_handler_registration, netsnmp_inject_handler(), and netsnmp_register_serialize().

Generated on Fri Dec 30 13:47:59 2005 for net-snmp by

1.3.9.1

·	Projects
·	Release Schedule
·	Helping Out
·	SVN
·	Release Policy
·	API

instance: process individual MIB instances easily. [leaf_handlers: process individual leaf objects]

Functions

Function Documentation

instance: process individual MIB instances easily.
[leaf_handlers: process individual leaf objects]