net-snmp 5.7
Functions
table_dataset
table_data

Helps you implement a table with automatted storage. More...

Functions

void netsnmp_init_table_dataset (void)
NETSNMP_INLINE
netsnmp_table_data_set_storage
netsnmp_table_dataset_delete_data (netsnmp_table_data_set_storage *data)
 deletes a single dataset table data.
NETSNMP_INLINE void netsnmp_table_dataset_delete_all_data (netsnmp_table_data_set_storage *data)
 deletes all the data from this node and beyond in the linked list
NETSNMP_INLINE void netsnmp_table_dataset_delete_row (netsnmp_table_row *row)
 deletes all the data from this node and beyond in the linked list
NETSNMP_INLINE void netsnmp_table_dataset_add_row (netsnmp_table_data_set *table, netsnmp_table_row *row)
 adds a new row to a dataset table
NETSNMP_INLINE void netsnmp_table_dataset_replace_row (netsnmp_table_data_set *table, netsnmp_table_row *origrow, netsnmp_table_row *newrow)
 adds a new row to a dataset table
NETSNMP_INLINE void netsnmp_table_dataset_remove_row (netsnmp_table_data_set *table, netsnmp_table_row *row)
 removes a row from the table, but doesn't delete/free the column values
NETSNMP_INLINE void netsnmp_table_dataset_remove_and_delete_row (netsnmp_table_data_set *table, netsnmp_table_row *row)
 removes a row from the table and then deletes it (and all its data)
netsnmp_table_data_setnetsnmp_create_table_data_set (const char *table_name)
 Create a netsnmp_table_data_set structure given a table_data definition.
void netsnmp_delete_table_data_set (netsnmp_table_data_set *table_set)
netsnmp_table_rownetsnmp_table_data_set_clone_row (netsnmp_table_row *row)
 clones a dataset row, including all data.
netsnmp_table_rownetsnmp_table_data_set_create_row_from_defaults (netsnmp_table_data_set_storage *defrow)
 creates a new row from an existing defined default set
int netsnmp_table_set_add_default_row (netsnmp_table_data_set *table_set, unsigned int column, int type, int writable, void *default_value, size_t default_value_len)
 adds a new default row to a table_set.
void netsnmp_table_set_multi_add_default_row (netsnmp_table_data_set *tset,...)
 adds multiple data column definitions to each row.
netsnmp_mib_handlernetsnmp_get_table_data_set_handler (netsnmp_table_data_set *data_set)
 Given a netsnmp_table_data_set definition, create a handler for it.
int netsnmp_register_table_data_set (netsnmp_handler_registration *reginfo, netsnmp_table_data_set *data_set, netsnmp_table_registration_info *table_info)
 register a given data_set at a given oid (specified in the netsnmp_handler_registration pointer).
newrow_stashnetsnmp_table_data_set_create_newrowstash (netsnmp_table_data_set *datatable, netsnmp_table_request_info *table_info)
int netsnmp_table_data_set_helper_handler (netsnmp_mib_handler *handler, netsnmp_handler_registration *reginfo, netsnmp_agent_request_info *reqinfo, netsnmp_request_info *requests)
NETSNMP_INLINE
netsnmp_table_data_set
netsnmp_extract_table_data_set (netsnmp_request_info *request)
 extracts a netsnmp_table_data_set pointer from a given request
netsnmp_table_data_set_storagenetsnmp_extract_table_data_set_column (netsnmp_request_info *request, unsigned int column)
 extracts a netsnmp_table_data_set pointer from a given request
void netsnmp_register_auto_data_table (netsnmp_table_data_set *table_set, char *registration_name)
 registers a table_dataset so that the "add_row" snmpd.conf token can be used to add data to this table.
void netsnmp_unregister_auto_data_table (netsnmp_table_data_set *table_set, char *registration_name)
 Undo the effect of netsnmp_register_auto_data_table().
void netsnmp_config_parse_table_set (const char *token, char *line)
void netsnmp_config_parse_add_row (const char *token, char *line)
netsnmp_oid_stash_node ** netsnmp_table_dataset_get_or_create_stash (netsnmp_agent_request_info *reqinfo, netsnmp_table_data_set *datatable, netsnmp_table_request_info *table_info)
netsnmp_table_rownetsnmp_table_dataset_get_newrow (netsnmp_request_info *request, netsnmp_agent_request_info *reqinfo, int rootoid_len, netsnmp_table_data_set *datatable, netsnmp_table_request_info *table_info)
netsnmp_table_rownetsnmp_table_data_set_get_first_row (netsnmp_table_data_set *table)
 returns the first row in the table
