ADC Home > Reference Library > Reference > Mac OS X > Mac OS X Man Pages

 

This document is a Mac OS X manual page. Manual pages are a command-line technology for providing documentation. You can view these manual pages locally using the man(1) command. These manual pages come from many different sources, and thus, have a variety of writing styles.

For more information about the manual page format, see the manual page for manpages(5).



row_merge(3)                                      net-snmp                                      row_merge(3)



NAME
       row_merge - Calls sub handlers with request for one row at a time.



   Defines
       #define ROW_MERGE_WAITING   0
       #define ROW_MERGE_ACTIVE   1
       #define ROW_MERGE_DONE   2
       #define ROW_MERGE_HEAD   3

   Functions
       netsnmp_mib_handler * netsnmp_get_row_merge_handler (int prefix_len)
           returns a row_merge handler that can be injected into a given handler chain.
       int netsnmp_register_row_merge (netsnmp_handler_registration *reginfo)
           functionally the same as calling netsnmp_register_handler() but also injects a row_merge handler
           at the same time for you.
       netsnmp_row_merge_status * netsnmp_row_merge_status_get (netsnmp_handler_registration *reginfo,
           netsnmp_agent_request_info *reqinfo, int create_missing)
           retrieve row_merge_status
       int netsnmp_row_merge_status_first (netsnmp_handler_registration *reginfo, netsnmp_agent_request_info
           *reqinfo)
           Determine if this is the first row.
       int netsnmp_row_merge_status_last (netsnmp_handler_registration *reginfo, netsnmp_agent_request_info
           *reqinfo)
           Determine if this is the last row.
       int netsnmp_row_merge_helper_handler (netsnmp_mib_handler *handler, netsnmp_handler_registration
           *reginfo, netsnmp_agent_request_info *reqinfo, netsnmp_request_info *requests)
           Implements the row_merge handler.
       void netsnmp_init_row_merge (void)
           initializes the row_merge helper which then registers a row_merge handler as a run-time
           injectable handler for configuration file use.

Detailed Description
       Calls sub handlers with request for one row at a time.

       This helper splits a whole bunch of requests into chunks based on the row index that they refer to,
       and passes all requests for a given row to the lower handlers. This is useful for handlers that don't
       want to process multiple rows at the same time, but are happy to iterate through the request list for
       a single row.

Function Documentation
   netsnmp_mib_handler* netsnmp_get_row_merge_handler (int prefix_len)
       returns a row_merge handler that can be injected into a given handler chain.

       Definition at line 28 of file row_merge.c.

       References netsnmp_mib_handler_s::myvoid, netsnmp_create_handler(),
       netsnmp_row_merge_helper_handler(), and NULL.

       Referenced by netsnmp_init_row_merge(), and netsnmp_register_row_merge().

   void netsnmp_init_row_merge (void)
       initializes the row_merge helper which then registers a row_merge handler as a run-time injectable
       handler for configuration file use.

       Definition at line 360 of file row_merge.c.

       References netsnmp_get_row_merge_handler(), and netsnmp_register_handler_by_name().

   int netsnmp_register_row_merge (netsnmp_handler_registration * reginfo)
       functionally the same as calling netsnmp_register_handler() but also injects a row_merge handler at
       the same time for you.

       Definition at line 42 of file row_merge.c.

       References netsnmp_get_row_merge_handler(), netsnmp_inject_handler(), netsnmp_register_handler(), and
       netsnmp_handler_registration_s::rootoid_len.

   int netsnmp_row_merge_helper_handler (netsnmp_mib_handler * handler, netsnmp_handler_registration *
       reginfo, netsnmp_agent_request_info * reqinfo, netsnmp_request_info * requests)
       Implements the row_merge handler.

       Definition at line 154 of file row_merge.c.

       References netsnmp_row_merge_status_x::count, netsnmp_agent_request_info_s::mode,
       netsnmp_mib_handler_s::myvoid, variable_list::name, variable_list::name_length,
       netsnmp_call_next_handler(), netsnmp_row_merge_status_get(), netsnmp_request_info_s::next, NULL,
       netsnmp_request_info_s::prev, netsnmp_request_info_s::processed, netsnmp_request_info_s::requestvb,
       netsnmp_handler_registration_s::rootoid, netsnmp_handler_registration_s::rootoid_len, ROW_MERGE_DONE,
       ROW_MERGE_WAITING, netsnmp_row_merge_status_x::rows, netsnmp_row_merge_status_x::saved_requests,
       netsnmp_row_merge_status_x::saved_status, and SNMP_FREE.

       Referenced by netsnmp_get_row_merge_handler().

   int netsnmp_row_merge_status_first (netsnmp_handler_registration * reginfo, netsnmp_agent_request_info *
       reqinfo)
       Determine if this is the first row.

       returns 1 if this is the first row for this pass of the handler.

       Definition at line 110 of file row_merge.c.

       References netsnmp_row_merge_status_x::count, netsnmp_row_merge_status_x::current,
       netsnmp_row_merge_status_get(), and NULL.

   netsnmp_row_merge_status* netsnmp_row_merge_status_get (netsnmp_handler_registration * reginfo,
       netsnmp_agent_request_info * reqinfo, int create_missing)
       retrieve row_merge_status

       Definition at line 67 of file row_merge.c.

       References netsnmp_agent_add_list_data(), netsnmp_agent_get_list_data(), netsnmp_create_data_list(),
       NULL, snmp_log(), and SNMP_MALLOC_TYPEDEF.

       Referenced by netsnmp_row_merge_helper_handler(), netsnmp_row_merge_status_first(), and
       netsnmp_row_merge_status_last().

   int netsnmp_row_merge_status_last (netsnmp_handler_registration * reginfo, netsnmp_agent_request_info *
       reqinfo)
       Determine if this is the last row.

       returns 1 if this is the last row for this pass of the handler.

       Definition at line 130 of file row_merge.c.

       References netsnmp_row_merge_status_x::count, netsnmp_row_merge_status_x::current,
       netsnmp_row_merge_status_get(), NULL, and netsnmp_row_merge_status_x::rows.



Version 5.4.1                                    27 Jul 2007                                    row_merge(3)

Did this document help you?
Yes: Tell us what works for you.
It’s good, but: Report typos, inaccuracies, and so forth.
It wasn’t helpful: Tell us what would have helped.