net-snmp 5.7
|
Holds iterator information containing functions which should be called by the iterator_handler to loop over your data set and sort it in a SNMP specific manner. More...
#include <table_iterator.h>
Data Fields | |
int | refcnt |
Number of handlers that own this data structure. | |
Netsnmp_First_Data_Point * | get_first_data_point |
Responsible for: returning the first set of "index" data, a loop-context pointer, and optionally a data context pointer. | |
Netsnmp_Next_Data_Point * | get_next_data_point |
Given the previous loop context, this should return the next loop context, associated index set and optionally a data context. | |
Netsnmp_Make_Data_Context * | make_data_context |
If a data context wasn't supplied by the get_first_data_point or get_next_data_point functions and the make_data_context pointer is defined, it will be called to convert a loop context into a data context. | |
Netsnmp_Free_Loop_Context * | free_loop_context |
A function which should free the loop context. | |
Netsnmp_Free_Data_Context * | free_data_context |
Frees a data context. | |
Netsnmp_Free_Loop_Context * | free_loop_context_at_end |
Frees a loop context at the end of the entire iteration sequence. | |
void * | myvoid |
This can be used by client handlers to store any information they need. | |
int | flags |
netsnmp_table_registration_info * | table_reginfo |
A pointer to the netsnmp_table_registration_info object this iterator is registered along with. | |
Netsnmp_First_Data_Point * | get_row_indexes |
netsnmp_variable_list * | indexes |
Holds iterator information containing functions which should be called by the iterator_handler to loop over your data set and sort it in a SNMP specific manner.
The netsnmp_iterator_info typedef can be used instead of directly calling this struct if you would prefer.
Definition at line 53 of file table_iterator.h.
Netsnmp_Free_Data_Context* netsnmp_iterator_info_s::free_data_context |
Frees a data context.
This will be called at any time a data context needs to be freed. This may be at the same time as a correspondng loop context is freed, or much much later. Multiple data contexts may be kept in existence at any time.
Definition at line 85 of file table_iterator.h.
Netsnmp_Free_Loop_Context* netsnmp_iterator_info_s::free_loop_context |
A function which should free the loop context.
This function is called at *each* iteration step, which is not-optimal for speed purposes. The use of free_loop_context_at_end instead is strongly encouraged. This can be set to NULL to avoid its usage.
Definition at line 78 of file table_iterator.h.
Netsnmp_Free_Loop_Context* netsnmp_iterator_info_s::free_loop_context_at_end |
Frees a loop context at the end of the entire iteration sequence.
Generally, this would free the loop context allocated by the get_first_data_point function (which would then be updated by each call to the get_next_data_point function). It is not called until the get_next_data_point function returns a NULL
Definition at line 93 of file table_iterator.h.
Netsnmp_First_Data_Point* netsnmp_iterator_info_s::get_first_data_point |
Responsible for: returning the first set of "index" data, a loop-context pointer, and optionally a data context pointer.
Definition at line 60 of file table_iterator.h.
Netsnmp_Next_Data_Point* netsnmp_iterator_info_s::get_next_data_point |
Given the previous loop context, this should return the next loop context, associated index set and optionally a data context.
Definition at line 65 of file table_iterator.h.
Netsnmp_Make_Data_Context* netsnmp_iterator_info_s::make_data_context |
If a data context wasn't supplied by the get_first_data_point or get_next_data_point functions and the make_data_context pointer is defined, it will be called to convert a loop context into a data context.
Definition at line 71 of file table_iterator.h.
This can be used by client handlers to store any information they need.
Definition at line 97 of file table_iterator.h.
Number of handlers that own this data structure.
Definition at line 55 of file table_iterator.h.
A pointer to the netsnmp_table_registration_info object this iterator is registered along with.
Definition at line 104 of file table_iterator.h.