NAME

LIBRARY

SYNOPSIS

DESCRIPTION

extern struct snmp_node *tree; 
extern u_int  tree_size;

typedef int (*snmp_op_t)(struct snmp_context *, struct snmp_value *, 
    u_int, u_int, enum snmp_op); 
 
struct snmp_node { 
	struct asn_oid oid; 
	const char	*name;		/* name of the leaf */ 
	enum snmp_node_type type;	/* type of this node */ 
	enum snmp_syntax syntax; 
	snmp_op_t	op; 
	u_int		flags; 
	u_int32_t	index;		/* index data */ 
	void		*data;		/* application data */ 
	void		*tree_data;	/* application data */ 
};

oid

Base OID of the scalar or table column.

name

Name of this variable.

type

Type of this variable. One of:

enum snmp_node_type { 
	SNMP_NODE_LEAF = 1, 
	SNMP_NODE_COLUMN 
};
    

syntax

The SNMP syntax of this variable.

op

The user supplied handler for this variable. The handler is called with the following arguments:

ctx

A pointer to the context (see below). NULL.

val

The value to be set or retrieved. For GETNEXT and GETBULK operations the oid in this value is the current OID. The function (called in this case only for table rows) must find the lexically next existing OID within the same column and set the oid and value subfields accordingly. If the table column is exhausted the function must return SNMP_ERR_NOSUCHNAME. For all other operations the oid in val is the oid to fetch or set.

len

The length of the base oid without index.

idx

For table columns this is the index expression from the node (see below).

op

This is the operation to execute, one of:

enum snmp_op { 
	SNMP_OP_GET 	= 1, 
	SNMP_OP_GETNEXT, 
	SNMP_OP_SET, 
	SNMP_OP_COMMIT, 
	SNMP_OP_ROLLBACK, 
};
        

The user handler must return an appropriate SNMP v2 error code. If the original PDU was a version 1 PDU, the error code is mapped automatically.

flags

Currently only the flag SNMP_NODE_CANSET is defined and set for nodes, that can be written or created.

index

This word describes the index for table columns. Each part of the index takes 4 bits starting at bit 4. Bits 0 to 3 hold the number of index parts. This arrangement allows for tables with up to seven indexes. Each bit group contains the syntax for the index part. There are a number of macros to help in parsing this field:

#define SNMP_INDEXES_MAX	7 
#define SNMP_INDEX_SHIFT	4 
#define SNMP_INDEX_MASK	0xf 
#define SNMP_INDEX_COUNT(V)	((V) & SNMP_INDEX_MASK) 
#define SNMP_INDEX(V,I) \ 
	(((V) >> (((I) + 1) * SNMP_INDEX_SHIFT)) & \ 
	SNMP_INDEX_MASK)
    

data

This field may contain arbitrary data and is not used by the library.

enum { 
	SNMP_TRACE_GET, 
	SNMP_TRACE_GETNEXT, 
	SNMP_TRACE_SET, 
	SNMP_TRACE_DEPEND, 
	SNMP_TRACE_FIND, 
};

struct snmp_context { 
	u_int	var_index; 
	struct snmp_scratch *scratch; 
	struct snmp_dependency *dep; 
	void	*data;		/* user data */ 
	enum snmp_ret code;	/* return code */ 
}; 
 
struct snmp_scratch { 
	void		*ptr1; 
	void		*ptr2; 
	uint32_t	int1; 
	uint32_t	int2; 
};

va_index

For the node operation callback this is the index of the variable binding that should be returned if an error occurs. Set by the library. In all other functions this is undefined.

scratch

For the node operation callback this is a pointer to a per variable binding scratch area that can be used to implement the commit and rollback. Set by the library.

dep

In the dependency callback function (see below) this is a pointer to the current dependency. Set by the library.

data

This is the data argument from the call to the library and is not used by the library.

SNMP_RET_OK

Operation successful, response PDU may be sent.

SNMP_RET_IGN

Operation failed, no response PDU constructed. Request is ignored.

SNMP_RET_ERR

Error in operation. The error code and index have been set in pdu. No response PDU has been constructed. The caller may construct an error response PDU via snmp_make_errresp().

1. For each binding search the corresponding nodes, check that the variable is writeable and the syntax is ok. The writeable check can be done only for scalars. For columns it must be done in the node's operation callback function.
2. For each binding call the node's operation callback with function SNMP_OP_SET. The callback may create dependencies or finalizers (see below). For simple scalars the scratch area may be enough to handle commit and rollback, for interdependent table columns dependencies may be necessary.
3. If the previous step fails at any point, the node's operation callback functions are called for all bindings for which SNMP_OP_SET was executed with SNMP_OP_ROLLBACK, in the opposite order. This allows all variables to undo the effect of the SET operation. After this all the dependencies are freed and the finalizers are executed with a fail flag of 1. Then the function returns to the caller with an appropriate error indication.
4. If the SET step was successful for all bindings, the dependency callbacks are executed in the order in which the dependencies were created with an operation of SNMP_DEPOP_COMMIT. If any of the dependencies fails, all the committed dependencies are called again in the opposite order with SNMP_DEPOP_ROLLBACK. Than for all bindings from the last to the first the node's operation callback is called with SNMP_OP_ROLLBACK to undo the effect of SNMP_OP_SET. At the end the dependencies are freed and the finalizers are called with a fail flag of 1 and the function returns to the caller with an appropriate error indication.
5. If the dependency commits were successful, for each binding the node's operation callback is called with SNMP_OP_COMMIT. Any error returned from the callbacks is ignored (an error message is generated via snmp_error().)
6. Now the dependencies are freed and the finalizers are called with a fail flag of 0. For each dependency just before freeing it its callback is called with SNMP_DEPOP_FINISH. Then the function returns SNMP_ERR_OK.

DIAGNOSTICS

SEE ALSO

STANDARDS

AUTHORS