source: npl/monitoring/syn3_snmp_subagent/subagent/syn3StatisticsTable/syn3StatisticsTable_interface.c

/*
 * Note: this file originally auto-generated by mib2c using
 *       version : 15899 $ of $ 
 *
 * $Id:$
 */
/*
 * *********************************************************************
 * *********************************************************************
 * *********************************************************************
 * ***                                                               ***
 * ***  NOTE NOTE NOTE NOTE NOTE NOTE NOTE NOTE NOTE NOTE NOTE NOTE  ***
 * ***                                                               ***
 * ***                                                               ***
 * ***       THIS FILE DOES NOT CONTAIN ANY USER EDITABLE CODE.      ***
 * ***                                                               ***
 * ***                                                               ***
 * ***       THE GENERATED CODE IS INTERNAL IMPLEMENTATION, AND      ***
 * ***                                                               ***
 * ***                                                               ***
 * ***    IS SUBJECT TO CHANGE WITHOUT WARNING IN FUTURE RELEASES.   ***
 * ***                                                               ***
 * ***                                                               ***
 * *********************************************************************
 * *********************************************************************
 * *********************************************************************
 */

/* standard Net-SNMP includes */
#include <net-snmp/net-snmp-config.h>
#include <net-snmp/net-snmp-includes.h>
#include <net-snmp/agent/net-snmp-agent-includes.h>

/* include our parent header */
#include "syn3StatisticsTable.h"


#include <net-snmp/agent/table_container.h>
#include <net-snmp/library/container.h>

#include "syn3StatisticsTable_interface.h"

#include <ctype.h>

/**********************************************************************
 **********************************************************************
 ***
 *** Table syn3StatisticsTable
 ***
 **********************************************************************
 **********************************************************************/
/*
 * SYN3-MIB::syn3StatisticsTable is subid 1 of syn3Statistics.
 * Its status is Current.
 * OID: .1.3.6.1.4.1.31337.1.3.1, length: 10
*/
typedef struct syn3StatisticsTable_interface_ctx_s {

   netsnmp_container              *container;
   netsnmp_cache                  *cache;

   syn3StatisticsTable_registration *      user_ctx;
   
   netsnmp_table_registration_info  tbl_info;

   netsnmp_baby_steps_access_methods access_multiplexer;

} syn3StatisticsTable_interface_ctx;

static syn3StatisticsTable_interface_ctx syn3StatisticsTable_if_ctx;

static void _syn3StatisticsTable_container_init(
    syn3StatisticsTable_interface_ctx *if_ctx);
static void _syn3StatisticsTable_container_shutdown(
    syn3StatisticsTable_interface_ctx *if_ctx);


netsnmp_container *
syn3StatisticsTable_container_get( void )
{
    return syn3StatisticsTable_if_ctx.container;
}

syn3StatisticsTable_registration *
syn3StatisticsTable_registration_get( void )
{
    return syn3StatisticsTable_if_ctx.user_ctx;
}

syn3StatisticsTable_registration *
syn3StatisticsTable_registration_set( syn3StatisticsTable_registration * newreg )
{
    syn3StatisticsTable_registration * old = syn3StatisticsTable_if_ctx.user_ctx;
    syn3StatisticsTable_if_ctx.user_ctx = newreg;
    return old;
}

int
syn3StatisticsTable_container_size( void )
{
    return CONTAINER_SIZE(syn3StatisticsTable_if_ctx.container);
}

/*
 * mfd multiplexer modes
 */
static Netsnmp_Node_Handler _mfd_syn3StatisticsTable_pre_request;
static Netsnmp_Node_Handler _mfd_syn3StatisticsTable_post_request;
static Netsnmp_Node_Handler _mfd_syn3StatisticsTable_object_lookup;
static Netsnmp_Node_Handler _mfd_syn3StatisticsTable_get_values;
/**
 * @internal
 * Initialize the table syn3StatisticsTable 
 *    (Define its contents and how it's structured)
 */
