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

SNMP编程

开发平台:

Unix_Linux

  1. .TH "snmp_pdu" 3 "28 Nov 2005" "Version 5.2.1.rc3" "net-snmp" " -*- nroff -*-
  2. .ad l
  3. .nh
  4. .SH NAME
  5. snmp_pdu - The snmp protocol data unit.  
  6. .PP
  7. .SH SYNOPSIS
  8. .br
  9. .PP
  10. fC#include <snmp_api.h>fP
  11. .PP
  12. .SS "Data Fields"
  13. .in +1c
  14. .ti -1c
  15. .RI "long fBversionfP"
  16. .br
  17. .RI "fIsnmp version fP"
  18. .ti -1c
  19. .RI "int fBcommandfP"
  20. .br
  21. .RI "fIType of this PDU. fP"
  22. .ti -1c
  23. .RI "long fBreqidfP"
  24. .br
  25. .RI "fIRequest id - note: not incremented on retries. fP"
  26. .ti -1c
  27. .RI "long fBmsgidfP"
  28. .br
  29. .RI "fIMessage id for V3 messages note: incremented for each retry. fP"
  30. .ti -1c
  31. .RI "long fBtransidfP"
  32. .br
  33. .RI "fIUnique ID for incoming transactions. fP"
  34. .ti -1c
  35. .RI "long fBsessidfP"
  36. .br
  37. .RI "fISession id for AgentX messages. fP"
  38. .ti -1c
  39. .RI "long fBerrstatfP"
  40. .br
  41. .RI "fIError status (non_repeaters in GetBulk). fP"
  42. .ti -1c
  43. .RI "long fBerrindexfP"
  44. .br
  45. .RI "fIError index (max_repetitions in GetBulk). fP"
  46. .ti -1c
  47. .RI "u_long fBtimefP"
  48. .br
  49. .RI "fIUptime. fP"
  50. .ti -1c
  51. .RI "u_long fBflagsfP"
  52. .br
  53. .ti -1c
  54. .RI "int fBsecurityModelfP"
  55. .br
  56. .ti -1c
  57. .RI "int fBsecurityLevelfP"
  58. .br
  59. .RI "fInoAuthNoPriv, authNoPriv, authPriv fP"
  60. .ti -1c
  61. .RI "int fBmsgParseModelfP"
  62. .br
  63. .ti -1c
  64. .RI "void * fBtransport_datafP"
  65. .br
  66. .RI "fITransport-specific opaque data. fP"
  67. .ti -1c
  68. .RI "int fBtransport_data_lengthfP"
  69. .br
  70. .ti -1c
  71. .RI "const oid * fBtDomainfP"
  72. .br
  73. .RI "fIThe actual transport domain. fP"
  74. .ti -1c
  75. .RI "size_t fBtDomainLenfP"
  76. .br
  77. .ti -1c
  78. .RI "fBnetsnmp_variable_listfP * fBvariablesfP"
  79. .br
  80. .ti -1c
  81. .RI "u_char * fBcommunityfP"
  82. .br
  83. .RI "fIcommunity for outgoing requests. fP"
  84. .ti -1c
  85. .RI "size_t fBcommunity_lenfP"
  86. .br
  87. .RI "fIlength of community name. fP"
  88. .ti -1c
  89. .RI "oid * fBenterprisefP"
  90. .br
  91. .RI "fISystem OID. fP"
  92. .ti -1c
  93. .RI "size_t fBenterprise_lengthfP"
  94. .br
  95. .ti -1c
  96. .RI "long fBtrap_typefP"
  97. .br
  98. .RI "fItrap type fP"
  99. .ti -1c
  100. .RI "long fBspecific_typefP"
  101. .br
  102. .RI "fIspecific type fP"
  103. .ti -1c
  104. .RI "unsigned char fBagent_addrfP [4]"
  105. .br
  106. .RI "fIThis is ONLY used for v1 TRAPs. fP"
  107. .ti -1c
  108. .RI "u_char * fBcontextEngineIDfP"
  109. .br
  110. .RI "fIcontext snmpEngineID fP"
  111. .ti -1c
  112. .RI "size_t fBcontextEngineIDLenfP"
  113. .br
  114. .RI "fILength of contextEngineID. fP"
  115. .ti -1c
  116. .RI "char * fBcontextNamefP"
  117. .br
  118. .RI "fIauthoritative contextName fP"
  119. .ti -1c
  120. .RI "size_t fBcontextNameLenfP"
  121. .br
  122. .RI "fILength of contextName. fP"
  123. .ti -1c
  124. .RI "u_char * fBsecurityEngineIDfP"
  125. .br
  126. .RI "fIauthoritative snmpEngineID for security fP"
  127. .ti -1c
  128. .RI "size_t fBsecurityEngineIDLenfP"
  129. .br
  130. .RI "fILength of securityEngineID. fP"
  131. .ti -1c
  132. .RI "char * fBsecurityNamefP"
  133. .br
  134. .RI "fIon behalf of this principal fP"
  135. .ti -1c
  136. .RI "size_t fBsecurityNameLenfP"
  137. .br
  138. .RI "fILength of securityName. fP"
  139. .ti -1c
  140. .RI "int fBpriorityfP"
  141. .br
  142. .ti -1c
  143. .RI "int fBrange_subidfP"
  144. .br
  145. .ti -1c
  146. .RI "void * fBsecurityStateReffP"
  147. .br
  148. .in -1c
  149. .SH "Detailed Description"
  150. .PP 
  151. The snmp protocol data unit. 
  152. .PP
  153. Definition at line 75 of file snmp_api.h.
  154. .SH "Field Documentation"
  155. .PP 
  156. .SS "unsigned char fBsnmp_pdu::agent_addrfP[4]"
  157. .PP
  158. This is ONLY used for v1 TRAPs. 
  159. .PP
  160. Definition at line 142 of file snmp_api.h.
  161. .PP
  162. Referenced by convert_v1pdu_to_v2(), convert_v2pdu_to_v1(), netsnmp_send_traps(), snmp_pdu_build(), and snmp_pdu_parse().
  163. .SS "int fBsnmp_pdu::commandfP"
  164. .PP
  165. Type of this PDU. 
  166. .PP
  167. Definition at line 83 of file snmp_api.h.
  168. .PP
  169. Referenced by convert_v1pdu_to_v2(), convert_v2pdu_to_v1(), handle_pdu(), handle_snmp_packet(), netsnmp_add_varbind_to_cache(), netsnmp_agent_check_parse(), netsnmp_check_outstanding_agent_requests(), netsnmp_create_subtree_cache(), netsnmp_handle_request(), netsnmp_send_traps(), netsnmp_wrap_up_request(), save_set_cache(), send_trap_to_sess(), snmp_fix_pdu(), snmp_pdu_build(), snmp_pdu_create(), snmp_pdu_parse(), snmpv3_make_report(), and snmpv3_scopedPDU_parse().
  170. .SS "u_char* fBsnmp_pdu::communityfP"
  171. .PP
  172. community for outgoing requests. 
  173. .PP
  174. Definition at line 127 of file snmp_api.h.
  175. .PP
  176. Referenced by convert_v1pdu_to_v2(), and snmp_free_pdu().
  177. .SS "size_t fBsnmp_pdu::community_lenfP"
  178. .PP
  179. length of community name. 
  180. .PP
  181. Definition at line 129 of file snmp_api.h.
  182. .PP
  183. Referenced by convert_v1pdu_to_v2().
  184. .SS "u_char* fBsnmp_pdu::contextEngineIDfP"
  185. .PP
  186. context snmpEngineID 
  187. .PP
  188. Definition at line 148 of file snmp_api.h.
  189. .PP
  190. Referenced by snmp_free_pdu(), snmpv3_make_report(), snmpv3_parse(), and snmpv3_scopedPDU_parse().
  191. .SS "size_t fBsnmp_pdu::contextEngineIDLenfP"
  192. .PP
  193. Length of contextEngineID. 
  194. .PP
  195. Definition at line 150 of file snmp_api.h.
  196. .PP
  197. Referenced by snmpv3_make_report(), snmpv3_parse(), and snmpv3_scopedPDU_parse().
  198. .SS "char* fBsnmp_pdu::contextNamefP"
  199. .PP
  200. authoritative contextName 
  201. .PP
  202. Definition at line 152 of file snmp_api.h.
  203. .PP
  204. Referenced by netsnmp_create_subtree_cache(), snmp_free_pdu(), snmpv3_make_report(), and snmpv3_scopedPDU_parse().
  205. .SS "size_t fBsnmp_pdu::contextNameLenfP"
  206. .PP
  207. Length of contextName. 
  208. .PP
  209. Definition at line 154 of file snmp_api.h.
  210. .PP
  211. Referenced by snmp_pdu_create(), snmpv3_make_report(), and snmpv3_scopedPDU_parse().
  212. .SS "oid* fBsnmp_pdu::enterprisefP"
  213. .PP
  214. System OID. 
  215. .PP
  216. Definition at line 135 of file snmp_api.h.
  217. .PP
  218. Referenced by convert_v1pdu_to_v2(), convert_v2pdu_to_v1(), netsnmp_send_traps(), snmp_free_pdu(), snmp_pdu_build(), and snmp_pdu_parse().
  219. .SS "long fBsnmp_pdu::errindexfP"
  220. .PP
  221. Error index (max_repetitions in GetBulk). 
  222. .PP
  223. Definition at line 95 of file snmp_api.h.
  224. .PP
  225. Referenced by _reorder_getbulk(), netsnmp_agent_check_parse(), netsnmp_create_subtree_cache(), netsnmp_wrap_up_request(), snmp_fix_pdu(), snmp_pdu_build(), snmp_pdu_create(), snmp_pdu_parse(), and snmpv3_make_report().
  226. .SS "long fBsnmp_pdu::errstatfP"
  227. .PP
  228. Error status (non_repeaters in GetBulk). 
  229. .PP
  230. Definition at line 93 of file snmp_api.h.
  231. .PP
  232. Referenced by _reorder_getbulk(), handle_snmp_packet(), netsnmp_agent_check_parse(), netsnmp_create_subtree_cache(), netsnmp_wrap_up_request(), snmp_fix_pdu(), snmp_pdu_build(), snmp_pdu_create(), snmp_pdu_parse(), and snmpv3_make_report().
  233. .SS "long fBsnmp_pdu::msgidfP"
  234. .PP
  235. Message id for V3 messages note: incremented for each retry. 
  236. .PP
  237. Definition at line 87 of file snmp_api.h.
  238. .PP
  239. Referenced by snmp_fix_pdu(), snmp_pdu_create(), and snmpv3_parse().
  240. .SS "long fBsnmp_pdu::reqidfP"
  241. .PP
  242. Request id - note: not incremented on retries. 
  243. .PP
  244. Definition at line 85 of file snmp_api.h.
  245. .PP
  246. Referenced by snmp_fix_pdu(), snmp_pdu_build(), snmp_pdu_create(), and snmp_pdu_parse().
  247. .SS "u_char* fBsnmp_pdu::securityEngineIDfP"
  248. .PP
  249. authoritative snmpEngineID for security 
  250. .PP
  251. Definition at line 156 of file snmp_api.h.
  252. .PP
  253. Referenced by snmp_free_pdu(), snmpv3_make_report(), snmpv3_packet_build(), snmpv3_parse(), and snmpv3_scopedPDU_parse().
  254. .SS "size_t fBsnmp_pdu::securityEngineIDLenfP"
  255. .PP
  256. Length of securityEngineID. 
  257. .PP
  258. Definition at line 158 of file snmp_api.h.
  259. .PP
  260. Referenced by snmpv3_make_report(), snmpv3_packet_build(), snmpv3_parse(), and snmpv3_scopedPDU_parse().
  261. .SS "int fBsnmp_pdu::securityLevelfP"
  262. .PP
  263. noAuthNoPriv, authNoPriv, authPriv 
  264. .PP
  265. Definition at line 102 of file snmp_api.h.
  266. .PP
  267. Referenced by snmpv3_make_report(), snmpv3_packet_build(), and snmpv3_parse().
  268. .SS "char* fBsnmp_pdu::securityNamefP"
  269. .PP
  270. on behalf of this principal 
  271. .PP
  272. Definition at line 160 of file snmp_api.h.
  273. .PP
  274. Referenced by snmp_free_pdu(), snmpv3_packet_build(), and snmpv3_parse().
  275. .SS "size_t fBsnmp_pdu::securityNameLenfP"
  276. .PP
  277. Length of securityName. 
  278. .PP
  279. Definition at line 162 of file snmp_api.h.
  280. .PP
  281. Referenced by snmp_pdu_create(), snmpv3_packet_build(), and snmpv3_parse().
  282. .SS "long fBsnmp_pdu::sessidfP"
  283. .PP
  284. Session id for AgentX messages. 
  285. .PP
  286. Definition at line 91 of file snmp_api.h.
  287. .PP
  288. Referenced by send_trap_to_sess().
  289. .SS "long fBsnmp_pdu::specific_typefP"
  290. .PP
  291. specific type 
  292. .PP
  293. Definition at line 140 of file snmp_api.h.
  294. .PP
  295. Referenced by convert_v1pdu_to_v2(), convert_v2pdu_to_v1(), netsnmp_send_traps(), snmp_pdu_build(), and snmp_pdu_parse().
  296. .SS "const oid* fBsnmp_pdu::tDomainfP"
  297. .PP
  298. The actual transport domain. 
  299. .PP
  300. This SHOULD NOT BE FREE()D.
  301. .PP
  302. Definition at line 117 of file snmp_api.h.
  303. .PP
  304. Referenced by snmp_create_sess_pdu().
  305. .SS "u_long fBsnmp_pdu::timefP"
  306. .PP
  307. Uptime. 
  308. .PP
  309. Definition at line 97 of file snmp_api.h.
  310. .PP
  311. Referenced by convert_v1pdu_to_v2(), convert_v2pdu_to_v1(), netsnmp_send_traps(), snmp_pdu_build(), snmp_pdu_create(), and snmp_pdu_parse().
  312. .SS "long fBsnmp_pdu::transidfP"
  313. .PP
  314. Unique ID for incoming transactions. 
  315. .PP
  316. Definition at line 89 of file snmp_api.h.
  317. .PP
  318. Referenced by check_delayed_request(), get_set_cache(), netsnmp_check_transaction_id(), netsnmp_create_delegated_cache(), and save_set_cache().
  319. .SS "void* fBsnmp_pdu::transport_datafP"
  320. .PP
  321. Transport-specific opaque data. 
  322. .PP
  323. This replaces the IP-centric address field.
  324. .PP
  325. Definition at line 110 of file snmp_api.h.
  326. .PP
  327. Referenced by snmp_create_sess_pdu(), snmp_free_pdu(), and snmp_pdu_create().
  328. .SS "long fBsnmp_pdu::trap_typefP"
  329. .PP
  330. trap type 
  331. .PP
  332. Definition at line 138 of file snmp_api.h.
  333. .PP
  334. Referenced by convert_v1pdu_to_v2(), convert_v2pdu_to_v1(), netsnmp_send_traps(), snmp_pdu_build(), and snmp_pdu_parse().
  335. .SS "long fBsnmp_pdu::versionfP"
  336. .PP
  337. snmp version 
  338. .PP
  339. Definition at line 81 of file snmp_api.h.
  340. .PP
  341. Referenced by check_access(), handle_snmp_packet(), in_a_view(), netsnmp_acm_check_subtree(), netsnmp_wrap_up_request(), send_trap_to_sess(), snmp_pdu_create(), and snmpv3_parse().
  342. .SH "Author"
  343. .PP 
  344. Generated automatically by Doxygen for net-snmp from the source code.