netsnmp_row_merge.3
上传用户:wxp200602
上传日期:2007-10-30
资源大小:4028k
文件大小:4k
- .TH "row_merge: Calls sub handlers with request for one row at a time." 3 "28 Nov 2005" "Version 5.2.1.rc3" "net-snmp" " -*- nroff -*-
- .ad l
- .nh
- .SH NAME
- row_merge: 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.
- .PP
- .SS "Defines"
- .in +1c
- .ti -1c
- .RI "#define fBROW_MERGE_WAITINGfP 0"
- .br
- .ti -1c
- .RI "#define fBROW_MERGE_ACTIVEfP 1"
- .br
- .ti -1c
- .RI "#define fBROW_MERGE_DONEfP 2"
- .br
- .in -1c
- .SS "Functions"
- .in +1c
- .ti -1c
- .RI "fBnetsnmp_mib_handlerfP * fBnetsnmp_get_row_merge_handlerfP (int prefix_len)"
- .br
- .RI "fIreturns a row_merge handler that can be injected into a given handler chain. fP"
- .ti -1c
- .RI "int fBnetsnmp_register_row_mergefP (fBnetsnmp_handler_registrationfP *reginfo)"
- .br
- .RI "fIfunctionally the same as calling fBnetsnmp_register_handler()fP but also injects a row_merge handler at the same time for you. fP"
- .ti -1c
- .RI "int fBnetsnmp_row_merge_helper_handlerfP (fBnetsnmp_mib_handlerfP *handler, fBnetsnmp_handler_registrationfP *reginfo, fBnetsnmp_agent_request_infofP *reqinfo, fBnetsnmp_request_infofP *requests)"
- .br
- .RI "fIImplements the row_merge handler. fP"
- .ti -1c
- .RI "void fBnetsnmp_init_row_mergefP (void)"
- .br
- .RI "fIinitializes the row_merge helper which then registers a row_merge handler as a run-time injectable handler for configuration file use. fP"
- .in -1c
- .SH "Detailed Description"
- .PP
- 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.
- .PP
- 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.
- .SH "Function Documentation"
- .PP
- .SS "fBnetsnmp_mib_handlerfP* netsnmp_get_row_merge_handler (int prefix_len)"
- .PP
- returns a row_merge handler that can be injected into a given handler chain.
- .PP
- Definition at line 31 of file row_merge.c.
- .PP
- References netsnmp_mib_handler_s::myvoid, netsnmp_create_handler(), netsnmp_row_merge_helper_handler(), and NULL.
- .PP
- Referenced by netsnmp_init_row_merge(), and netsnmp_register_row_merge().
- .SS "void netsnmp_init_row_merge (void)"
- .PP
- initializes the row_merge helper which then registers a row_merge handler as a run-time injectable handler for configuration file use.
- .PP
- Definition at line 197 of file row_merge.c.
- .PP
- References netsnmp_get_row_merge_handler(), and netsnmp_register_handler_by_name().
- .SS "int netsnmp_register_row_merge (fBnetsnmp_handler_registrationfP * reginfo)"
- .PP
- functionally the same as calling fBnetsnmp_register_handler()fP but also injects a row_merge handler at the same time for you.
- .PP
- Definition at line 45 of file row_merge.c.
- .PP
- References netsnmp_get_row_merge_handler(), netsnmp_inject_handler(), netsnmp_register_handler(), and netsnmp_handler_registration_s::rootoid_len.
- .SS "int netsnmp_row_merge_helper_handler (fBnetsnmp_mib_handlerfP * handler, fBnetsnmp_handler_registrationfP * reginfo, fBnetsnmp_agent_request_infofP * reqinfo, fBnetsnmp_request_infofP * requests)"
- .PP
- Implements the row_merge handler.
- .PP
- Definition at line 58 of file row_merge.c.
- .PP
- References netsnmp_mib_handler_s::myvoid, variable_list::name, variable_list::name_length, netsnmp_call_next_handler(), netsnmp_request_info_s::next, NULL, netsnmp_request_info_s::processed, netsnmp_request_info_s::requestvb, netsnmp_handler_registration_s::rootoid, netsnmp_handler_registration_s::rootoid_len, ROW_MERGE_ACTIVE, ROW_MERGE_DONE, ROW_MERGE_WAITING, and snmp_oid_compare().
- .PP
- Referenced by netsnmp_get_row_merge_handler().