mib2c.access_functions.conf
上传用户:wxp200602
上传日期:2007-10-30
资源大小:4028k
文件大小:7k
源码类别:
SNMP编程
开发平台:
Unix_Linux
- ## -*- c -*-
- ######################################################################
- ## Do the .h file
- ######################################################################
- @open ${name}_access.h@
- /*
- * Note: this file originally auto-generated by mib2c using
- * $Id: mib2c.access_functions.conf,v 1.9 2004/10/14 12:57:33 dts12 Exp $
- */
- #ifndef $name.uc_ACCESS_H
- #define $name.uc_ACCESS_H
- @foreach $t table@
- /** User-defined data access functions for data in table $t */
- /** row level accessors */
- Netsnmp_First_Data_Point ${t}_get_first_data_point;
- Netsnmp_Next_Data_Point ${t}_get_next_data_point;
- int ${t}_commit_row(void **my_data_context, int new_or_del);
- void * ${t}_create_data_context(netsnmp_variable_list *index_data, int column);
- /** column accessors */
- @foreach $c column@
- @if $c.access =~ /(Read|Create)/@
- $c.decl *get_$c(void *data_context, size_t *ret_len);
- @end@
- @if $c.access =~ /(Write|Create)/@
- int set_$c(void *data_context, $c.decl *val, size_t val_len);
- @end@
- @end@
- @end@
- #endif /* $name.uc_ACCESS_H */
- ######################################################################
- ## Do the .c file
- ######################################################################
- @open ${name}_access.c@
- /*
- * Note: this file originally auto-generated by mib2c using
- * $Id: mib2c.access_functions.conf,v 1.9 2004/10/14 12:57:33 dts12 Exp $
- */
- #include <net-snmp/net-snmp-config.h>
- #include <net-snmp/net-snmp-includes.h>
- #include <net-snmp/agent/net-snmp-agent-includes.h>
- #include "${name}_access.h"
- #include "${name}_enums.h"
- @foreach $t table@
- /** returns the first data point within the $t table data.
- Set the my_loop_context variable to the first data point structure
- of your choice (from which you can find the next one). This could
- be anything from the first node in a linked list, to an integer
- pointer containing the beginning of an array variable.
- Set the my_data_context variable to something to be returned to
- you later that will provide you with the data to return in a given
- row. This could be the same pointer as what my_loop_context is
- set to, or something different.
- The put_index_data variable contains a list of snmp variable
- bindings, one for each index in your table. Set the values of
- each appropriately according to the data matching the first row
- and return the put_index_data variable at the end of the function.
- */
- netsnmp_variable_list *
- ${t}_get_first_data_point(void **my_loop_context, void **my_data_context,
- netsnmp_variable_list *put_index_data,
- netsnmp_iterator_info *mydata)
- {
- netsnmp_variable_list *vptr;
- *my_loop_context = /** XXX */;
- *my_data_context = /** XXX */;
- vptr = put_index_data;
- @foreach $idx index@
- snmp_set_var_value(vptr, (u_char *) /** XXX: $idx data */, /** XXX: length of $idx data */);
- vptr = vptr->next_variable;
- @end@
- return put_index_data;
- }
- /** functionally the same as ${t}_get_first_data_point, but
- my_loop_context has already been set to a previous value and should
- be updated to the next in the list. For example, if it was a
- linked list, you might want to cast it to your local data type and
- then return my_loop_context->next. The my_data_context pointer
- should be set to something you need later and the indexes in
- put_index_data updated again. */
- netsnmp_variable_list *
- ${t}_get_next_data_point(void **my_loop_context, void **my_data_context,
- netsnmp_variable_list *put_index_data,
- netsnmp_iterator_info *mydata)
- {
- netsnmp_variable_list *vptr;
- *my_loop_context = /** XXX */;
- *my_data_context = /** XXX */;
- vptr = put_index_data;
- @foreach $idx index@
- snmp_set_var_value(vptr, (u_char *) /** XXX: $idx data */, /** XXX: length of $idx data */);
- vptr = vptr->next_variable;
- @end@
- return put_index_data;
- }
- /** Create a data_context for non-existent rows that SETs are performed on.
- * return a void * pointer which will be passed to subsequent get_XXX
- * and set_XXX functions for data retrival and modification during
- * this SET request.
- *
- * The indexes are encoded (in order) into the index_data pointer,
- * and the column object which triggered the row creation is available
- * via the column parameter, if it would be helpful to use that information.
- */
- void *
- ${t}_create_data_context(netsnmp_variable_list *index_data, int column) {
- return NULL; /* XXX: you likely want to return a real pointer */
- }
- /** If the implemented set_* functions don't operate directly on the
- real-live data (which is actually recommended), then this function
- can be used to take a given my_data_context pointer and "commit" it
- to whereever the modified data needs to be put back to. For
- example, if this was a routing table you could publish the modified
- routes back into the kernel at this point.
- new_or_del will be set to 1 if new, or -1 if it should be deleted
- or 0 if it is just a modification of an existing row.
- If you free the data yourself, make sure to *my_data_context = NULL */
- int
- ${t}_commit_row(void **my_data_context, int new_or_del)
- {
- /** Add any necessary commit code here */
- /* */
- /* return no errors. And there shouldn't be any!!! Ever!!! You
- should have checked the values long before this. */
- return SNMP_ERR_NOERROR;
- }
- /* User-defined data access functions (per column) for data in table $t */
- /*
- * NOTE:
- * - these get_ routines MUST return data that will not be freed (ie,
- * use static variables or persistent data). It will be copied, if
- * needed, immediately after the get_ routine has been called.
- * - these SET routines must copy the incoming data and can not take
- * ownership of the memory passed in by the val pointer.
- */
- @foreach $c column@
- @if $c.access =~ /(Read|Create)/@
- /** XXX: return a data pointer to the data for the $c column and set
- ret_len to its proper size in bytes. */
- $c.decl *get_$c(void *data_context, size_t *ret_len) {
- return NULL; /** XXX: replace this with a pointer to a real value */
- }
- @end@
- @if $c.access =~ /(Write|Create)/@
- /** XXX: Set the value of the $c column and return
- SNMP_ERR_NOERROR on success
- SNMP_ERR_XXX for SNMP deterministic error codes
- SNMP_ERR_GENERR on generic failures (a last result response). */
- int set_$c(void *data_context, $c.decl *val, size_t val_len) {
- return SNMP_ERR_NOERROR; /** XXX: change if an error occurs */
- }
- @end@
- @end@
- @end@