void
_syn3StatisticsTable_initialize_interface(syn3StatisticsTable_registration * reg_ptr,  u_long flags)
{
    netsnmp_baby_steps_access_methods *access_multiplexer =
        &syn3StatisticsTable_if_ctx.access_multiplexer;
    netsnmp_table_registration_info *tbl_info = &syn3StatisticsTable_if_ctx.tbl_info;
    netsnmp_handler_registration *reginfo;
    netsnmp_mib_handler *handler;
    int    mfd_modes = 0;

    DEBUGMSGTL(("internal:syn3StatisticsTable:_syn3StatisticsTable_initialize_interface","called\n"));


    /*************************************************
     *
     * save interface context for syn3StatisticsTable
     */
    /*
     * Setting up the table's definition
     */
    netsnmp_table_helper_add_indexes(tbl_info,
                                  ASN_OCTET_STR, /** index: syn3StatisticsName */
                             0);

    /*  Define the minimum and maximum accessible columns.  This
        optimizes retrival. */
    tbl_info->min_column = SYN3STATISTICSTABLE_MIN_COL;
    tbl_info->max_column = SYN3STATISTICSTABLE_MAX_COL;

    /*
     * save users context
     */
    syn3StatisticsTable_if_ctx.user_ctx = reg_ptr;

    /*
     * call data access initialization code
     */
    syn3StatisticsTable_init_data(reg_ptr);

    /*
     * set up the container
     */
    _syn3StatisticsTable_container_init(&syn3StatisticsTable_if_ctx);
    if (NULL == syn3StatisticsTable_if_ctx.container) {
        snmp_log(LOG_ERR,"could not initialize container for syn3StatisticsTable\n");
        return;
    }
    
    /*
     * access_multiplexer: REQUIRED wrapper for get request handling
     */
    access_multiplexer->object_lookup = _mfd_syn3StatisticsTable_object_lookup;
    access_multiplexer->get_values = _mfd_syn3StatisticsTable_get_values;

    /*
     * no wrappers yet
     */
    access_multiplexer->pre_request = _mfd_syn3StatisticsTable_pre_request;
    access_multiplexer->post_request = _mfd_syn3StatisticsTable_post_request;


    /*************************************************
     *
     * Create a registration, save our reg data, register table.
     */
    DEBUGMSGTL(("syn3StatisticsTable:init_syn3StatisticsTable",
                "Registering syn3StatisticsTable as a mibs-for-dummies table.\n"));              
    handler = netsnmp_baby_steps_access_multiplexer_get(access_multiplexer);
    reginfo = netsnmp_handler_registration_create("syn3StatisticsTable", handler,
                                                  syn3StatisticsTable_oid,
                                                  syn3StatisticsTable_oid_size,
                                                  HANDLER_CAN_BABY_STEP |
                                                  HANDLER_CAN_RONLY
                                                  );
    if(NULL == reginfo) {
        snmp_log(LOG_ERR,"error registering table syn3StatisticsTable\n");
        return;
    }
    reginfo->my_reg_void = &syn3StatisticsTable_if_ctx;

    /*************************************************
     *
     * set up baby steps handler, create it and inject it
     */
    if( access_multiplexer->object_lookup )
        mfd_modes |= BABY_STEP_OBJECT_LOOKUP;
    if( access_multiplexer->set_values )
        mfd_modes |= BABY_STEP_SET_VALUES;
    if( access_multiplexer->irreversible_commit )
        mfd_modes |= BABY_STEP_IRREVERSIBLE_COMMIT;
    if( access_multiplexer->object_syntax_checks )
        mfd_modes |= BABY_STEP_CHECK_OBJECT;

    if( access_multiplexer->pre_request )
        mfd_modes |= BABY_STEP_PRE_REQUEST;
    if( access_multiplexer->post_request )
        mfd_modes |= BABY_STEP_POST_REQUEST;
    
    if( access_multiplexer->undo_setup )
        mfd_modes |= BABY_STEP_UNDO_SETUP;
    if( access_multiplexer->undo_cleanup )
        mfd_modes |= BABY_STEP_UNDO_CLEANUP;
    if( access_multiplexer->undo_sets )
        mfd_modes |= BABY_STEP_UNDO_SETS;
    
    if( access_multiplexer->row_creation )
        mfd_modes |= BABY_STEP_ROW_CREATE;
    if( access_multiplexer->consistency_checks )
        mfd_modes |= BABY_STEP_CHECK_CONSISTENCY;
    if( access_multiplexer->commit )
        mfd_modes |= BABY_STEP_COMMIT;
    if( access_multiplexer->undo_commit )
        mfd_modes |= BABY_STEP_UNDO_COMMIT;
    
    handler = netsnmp_baby_steps_handler_get(mfd_modes);
    netsnmp_inject_handler(reginfo, handler);

    /*************************************************
     *
     * inject row_merge helper with prefix rootoid_len + 2 (entry.col)
     */
    handler = netsnmp_get_row_merge_handler(reginfo->rootoid_len + 2);
    netsnmp_inject_handler(reginfo, handler);

    /*************************************************
     *
     * inject container_table helper
     */
    handler =
        netsnmp_container_table_handler_get(tbl_info,
                                            syn3StatisticsTable_if_ctx.container,
                                            TABLE_CONTAINER_KEY_NETSNMP_INDEX);
    netsnmp_inject_handler( reginfo, handler );

    /*************************************************
     *
     * inject cache helper
     */
    if(NULL != syn3StatisticsTable_if_ctx.cache) {
        handler = netsnmp_cache_handler_get(syn3StatisticsTable_if_ctx.cache);
        netsnmp_inject_handler( reginfo, handler );
    }

    /*
     * register table
     */
    netsnmp_register_table(reginfo, tbl_info);

} /* _syn3StatisticsTable_initialize_interface */

