/*
 * table_iterator.h 
 */
#ifndef _TABLE_DATA_HANDLER_H_
#define _TABLE_DATA_HANDLER_H_

#ifdef __cplusplus
extern          "C" {
#endif

    /*
     * This helper is designed to completely automate the task of storing
     * tables of data within the agent that are not tied to external data
     * sources (like the kernel, hardware, or other processes, etc).  IE,
     * all rows within a table are expected to be added manually using
     * functions found below.
     */

#define TABLE_DATA_NAME "table_data"

    typedef struct netsnmp_table_row_s {
        netsnmp_variable_list *indexes; /* stored permanently if store_indexes = 1 */
        oid            *index_oid;
        size_t          index_oid_len;
        void           *data;   /* the data to store */

        struct netsnmp_table_row_s *next, *prev;        /* if used in a list */
    } netsnmp_table_row;

    typedef struct netsnmp_table_data_s {
        netsnmp_variable_list *indexes_template;        /* containing only types */
        char           *name;   /* if !NULL, it's registered globally */
        int             flags;  /* not currently used */
        int             store_indexes;
        netsnmp_table_row *first_row;
        netsnmp_table_row *last_row;
    } netsnmp_table_data;

    netsnmp_mib_handler *netsnmp_get_table_data_handler(netsnmp_table_data
                                                        *table);
    void            netsnmp_table_data_generate_index_oid(netsnmp_table_row
                                                          *row);
    int             netsnmp_table_data_add_row(netsnmp_table_data *table,
                                               netsnmp_table_row *row);
    netsnmp_table_row *netsnmp_table_data_remove_row(netsnmp_table_data
                                                     *table,
                                                     netsnmp_table_row
                                                     *row);
    void           *netsnmp_table_data_delete_row(netsnmp_table_row *row);
    void          
        *netsnmp_table_data_remove_and_delete_row(netsnmp_table_data
                                                  *table,
                                                  netsnmp_table_row *row);

    netsnmp_table_row *netsnmp_table_data_get(netsnmp_table_data *table,
                                              netsnmp_variable_list *
                                              indexes);

    netsnmp_table_row *netsnmp_table_data_get_from_oid(netsnmp_table_data
                                                       *table,
                                                       oid * searchfor,
                                                       size_t
                                                       searchfor_len);

    int            
        netsnmp_register_table_data(netsnmp_handler_registration *reginfo,
                                    netsnmp_table_data *table,
                                    netsnmp_table_registration_info
                                    *table_info);
    int            
        netsnmp_register_read_only_table_data(netsnmp_handler_registration
                                              *reginfo,
                                              netsnmp_table_data *table,
                                              netsnmp_table_registration_info
                                              *table_info);

    netsnmp_table_row *netsnmp_extract_table_row(netsnmp_request_info *);
    void           *netsnmp_extract_table_row_data(netsnmp_request_info *);
    netsnmp_table_data *netsnmp_create_table_data(const char *name);
    netsnmp_table_row *netsnmp_create_table_data_row(void);
    netsnmp_table_row *netsnmp_table_data_clone_row(netsnmp_table_row
                                                    *row);
    NETSNMP_INLINE void
       netsnmp_table_data_replace_row(netsnmp_table_data *table,
                                      netsnmp_table_row *origrow,
                                      netsnmp_table_row *newrow);

    int            
        netsnmp_table_data_build_result(netsnmp_handler_registration
                                        *reginfo,
                                        netsnmp_agent_request_info
                                        *reqinfo,
                                        netsnmp_request_info *request,
                                        netsnmp_table_row *row, int column,
                                        u_char type, u_char * result_data,
                                        size_t result_data_len);


#define netsnmp_table_data_add_index(thetable, type) snmp_varlist_add_variable(&thetable->indexes_template, NULL, 0, type, NULL, 0)
#define netsnmp_table_row_add_index(row, type, value, value_len) snmp_varlist_add_variable(&row->indexes, NULL, 0, type, (const u_char *) value, value_len)


    Netsnmp_Node_Handler netsnmp_table_data_helper_handler;
    int netsnmp_table_data_num_rows(netsnmp_table_data *table);

#ifdef __cplusplus
}
#endif

#endif                          /* _TABLE_DATA_HANDLER_H_ */