netsnmp_table_rownetsnmp_table_data_set_get_next_row (netsnmp_table_data_set *table, netsnmp_table_row *row)
 returns the next row in the table
int netsnmp_table_set_num_rows (netsnmp_table_data_set *table)
netsnmp_table_data_set_storagenetsnmp_table_data_set_find_column (netsnmp_table_data_set_storage *start, unsigned int column)
 Finds a column within a given storage set, given the pointer to the start of the storage set list.
int netsnmp_mark_row_column_writable (netsnmp_table_row *row, int column, int writable)
 marks a given column in a row as writable or not.
int netsnmp_set_row_column (netsnmp_table_row *row, unsigned int column, int type, const void *value, size_t value_len)
 Sets a given column in a row with data given a type, value, and length.
void netsnmp_table_dataset_add_index (netsnmp_table_data_set *table, u_char type)
 adds an index to the table.
void netsnmp_table_set_add_indexes (netsnmp_table_data_set *tset,...)
 adds multiple indexes to a table_dataset helper object.

Detailed Description

Helps you implement a table with automatted storage.

This handler helps you implement a table where all the data is expected to be stored within the agent itself and not in some external storage location. It handles all MIB requests including GETs, GETNEXTs and SETs. It's possible to simply create a table without actually ever defining a handler to be called when SNMP requests come in. To use the data, you can either attach a sub-handler that merely uses/manipulates the data further when requests come in, or you can loop through it externally when it's actually needed. This handler is most useful in cases where a table is holding configuration data for something which gets triggered via another event.

NOTE NOTE NOTE: This helper isn't complete and is likely to change somewhat over time. Specifically, the way it stores data internally may change drastically.


Function Documentation

netsnmp_table_data_set* netsnmp_create_table_data_set ( const char *  table_name)

Create a netsnmp_table_data_set structure given a table_data definition.

Examples:
data_set.c.

Definition at line 197 of file table_dataset.c.

NETSNMP_INLINE netsnmp_table_data_set* netsnmp_extract_table_data_set ( netsnmp_request_info request)

extracts a netsnmp_table_data_set pointer from a given request

Definition at line 877 of file table_dataset.c.

netsnmp_table_data_set_storage* netsnmp_extract_table_data_set_column ( netsnmp_request_info request,
unsigned int  column 
)

extracts a netsnmp_table_data_set pointer from a given request

Definition at line 888 of file table_dataset.c.

netsnmp_mib_handler* netsnmp_get_table_data_set_handler ( netsnmp_table_data_set data_set)

Given a netsnmp_table_data_set definition, create a handler for it.

Definition at line 399 of file table_dataset.c.

int netsnmp_mark_row_column_writable ( netsnmp_table_row row,
int  column,
int  writable 
)

marks a given column in a row as writable or not.

Examples:
data_set.c.

Definition at line 1329 of file table_dataset.c.

void netsnmp_register_auto_data_table ( netsnmp_table_data_set table_set,
char *  registration_name 
)

registers a table_dataset so that the "add_row" snmpd.conf token can be used to add data to this table.

If registration_name is NULL then the name used when the table was created will be used instead.

Todo:
create a properly free'ing registeration pointer for the datalist, and get the datalist freed at shutdown.
Examples:
data_set.c.

Definition at line 915 of file table_dataset.c.

int netsnmp_register_table_data_set ( netsnmp_handler_registration reginfo,
netsnmp_table_data_set data_set,
netsnmp_table_registration_info table_info 
)

register a given data_set at a given oid (specified in the netsnmp_handler_registration pointer).

The reginfo->handler->access_method *may* be null if the call doesn't ever want to be called for SNMP operations.

Examples:
data_set.c.

Definition at line 425 of file table_dataset.c.

int netsnmp_set_row_column ( netsnmp_table_row row,
unsigned int  column,
int  type,
const void *  value,
size_t  value_len 
)

Sets a given column in a row with data given a type, value, and length.

Data is memdup'ed by the function, at least if type != SNMP_NOSUCHINSTANCE and if value_len > 0.

Parameters:
[in]rowPointer to the row to be modified.
[in]columnIndex of the column to be modified.
[in]typeEither the ASN type of the value to be set or SNMP_NOSUCHINSTANCE.
[in]valueIf type != SNMP_NOSUCHINSTANCE, pointer to the new value. May be NULL if value_len == 0, e.g. when storing a zero-length octet string. Ignored when type == SNMP_NOSUCHINSTANCE.
[in]value_lenIf type != SNMP_NOSUCHINSTANCE, number of bytes occupied by *value. Ignored when type == SNMP_NOSUCHINSTANCE.
Returns:
SNMPERR_SUCCESS upon success; SNMPERR_MALLOC when out of memory; or SNMPERR_GENERR when row == 0 or when type does not match the datatype of the data stored in *row.
Examples:
data_set.c.