/**
 * @internal
 * Shutdown the table syn3StatisticsTable
 */
void
_syn3StatisticsTable_shutdown_interface(syn3StatisticsTable_registration * reg_ptr)
{
    /*
     * shutdown the container
     */
    _syn3StatisticsTable_container_shutdown(&syn3StatisticsTable_if_ctx);
}

void
syn3StatisticsTable_valid_columns_set(netsnmp_column_info *vc)
{
    syn3StatisticsTable_if_ctx.tbl_info.valid_columns = vc;
} /* syn3StatisticsTable_valid_columns_set */

/**
 * @internal
 * convert the index component stored in the context to an oid
 */
int
syn3StatisticsTable_index_to_oid(netsnmp_index *oid_idx,
                         syn3StatisticsTable_mib_index *mib_idx)
{
    int err = SNMP_ERR_NOERROR;
    
    /*
     * temp storage for parsing indexes
     */
    /*
     * syn3StatisticsName(1)/DisplayString/ASN_OCTET_STR/char(char)//L/A/w/e/R/d/H
     */
    netsnmp_variable_list var_syn3StatisticsName;

    /*
     * set up varbinds
     */
    memset( &var_syn3StatisticsName, 0x00, sizeof(var_syn3StatisticsName) );
    var_syn3StatisticsName.type = ASN_OCTET_STR;

    /*
     * chain temp index varbinds together
     */
    var_syn3StatisticsName.next_variable =  NULL;


    DEBUGMSGTL(("verbose:syn3StatisticsTable:syn3StatisticsTable_index_to_oid","called\n"));

        /* syn3StatisticsName(1)/DisplayString/ASN_OCTET_STR/char(char)//L/A/w/e/R/d/H */
    snmp_set_var_value(&var_syn3StatisticsName, (u_char*)&mib_idx->syn3StatisticsName,
                       mib_idx->syn3StatisticsName_len * sizeof(mib_idx->syn3StatisticsName[0]));


    err = build_oid_noalloc(oid_idx->oids, oid_idx->len, &oid_idx->len,
                           NULL, 0, &var_syn3StatisticsName);
    if(err)
        snmp_log(LOG_ERR,"error %d converting index to oid\n", err);

    /*
     * parsing may have allocated memory. free it.
     */
    snmp_reset_var_buffers( &var_syn3StatisticsName );

    return err;
} /* syn3StatisticsTable_index_to_oid */

/**
 * extract syn3StatisticsTable indexes from a netsnmp_index
 *
 * @retval SNMP_ERR_NOERROR  : no error
 * @retval SNMP_ERR_GENERR   : error
 */
