## -*- c -*-

######################################################################

## Do the .h file

######################################################################

@open ${name}_access.h@

/*

 * Note: this file originally auto-generated by mib2c

 * using mib2c.access_functions.conf

 */

#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 mib2c.access_functions.conf

 */

#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, /** 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, /** 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 retrieval 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@