Definition at line 1381 of file table_dataset.c.

netsnmp_table_row* netsnmp_table_data_set_clone_row ( netsnmp_table_row row)

clones a dataset row, including all data.

Definition at line 230 of file table_dataset.c.

netsnmp_table_row* netsnmp_table_data_set_create_row_from_defaults ( netsnmp_table_data_set_storage defrow)

creates a new row from an existing defined default set

Definition at line 278 of file table_dataset.c.

netsnmp_table_data_set_storage* netsnmp_table_data_set_find_column ( netsnmp_table_data_set_storage start,
unsigned int  column 
)

Finds a column within a given storage set, given the pointer to the start of the storage set list.

Definition at line 1316 of file table_dataset.c.

netsnmp_table_row* netsnmp_table_data_set_get_first_row ( netsnmp_table_data_set table)

returns the first row in the table

Definition at line 1285 of file table_dataset.c.

netsnmp_table_row* netsnmp_table_data_set_get_next_row ( netsnmp_table_data_set table,
netsnmp_table_row row 
)

returns the next row in the table

Definition at line 1292 of file table_dataset.c.

void netsnmp_table_dataset_add_index ( netsnmp_table_data_set table,
u_char  type 
)

adds an index to the table.

Call this repeatly for each index.

Examples:
data_set.c.

Definition at line 1442 of file table_dataset.c.

NETSNMP_INLINE void netsnmp_table_dataset_add_row ( netsnmp_table_data_set table,
netsnmp_table_row row 
)

adds a new row to a dataset table

Examples:
data_set.c.

Definition at line 147 of file table_dataset.c.

NETSNMP_INLINE void netsnmp_table_dataset_delete_all_data ( netsnmp_table_data_set_storage data)

deletes all the data from this node and beyond in the linked list

Definition at line 124 of file table_dataset.c.

NETSNMP_INLINE netsnmp_table_data_set_storage* netsnmp_table_dataset_delete_data ( netsnmp_table_data_set_storage data)

deletes a single dataset table data.

returns the (possibly still good) next pointer of the deleted data object.

Definition at line 111 of file table_dataset.c.

NETSNMP_INLINE void netsnmp_table_dataset_delete_row ( netsnmp_table_row row)

deletes all the data from this node and beyond in the linked list

Definition at line 134 of file table_dataset.c.

NETSNMP_INLINE void netsnmp_table_dataset_remove_and_delete_row ( netsnmp_table_data_set table,
netsnmp_table_row row 
)

removes a row from the table and then deletes it (and all its data)

Definition at line 181 of file table_dataset.c.

NETSNMP_INLINE void netsnmp_table_dataset_remove_row ( netsnmp_table_data_set table,
netsnmp_table_row row 
)

removes a row from the table, but doesn't delete/free the column values

Definition at line 169 of file table_dataset.c.

NETSNMP_INLINE void netsnmp_table_dataset_replace_row ( netsnmp_table_data_set table,
netsnmp_table_row origrow,
netsnmp_table_row newrow 
)

adds a new row to a dataset table

Definition at line 157 of file table_dataset.c.

int netsnmp_table_set_add_default_row ( netsnmp_table_data_set table_set,
unsigned int  column,
int  type,
int  writable,
void *  default_value,
size_t  default_value_len 
)

adds a new default row to a table_set.

Arguments should be the table_set, column number, variable type and finally a 1 if it is allowed to be writable, or a 0 if not. If the default_value field is not NULL, it will be used to populate new valuse in that column fro newly created rows. It is copied into the storage template (free your calling argument).

returns SNMPERR_SUCCESS or SNMPERR_FAILURE

Definition at line 305 of file table_dataset.c.

void netsnmp_table_set_add_indexes ( netsnmp_table_data_set tset,
  ... 
)

adds multiple indexes to a table_dataset helper object.

To end the list, use a 0 after the list of ASN index types.

Definition at line 1453 of file table_dataset.c.

void netsnmp_table_set_multi_add_default_row ( netsnmp_table_data_set tset,
  ... 
)

adds multiple data column definitions to each row.

Functionally, this is a wrapper around calling netsnmp_table_set_add_default_row repeatedly for you.

Examples:
data_set.c.

Definition at line 368 of file table_dataset.c.

void netsnmp_unregister_auto_data_table ( netsnmp_table_data_set table_set,
char *  registration_name 
)

Undo the effect of netsnmp_register_auto_data_table().

Examples:
data_set.c.

Definition at line 935 of file table_dataset.c.