int
syn3StatisticsTable_index_from_oid(netsnmp_index *oid_idx,
                         syn3StatisticsTable_mib_index *mib_idx)
{
    int err = SNMP_ERR_NOERROR;
    
    /*
     * temp storage for parsing indexes
     */
    /*
     * syn3StatisticsName(1)/DisplayString/ASN_OCTET_STR/char(char)//L/A/w/e/R/d/H
     */
    netsnmp_variable_list var_syn3StatisticsName;

    /*
     * set up varbinds
     */
    memset( &var_syn3StatisticsName, 0x00, sizeof(var_syn3StatisticsName) );
    var_syn3StatisticsName.type = ASN_OCTET_STR;

    /*
     * chain temp index varbinds together
     */
    var_syn3StatisticsName.next_variable =  NULL;


    DEBUGMSGTL(("verbose:syn3StatisticsTable:syn3StatisticsTable_index_from_oid","called\n"));

    /*
     * parse the oid into the individual index components
     */
    err = parse_oid_indexes( oid_idx->oids, oid_idx->len,
                             &var_syn3StatisticsName );
    if (err == SNMP_ERR_NOERROR) {
        /*
         * copy out values
         */
    /*
     * NOTE: val_len is in bytes, syn3StatisticsName_len might not be
     */
         if(var_syn3StatisticsName.val_len > sizeof(mib_idx->syn3StatisticsName))
             err = SNMP_ERR_GENERR;
         else {
             memcpy(mib_idx->syn3StatisticsName, var_syn3StatisticsName.val.string, var_syn3StatisticsName.val_len);
             mib_idx->syn3StatisticsName_len = var_syn3StatisticsName.val_len / sizeof(mib_idx->syn3StatisticsName[0]);
         }


    }

    /*
     * parsing may have allocated memory. free it.
     */
    snmp_reset_var_buffers( &var_syn3StatisticsName );

    return err;
} /* syn3StatisticsTable_index_from_oid */


/* *********************************************************************
 * @internal
 * allocate resources for a syn3StatisticsTable_rowreq_ctx
 */
syn3StatisticsTable_rowreq_ctx *
syn3StatisticsTable_allocate_rowreq_ctx(void *user_init_ctx)
{
    syn3StatisticsTable_rowreq_ctx *rowreq_ctx =
                  SNMP_MALLOC_TYPEDEF(syn3StatisticsTable_rowreq_ctx);

    DEBUGMSGTL(("internal:syn3StatisticsTable:syn3StatisticsTable_allocate_rowreq_ctx","called\n"));

    if(NULL == rowreq_ctx) {
        snmp_log(LOG_ERR,"Couldn't allocate memory for a "
                 "syn3StatisticsTable_rowreq_ctx.\n");
        return NULL;
    }

    rowreq_ctx->oid_idx.oids = rowreq_ctx->oid_tmp;

    rowreq_ctx->syn3StatisticsTable_data_list = NULL;

    /*
     * if we allocated data, call init routine
     */
    if (!(rowreq_ctx->rowreq_flags & MFD_ROW_DATA_FROM_USER)) {
        if(SNMPERR_SUCCESS !=
            syn3StatisticsTable_rowreq_ctx_init(rowreq_ctx, user_init_ctx)) {
           syn3StatisticsTable_release_rowreq_ctx(rowreq_ctx);
           rowreq_ctx = NULL;
        }
    }

    return rowreq_ctx;
} /* syn3StatisticsTable_allocate_rowreq_ctx */

/*
 * @internal
 * release resources for a syn3StatisticsTable_rowreq_ctx
 */
void
syn3StatisticsTable_release_rowreq_ctx(syn3StatisticsTable_rowreq_ctx *rowreq_ctx)
{
    DEBUGMSGTL(("internal:syn3StatisticsTable:syn3StatisticsTable_release_rowreq_ctx","called\n"));

    netsnmp_assert(NULL != rowreq_ctx);
    
    syn3StatisticsTable_rowreq_ctx_cleanup(rowreq_ctx);

    /*
     * free index oid pointer
     */
    if(rowreq_ctx->oid_idx.oids != rowreq_ctx->oid_tmp)
        free(rowreq_ctx->oid_idx.oids);

    SNMP_FREE(rowreq_ctx);
} /* syn3StatisticsTable_release_rowreq_ctx */

