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

SNMP编程

开发平台:

Unix_Linux

  1. .TH "scalar: process scalars easily." 3 "28 Nov 2005" "Version 5.2.1.rc3" "net-snmp" " -*- nroff -*-
  2. .ad l
  3. .nh
  4. .SH NAME
  5. scalar: process scalars easily. - 
  6. .SS "Functions"
  7. .in +1c
  8. .ti -1c
  9. .RI "fBnetsnmp_mib_handlerfP * fBnetsnmp_get_scalar_handlerfP (void)"
  10. .br
  11. .RI "fICreates a scalar handler calling netsnmp_create_handler with a handler name defaulted to 'scalar' and access method, netsnmp_scalar_helper_handler. fP"
  12. .ti -1c
  13. .RI "int fBnetsnmp_register_scalarfP (fBnetsnmp_handler_registrationfP *reginfo)"
  14. .br
  15. .RI "fIThis function registers a scalar helper handler. fP"
  16. .ti -1c
  17. .RI "int fBnetsnmp_register_read_only_scalarfP (fBnetsnmp_handler_registrationfP *reginfo)"
  18. .br
  19. .RI "fIThis function registers a read only scalar helper handler. fP"
  20. .ti -1c
  21. .RI "int fBnetsnmp_scalar_helper_handlerfP (fBnetsnmp_mib_handlerfP *handler, fBnetsnmp_handler_registrationfP *reginfo, fBnetsnmp_agent_request_infofP *reqinfo, fBnetsnmp_request_infofP *requests)"
  22. .br
  23. .in -1c
  24. .SH "Function Documentation"
  25. .PP 
  26. .SS "fBnetsnmp_mib_handlerfP* netsnmp_get_scalar_handler (void)"
  27. .PP
  28. Creates a scalar handler calling netsnmp_create_handler with a handler name defaulted to 'scalar' and access method, netsnmp_scalar_helper_handler. 
  29. .PP
  30. fBParameters:fP
  31. .RS 4
  32. fIvoidfP 
  33. .RE
  34. .PP
  35. fBReturns:fP
  36. .RS 4
  37. Returns a pointer to a netsnmp_mib_handler struct which contains the handler's name and the access method
  38. .RE
  39. .PP
  40. fBSee also:fP
  41. .RS 4
  42. fBnetsnmp_get_scalar_handlerfP 
  43. .PP
  44. fBnetsnmp_register_scalarfP
  45. .RE
  46. .PP
  47. .PP
  48. Definition at line 51 of file scalar.c.
  49. .PP
  50. References netsnmp_create_handler(), and netsnmp_scalar_helper_handler().
  51. .PP
  52. Referenced by netsnmp_register_read_only_scalar(), netsnmp_register_scalar(), and netsnmp_register_scalar_group().
  53. .SS "int netsnmp_register_read_only_scalar (fBnetsnmp_handler_registrationfP * reginfo)"
  54. .PP
  55. This function registers a read only scalar helper handler. 
  56. .PP
  57. This function is very similar to netsnmp_register_scalar the only addition is that the 'read_only' handler is injected into the handler chain prior to injecting the serialize handler and registering reginfo.
  58. .PP
  59. fBParameters:fP
  60. .RS 4
  61. fIreginfofP a handler registration structure which could get created using netsnmp_create_handler_registration. Used to register a read only scalar helper handler.
  62. .RE
  63. .PP
  64. fBReturns:fP
  65. .RS 4
  66. MIB_REGISTERED_OK is returned if the registration was a success. Failures are MIB_REGISTRATION_FAILURE and MIB_DUPLICATE_REGISTRATION.
  67. .RE
  68. .PP
  69. fBSee also:fP
  70. .RS 4
  71. fBnetsnmp_register_scalarfP 
  72. .PP
  73. fBnetsnmp_get_scalar_handlerfP
  74. .RE
  75. .PP
  76. .PP
  77. Definition at line 114 of file scalar.c.
  78. .PP
  79. References netsnmp_get_instance_handler(), netsnmp_get_read_only_handler(), netsnmp_get_scalar_handler(), netsnmp_inject_handler(), netsnmp_register_serialize(), netsnmp_handler_registration_s::rootoid, and netsnmp_handler_registration_s::rootoid_len.
  80. .SS "int netsnmp_register_scalar (fBnetsnmp_handler_registrationfP * reginfo)"
  81. .PP
  82. This function registers a scalar helper handler. 
  83. .PP
  84. The registered OID, reginfo->rootoid, space is extended for the instance subid using realloc() but the reginfo->rootoid_len length is not extended just yet. .This function subsequently injects the instance, scalar, and serialize helper handlers before actually registering reginfo.
  85. .PP
  86. Each handler is injected/pushed to the top of the handler chain list and will be processed last in first out, LIFO.
  87. .PP
  88. fBParameters:fP
  89. .RS 4
  90. fIreginfofP a handler registration structure which could get created using netsnmp_create_handler_registration. Used to register a scalar helper handler.
  91. .RE
  92. .PP
  93. fBReturns:fP
  94. .RS 4
  95. MIB_REGISTERED_OK is returned if the registration was a success. Failures are MIB_REGISTRATION_FAILURE and MIB_DUPLICATE_REGISTRATION.
  96. .RE
  97. .PP
  98. fBSee also:fP
  99. .RS 4
  100. fBnetsnmp_register_read_only_scalarfP 
  101. .PP
  102. fBnetsnmp_get_scalar_handlerfP
  103. .RE
  104. .PP
  105. .PP
  106. Definition at line 79 of file scalar.c.
  107. .PP
  108. References netsnmp_get_instance_handler(), netsnmp_get_scalar_handler(), netsnmp_inject_handler(), netsnmp_register_serialize(), netsnmp_handler_registration_s::rootoid, and netsnmp_handler_registration_s::rootoid_len.
  109. .PP
  110. Referenced by netsnmp_register_watched_scalar(), and netsnmp_register_watched_timestamp().