netsnmp_row_merge.3
上传用户:wxp200602
上传日期:2007-10-30
资源大小:4028k
文件大小:4k
源码类别:

SNMP编程

开发平台:

Unix_Linux

  1. .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 -*-
  2. .ad l
  3. .nh
  4. .SH NAME
  5. 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.  
  6. .PP
  7. .SS "Defines"
  8. .in +1c
  9. .ti -1c
  10. .RI "#define fBROW_MERGE_WAITINGfP   0"
  11. .br
  12. .ti -1c
  13. .RI "#define fBROW_MERGE_ACTIVEfP   1"
  14. .br
  15. .ti -1c
  16. .RI "#define fBROW_MERGE_DONEfP   2"
  17. .br
  18. .in -1c
  19. .SS "Functions"
  20. .in +1c
  21. .ti -1c
  22. .RI "fBnetsnmp_mib_handlerfP * fBnetsnmp_get_row_merge_handlerfP (int prefix_len)"
  23. .br
  24. .RI "fIreturns a row_merge handler that can be injected into a given handler chain. fP"
  25. .ti -1c
  26. .RI "int fBnetsnmp_register_row_mergefP (fBnetsnmp_handler_registrationfP *reginfo)"
  27. .br
  28. .RI "fIfunctionally the same as calling fBnetsnmp_register_handler()fP but also injects a row_merge handler at the same time for you. fP"
  29. .ti -1c
  30. .RI "int fBnetsnmp_row_merge_helper_handlerfP (fBnetsnmp_mib_handlerfP *handler, fBnetsnmp_handler_registrationfP *reginfo, fBnetsnmp_agent_request_infofP *reqinfo, fBnetsnmp_request_infofP *requests)"
  31. .br
  32. .RI "fIImplements the row_merge handler. fP"
  33. .ti -1c
  34. .RI "void fBnetsnmp_init_row_mergefP (void)"
  35. .br
  36. .RI "fIinitializes the row_merge helper which then registers a row_merge handler as a run-time injectable handler for configuration file use. fP"
  37. .in -1c
  38. .SH "Detailed Description"
  39. .PP 
  40. 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. 
  41. .PP
  42. 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.
  43. .SH "Function Documentation"
  44. .PP 
  45. .SS "fBnetsnmp_mib_handlerfP* netsnmp_get_row_merge_handler (int prefix_len)"
  46. .PP
  47. returns a row_merge handler that can be injected into a given handler chain. 
  48. .PP
  49. Definition at line 31 of file row_merge.c.
  50. .PP
  51. References netsnmp_mib_handler_s::myvoid, netsnmp_create_handler(), netsnmp_row_merge_helper_handler(), and NULL.
  52. .PP
  53. Referenced by netsnmp_init_row_merge(), and netsnmp_register_row_merge().
  54. .SS "void netsnmp_init_row_merge (void)"
  55. .PP
  56. initializes the row_merge helper which then registers a row_merge handler as a run-time injectable handler for configuration file use. 
  57. .PP
  58. Definition at line 197 of file row_merge.c.
  59. .PP
  60. References netsnmp_get_row_merge_handler(), and netsnmp_register_handler_by_name().
  61. .SS "int netsnmp_register_row_merge (fBnetsnmp_handler_registrationfP * reginfo)"
  62. .PP
  63. functionally the same as calling fBnetsnmp_register_handler()fP but also injects a row_merge handler at the same time for you. 
  64. .PP
  65. Definition at line 45 of file row_merge.c.
  66. .PP
  67. References netsnmp_get_row_merge_handler(), netsnmp_inject_handler(), netsnmp_register_handler(), and netsnmp_handler_registration_s::rootoid_len.
  68. .SS "int netsnmp_row_merge_helper_handler (fBnetsnmp_mib_handlerfP * handler, fBnetsnmp_handler_registrationfP * reginfo, fBnetsnmp_agent_request_infofP * reqinfo, fBnetsnmp_request_infofP * requests)"
  69. .PP
  70. Implements the row_merge handler. 
  71. .PP
  72. Definition at line 58 of file row_merge.c.
  73. .PP
  74. 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().
  75. .PP
  76. Referenced by netsnmp_get_row_merge_handler().