/**
 * @internal
 * wrapper
 */
static int
_mfd_syn3StatisticsTable_pre_request(netsnmp_mib_handler *handler,
                            netsnmp_handler_registration *reginfo,
                            netsnmp_agent_request_info *agtreq_info,
                            netsnmp_request_info *requests)
{
    int rc;

    DEBUGMSGTL(("internal:syn3StatisticsTable:_mfd_syn3StatisticsTable_pre_request",
                "called\n"));
    
    if (1 != netsnmp_row_merge_status_first(reginfo, agtreq_info)) {
        DEBUGMSGTL(("internal:syn3StatisticsTable",
                    "skipping additional pre_request\n"));
        return SNMP_ERR_NOERROR;
    }
        
    rc = syn3StatisticsTable_pre_request(syn3StatisticsTable_if_ctx.user_ctx);
    if (MFD_SUCCESS != rc) {
        /*
         * nothing we can do about it but log it
         */
        DEBUGMSGTL(("syn3StatisticsTable","error %d from "
                    "syn3StatisticsTable_pre_request\n", rc));
        netsnmp_request_set_error_all(requests, SNMP_VALIDATE_ERR(rc));
    }
    
    return SNMP_ERR_NOERROR;
} /* _mfd_syn3StatisticsTable_pre_request */

/**
 * @internal
 * wrapper
 */
static int
_mfd_syn3StatisticsTable_post_request(netsnmp_mib_handler *handler,
                             netsnmp_handler_registration *reginfo,
                             netsnmp_agent_request_info *agtreq_info,
                             netsnmp_request_info *requests)
{
    syn3StatisticsTable_rowreq_ctx *rowreq_ctx =
                  netsnmp_container_table_row_extract(requests);
    int rc, packet_rc;

    DEBUGMSGTL(("internal:syn3StatisticsTable:_mfd_syn3StatisticsTable_post_request",
                "called\n"));

    /*
     * release row context, if deleted
     */
    if (rowreq_ctx && (rowreq_ctx->rowreq_flags & MFD_ROW_DELETED))
        syn3StatisticsTable_release_rowreq_ctx(rowreq_ctx);

    /*
     * wait for last call before calling user
     */
    if (1 != netsnmp_row_merge_status_last(reginfo, agtreq_info)) {
        DEBUGMSGTL(("internal:syn3StatisticsTable",
                    "waiting for last post_request\n"));
        return SNMP_ERR_NOERROR;
    }
    
    packet_rc = netsnmp_check_all_requests_error(agtreq_info->asp, 0);
    rc = syn3StatisticsTable_post_request(syn3StatisticsTable_if_ctx.user_ctx,packet_rc);
    if (MFD_SUCCESS != rc) {
        /*
         * nothing we can do about it but log it
         */
        DEBUGMSGTL(("syn3StatisticsTable","error %d from "
                    "syn3StatisticsTable_post_request\n", rc));
    }
    
    return SNMP_ERR_NOERROR;
} /* _mfd_syn3StatisticsTable_post_request */

/**
 * @internal
 * wrapper
 */
static int
_mfd_syn3StatisticsTable_object_lookup(netsnmp_mib_handler *handler,
                         netsnmp_handler_registration *reginfo,
                         netsnmp_agent_request_info *agtreq_info,
                         netsnmp_request_info *requests)
{
    int                    rc = SNMP_ERR_NOERROR;
    syn3StatisticsTable_rowreq_ctx *rowreq_ctx =
                  netsnmp_container_table_row_extract(requests);
    
    DEBUGMSGTL(("internal:syn3StatisticsTable:_mfd_syn3StatisticsTable_object_lookup","called\n"));

    /*
     * get our context from mfd
     * syn3StatisticsTable_interface_ctx *if_ctx =
     *             (syn3StatisticsTable_interface_ctx *)reginfo->my_reg_void;
     */

    if(NULL == rowreq_ctx) {
        rc = SNMP_ERR_NOCREATION;
    }

    if (MFD_SUCCESS != rc)
        netsnmp_request_set_error_all(requests, rc);
    else
        syn3StatisticsTable_row_prep(rowreq_ctx);

    return SNMP_VALIDATE_ERR(rc);
} /* _mfd_syn3StatisticsTable_object_lookup */

/***********************************************************************
 *
 * GET processing
 *
 ***********************************************************************/
/*
 * @internal
 * Retrieve the value for a particular column
 */
NETSNMP_STATIC_INLINE int
_syn3StatisticsTable_get_column( syn3StatisticsTable_rowreq_ctx *rowreq_ctx,
                       netsnmp_variable_list *var, int column )
{
    int rc = SNMPERR_SUCCESS;
    
    DEBUGMSGTL(("internal:syn3StatisticsTable:_mfd_syn3StatisticsTable_get_column",
                "called for %d\n", column));


    netsnmp_assert(NULL != rowreq_ctx);

    switch(column) {

    /* (INDEX) syn3StatisticsName(1)/DisplayString/ASN_OCTET_STR/char(char)//L/A/w/e/R/d/H */
    case COLUMN_SYN3STATISTICSNAME:
    var->type = ASN_OCTET_STR;
    /*
     * NOTE: val_len is in bytes, syn3StatisticsName_len might not be (e.g. oids)
     */
        if (var->val_len < (rowreq_ctx->tbl_idx.syn3StatisticsName_len *
                            sizeof(rowreq_ctx->tbl_idx.syn3StatisticsName[0]))) {
           var->val.string = malloc(rowreq_ctx->tbl_idx.syn3StatisticsName_len *
                                    sizeof(rowreq_ctx->tbl_idx.syn3StatisticsName[0]));
        }
        var->val_len = rowreq_ctx->tbl_idx.syn3StatisticsName_len * sizeof(rowreq_ctx->tbl_idx.syn3StatisticsName[0]);
        memcpy( var->val.string, rowreq_ctx->tbl_idx.syn3StatisticsName, var->val_len );
        break;

    /* syn3StatisticsValue1(2)/INTEGER32/ASN_INTEGER/long(long)//l/A/w/e/r/d/h */
    case COLUMN_SYN3STATISTICSVALUE1:
    var->val_len = sizeof(long);
    var->type = ASN_INTEGER;
rc = syn3StatisticsValue1_get(rowreq_ctx, (long *)var->val.string );
        break;

    /* syn3StatisticsValue2(3)/INTEGER32/ASN_INTEGER/long(long)//l/A/w/e/r/d/h */
    case COLUMN_SYN3STATISTICSVALUE2:
    var->val_len = sizeof(long);
    var->type = ASN_INTEGER;
rc = syn3StatisticsValue2_get(rowreq_ctx, (long *)var->val.string );
        break;

    /* syn3StatisticsValue3(4)/INTEGER32/ASN_INTEGER/long(long)//l/A/w/e/r/d/h */
    case COLUMN_SYN3STATISTICSVALUE3:
    var->val_len = sizeof(long);
    var->type = ASN_INTEGER;
rc = syn3StatisticsValue3_get(rowreq_ctx, (long *)var->val.string );
        break;

    /* syn3StatisticsValue4(5)/INTEGER32/ASN_INTEGER/long(long)//l/A/w/e/r/d/h */
    case COLUMN_SYN3STATISTICSVALUE4:
    var->val_len = sizeof(long);
    var->type = ASN_INTEGER;
rc = syn3StatisticsValue4_get(rowreq_ctx, (long *)var->val.string );
        break;

    /* syn3StatisticsValue5(6)/INTEGER32/ASN_INTEGER/long(long)//l/A/w/e/r/d/h */
    case COLUMN_SYN3STATISTICSVALUE5:
    var->val_len = sizeof(long);
    var->type = ASN_INTEGER;
rc = syn3StatisticsValue5_get(rowreq_ctx, (long *)var->val.string );
        break;

     default:
        if (SYN3STATISTICSTABLE_MIN_COL <= column && column <= SYN3STATISTICSTABLE_MAX_COL) {
            DEBUGMSGTL(("internal:syn3StatisticsTable:_mfd_syn3StatisticsTable_get_column",
                "assume column %d is reserved\n", column));
            rc = MFD_SKIP;
        } else {
            snmp_log(LOG_ERR,
                "unknown column %d in _syn3StatisticsTable_get_column\n", column);
        }
        break;
    }

    return rc;
} /* _syn3StatisticsTable_get_column */

int
_mfd_syn3StatisticsTable_get_values(netsnmp_mib_handler *handler,
                         netsnmp_handler_registration *reginfo,
                         netsnmp_agent_request_info *agtreq_info,
                         netsnmp_request_info *requests)
{
    syn3StatisticsTable_rowreq_ctx *rowreq_ctx =
                  netsnmp_container_table_row_extract(requests);
    netsnmp_table_request_info * tri;
    u_char                     * old_string;
    void                      (*dataFreeHook)(void *);
    int                        rc;

    DEBUGMSGTL(("internal:syn3StatisticsTable:_mfd_syn3StatisticsTable_get_values","called\n"));

    netsnmp_assert(NULL != rowreq_ctx);
    
    for(;requests; requests = requests->next) {
        /*
         * save old pointer, so we can free it if replaced
         */
        old_string = requests->requestvb->val.string;
        dataFreeHook = requests->requestvb->dataFreeHook;
        if(NULL == requests->requestvb->val.string) {
            requests->requestvb->val.string = requests->requestvb->buf;
            requests->requestvb->val_len = sizeof(requests->requestvb->buf);
        }
        else if(requests->requestvb->buf == requests->requestvb->val.string) {
            if(requests->requestvb->val_len != sizeof(requests->requestvb->buf))
                requests->requestvb->val_len = sizeof(requests->requestvb->buf);
        }

        /*
         * get column data
         */
        tri = netsnmp_extract_table_info(requests);
        if(NULL == tri)
            continue;
        
        rc = _syn3StatisticsTable_get_column(rowreq_ctx, requests->requestvb, tri->colnum);
        if(rc) {
            if(MFD_SKIP == rc) {
                requests->requestvb->type = SNMP_NOSUCHINSTANCE;
                rc = SNMP_ERR_NOERROR;
            }
        }
        else if (NULL == requests->requestvb->val.string) {
            snmp_log(LOG_ERR,"NULL varbind data pointer!\n");
            rc = SNMP_ERR_GENERR;
        }
        if(rc)
            netsnmp_request_set_error(requests, SNMP_VALIDATE_ERR(rc));

        /*
         * if the buffer wasn't used previously for the old data (i.e. it
         * was allcoated memory)  and the get routine replaced the pointer,
         * we need to free the previous pointer.
         */
        if(old_string && (old_string != requests->requestvb->buf) &&
           (requests->requestvb->val.string != old_string)) {
            if(dataFreeHook)
                (*dataFreeHook)(old_string);
            else
                free(old_string);
        }
    } /* for results */

    return SNMP_ERR_NOERROR;
} /* _mfd_syn3StatisticsTable_get_values */


/***********************************************************************
 *
 * SET processing
 *
 ***********************************************************************/

/*
 * SET PROCESSING NOT APPLICABLE (per MIB or user setting)
 */
/***********************************************************************
 *
 * DATA ACCESS
 *
 ***********************************************************************/
static void _container_free(netsnmp_container *container);

/**
 * @internal
 */
static int
_cache_load(netsnmp_cache *cache, void *vmagic)
{
    DEBUGMSGTL(("internal:syn3StatisticsTable:_cache_load","called\n"));

    if((NULL == cache) || (NULL == cache->magic)) {
        snmp_log(LOG_ERR, "invalid cache for syn3StatisticsTable_cache_load\n");
        return -1;
    }

    /** should only be called for an invalid or expired cache */
    netsnmp_assert((0 == cache->valid) || (1 == cache->expired));
    
    /*
     * call user code
     */
    return syn3StatisticsTable_container_load((netsnmp_container*)cache->magic);
} /* _cache_load */

/**
 * @internal
 */
static void
_cache_free(netsnmp_cache *cache, void *magic)
{
    netsnmp_container *container;

    DEBUGMSGTL(("internal:syn3StatisticsTable:_cache_free","called\n"));

    if((NULL == cache) || (NULL == cache->magic)) {
        snmp_log(LOG_ERR, "invalid cache in syn3StatisticsTable_cache_free\n");
        return;
    }

    container = (netsnmp_container*)cache->magic;

    _container_free(container);
} /* _cache_free */

/**
 * @internal
 */
static void
_container_item_free(syn3StatisticsTable_rowreq_ctx *rowreq_ctx, void *context)
{
    DEBUGMSGTL(("internal:syn3StatisticsTable:_container_item_free","called\n"));

    if(NULL == rowreq_ctx)
        return;

    syn3StatisticsTable_release_rowreq_ctx(rowreq_ctx);
} /* _container_item_free */

/**
 * @internal
 */
static void
_container_free(netsnmp_container *container)
{
    DEBUGMSGTL(("internal:syn3StatisticsTable:_container_free","called\n"));

    if (NULL == container) {
        snmp_log(LOG_ERR, "invalid container in syn3StatisticsTable_container_free\n");
        return;
    }

    /*
     * call user code
     */
    syn3StatisticsTable_container_free(container);
    
    /*
     * free all items. inefficient, but easy.
     */
    CONTAINER_CLEAR(container,
                    (netsnmp_container_obj_func *)_container_item_free,
                    NULL);
} /* _container_free */

/**
 * @internal
 * initialize the container with functions or wrappers
 */
void
_syn3StatisticsTable_container_init(syn3StatisticsTable_interface_ctx *if_ctx)
{
    DEBUGMSGTL(("internal:syn3StatisticsTable:_syn3StatisticsTable_container_init","called\n"));

    /*
     * cache init
     */
    if_ctx->cache = netsnmp_cache_create(30, /* timeout in seconds */
                                         _cache_load, _cache_free,
                                         syn3StatisticsTable_oid,
                                         syn3StatisticsTable_oid_size);

    if(NULL == if_ctx->cache) {
        snmp_log(LOG_ERR, "error creating cache for syn3StatisticsTable\n");
        return;
    }

    if_ctx->cache->flags = NETSNMP_CACHE_DONT_INVALIDATE_ON_SET;

    syn3StatisticsTable_container_init(&if_ctx->container, if_ctx->cache);
    if(NULL == if_ctx->container)
        if_ctx->container = netsnmp_container_find("syn3StatisticsTable:table_container");
    if(NULL == if_ctx->container) {
        snmp_log(LOG_ERR,"error creating container in "
                 "syn3StatisticsTable_container_init\n");
        return;
    }

    if (NULL != if_ctx->cache)
        if_ctx->cache->magic = (void*)if_ctx->container;
} /* _syn3StatisticsTable_container_init */

/**
 * @internal
 * shutdown the container with functions or wrappers
 */
void
_syn3StatisticsTable_container_shutdown(syn3StatisticsTable_interface_ctx *if_ctx)
{
    DEBUGMSGTL(("internal:syn3StatisticsTable:_syn3StatisticsTable_container_shutdown","called\n"));

    syn3StatisticsTable_container_shutdown(if_ctx->container);

    _container_free(if_ctx->container);

} /* _syn3StatisticsTable_container_shutdown */


syn3StatisticsTable_rowreq_ctx *
syn3StatisticsTable_row_find_by_mib_index(syn3StatisticsTable_mib_index *mib_idx)
{
    syn3StatisticsTable_rowreq_ctx   *rowreq_ctx;
    oid                      oid_tmp[MAX_OID_LEN];
    netsnmp_index            oid_idx;
    int                      rc;

    /*
     * set up storage for OID
     */
    oid_idx.oids = oid_tmp;
    oid_idx.len = sizeof(oid_tmp)/sizeof(oid);

    /*
     * convert
     */
    rc = syn3StatisticsTable_index_to_oid(&oid_idx, mib_idx);
    if (MFD_SUCCESS != rc)
        return NULL;

    rowreq_ctx = CONTAINER_FIND(syn3StatisticsTable_if_ctx.container, &oid_idx);

    return rowreq_ctx;
}