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

SNMP编程

开发平台:

Unix_Linux

  1. .TH "Maintain a registry of MIB subtrees, together with related information regarding mibmodule, sessions, etc" 3 "28 Nov 2005" "Version 5.2.1.rc3" "net-snmp" " -*- nroff -*-
  2. .ad l
  3. .nh
  4. .SH NAME
  5. Maintain a registry of MIB subtrees, together with related information regarding mibmodule, sessions, etc - 
  6. .SS "Data Structures"
  7. .in +1c
  8. .ti -1c
  9. .RI "struct fBlookup_cache_sfP"
  10. .br
  11. .ti -1c
  12. .RI "struct fBlookup_cache_context_sfP"
  13. .br
  14. .in -1c
  15. .SS "Defines"
  16. .in +1c
  17. .ti -1c
  18. .RI "#define fBIN_SNMP_VARS_CfP"
  19. .br
  20. .ti -1c
  21. .RI "#define fBSUBTREE_DEFAULT_CACHE_SIZEfP   8"
  22. .br
  23. .ti -1c
  24. .RI "#define fBSUBTREE_MAX_CACHE_SIZEfP   32"
  25. .br
  26. .in -1c
  27. .SS "Typedefs"
  28. .in +1c
  29. .ti -1c
  30. .RI "typedef fBlookup_cache_sfP fBlookup_cachefP"
  31. .br
  32. .ti -1c
  33. .RI "typedef fBlookup_cache_context_sfP fBlookup_cache_contextfP"
  34. .br
  35. .in -1c
  36. .SS "Functions"
  37. .in +1c
  38. .ti -1c
  39. .RI "NETSNMP_STATIC_INLINE void fBinvalidate_lookup_cachefP (const char *context)"
  40. .br
  41. .ti -1c
  42. .RI "void fBnetsnmp_set_lookup_cache_sizefP (int newsize)"
  43. .br
  44. .RI "fIset the lookup cache size for optimized agent registration performance. fP"
  45. .ti -1c
  46. .RI "int fBnetsnmp_get_lookup_cache_sizefP (void)"
  47. .br
  48. .RI "fIretrieves the current value of the lookup cache size fP"
  49. .ti -1c
  50. .RI "void fBnetsnmp_subtree_freefP (fBnetsnmp_subtreefP *a)"
  51. .br
  52. .ti -1c
  53. .RI "fBnetsnmp_subtreefP * fBnetsnmp_subtree_deepcopyfP (fBnetsnmp_subtreefP *a)"
  54. .br
  55. .ti -1c
  56. .RI "fBsubtree_context_cachefP * fBget_top_context_cachefP (void)"
  57. .br
  58. .ti -1c
  59. .RI "fBnetsnmp_subtreefP * fBnetsnmp_subtree_find_firstfP (const char *context_name)"
  60. .br
  61. .ti -1c
  62. .RI "fBnetsnmp_subtreefP * fBadd_subtreefP (fBnetsnmp_subtreefP *new_tree, const char *context_name)"
  63. .br
  64. .ti -1c
  65. .RI "fBnetsnmp_subtreefP * fBnetsnmp_subtree_replace_firstfP (fBnetsnmp_subtreefP *new_tree, const char *context_name)"
  66. .br
  67. .ti -1c
  68. .RI "int fBnetsnmp_subtree_comparefP (const fBnetsnmp_subtreefP *ap, const fBnetsnmp_subtreefP *bp)"
  69. .br
  70. .ti -1c
  71. .RI "void fBnetsnmp_subtree_joinfP (fBnetsnmp_subtreefP *root)"
  72. .br
  73. .ti -1c
  74. .RI "fBnetsnmp_subtreefP * fBnetsnmp_subtree_splitfP (fBnetsnmp_subtreefP *current, oid name[], int name_len)"
  75. .br
  76. .ti -1c
  77. .RI "int fBnetsnmp_subtree_loadfP (fBnetsnmp_subtreefP *new_sub, const char *context_name)"
  78. .br
  79. .ti -1c
  80. .RI "int fBnetsnmp_register_mibfP (const char *moduleName, struct fBvariablefP *var, size_t varsize, size_t numvars, oid *mibloc, size_t mibloclen, int priority, int range_subid, oid range_ubound, fBnetsnmp_sessionfP *ss, const char *context, int timeout, int flags, fBnetsnmp_handler_registrationfP *reginfo, int perform_callback)"
  81. .br
  82. .ti -1c
  83. .RI "void fBregister_mib_reattachfP (void)"
  84. .br
  85. .ti -1c
  86. .RI "void fBregister_mib_detachfP (void)"
  87. .br
  88. .ti -1c
  89. .RI "int fBregister_mib_contextfP (const char *moduleName, struct fBvariablefP *var, size_t varsize, size_t numvars, oid *mibloc, size_t mibloclen, int priority, int range_subid, oid range_ubound, fBnetsnmp_sessionfP *ss, const char *context, int timeout, int flags)"
  90. .br
  91. .ti -1c
  92. .RI "int fBregister_mib_rangefP (const char *moduleName, struct fBvariablefP *var, size_t varsize, size_t numvars, oid *mibloc, size_t mibloclen, int priority, int range_subid, oid range_ubound, fBnetsnmp_sessionfP *ss)"
  93. .br
  94. .ti -1c
  95. .RI "int fBregister_mib_priorityfP (const char *moduleName, struct fBvariablefP *var, size_t varsize, size_t numvars, oid *mibloc, size_t mibloclen, int priority)"
  96. .br
  97. .ti -1c
  98. .RI "int fBregister_mibfP (const char *moduleName, struct fBvariablefP *var, size_t varsize, size_t numvars, oid *mibloc, size_t mibloclen)"
  99. .br
  100. .ti -1c
  101. .RI "void fBnetsnmp_subtree_unloadfP (fBnetsnmp_subtreefP *sub, fBnetsnmp_subtreefP *prev, const char *context)"
  102. .br
  103. .ti -1c
  104. .RI "int fBunregister_mib_contextfP (oid *name, size_t len, int priority, int range_subid, oid range_ubound, const char *context)"
  105. .br
  106. .RI "fIUnregisters an OID that has an associated context name value. fP"
  107. .ti -1c
  108. .RI "int fBnetsnmp_unregister_mib_table_rowfP (oid *name, size_t len, int priority, int var_subid, oid range_ubound, const char *context)"
  109. .br
  110. .ti -1c
  111. .RI "int fBunregister_mib_rangefP (oid *name, size_t len, int priority, int range_subid, oid range_ubound)"
  112. .br
  113. .ti -1c
  114. .RI "int fBunregister_mib_priorityfP (oid *name, size_t len, int priority)"
  115. .br
  116. .ti -1c
  117. .RI "int fBunregister_mibfP (oid *name, size_t len)"
  118. .br
  119. .ti -1c
  120. .RI "void fBunregister_mibs_by_sessionfP (fBnetsnmp_sessionfP *ss)"
  121. .br
  122. .ti -1c
  123. .RI "int fBin_a_viewfP (oid *name, size_t *namelen, fBnetsnmp_pdufP *pdu, int type)"
  124. .br
  125. .ti -1c
  126. .RI "int fBcheck_accessfP (fBnetsnmp_pdufP *pdu)"
  127. .br
  128. .ti -1c
  129. .RI "int fBnetsnmp_acm_check_subtreefP (fBnetsnmp_pdufP *pdu, oid *name, size_t namelen)"
  130. .br
  131. .RI "fIchecks to see if everything within a given subtree is either: in view, not in view, or possibly both. fP"
  132. .ti -1c
  133. .RI "NETSNMP_STATIC_INLINE fBlookup_cache_contextfP * fBget_context_lookup_cachefP (const char *context)"
  134. .br
  135. .ti -1c
  136. .RI "NETSNMP_STATIC_INLINE void fBlookup_cache_addfP (const char *context, fBnetsnmp_subtreefP *next, fBnetsnmp_subtreefP *previous)"
  137. .br
  138. .ti -1c
  139. .RI "NETSNMP_STATIC_INLINE void fBlookup_cache_replacefP (fBlookup_cachefP *ptr, fBnetsnmp_subtreefP *next, fBnetsnmp_subtreefP *previous)"
  140. .br
  141. .ti -1c
  142. .RI "NETSNMP_STATIC_INLINE fBlookup_cachefP * fBlookup_cache_findfP (const char *context, oid *name, size_t name_len, int *retcmp)"
  143. .br
  144. .ti -1c
  145. .RI "fBnetsnmp_subtreefP * fBnetsnmp_subtree_find_prevfP (oid *name, size_t len, fBnetsnmp_subtreefP *subtree, const char *context_name)"
  146. .br
  147. .ti -1c
  148. .RI "fBnetsnmp_subtreefP * fBnetsnmp_subtree_find_nextfP (oid *name, size_t len, fBnetsnmp_subtreefP *subtree, const char *context_name)"
  149. .br
  150. .ti -1c
  151. .RI "fBnetsnmp_subtreefP * fBnetsnmp_subtree_findfP (oid *name, size_t len, fBnetsnmp_subtreefP *subtree, const char *context_name)"
  152. .br
  153. .ti -1c
  154. .RI "fBnetsnmp_sessionfP * fBget_session_for_oidfP (oid *name, size_t len, const char *context_name)"
  155. .br
  156. .ti -1c
  157. .RI "void fBsetup_treefP (void)"
  158. .br
  159. .ti -1c
  160. .RI "int fBremove_tree_entryfP (oid *name, size_t len)"
  161. .br
  162. .ti -1c
  163. .RI "void fBshutdown_treefP (void)"
  164. .br
  165. .ti -1c
  166. .RI "void fBclear_subtreefP (fBnetsnmp_subtreefP *sub)"
  167. .br
  168. .ti -1c
  169. .RI "void fBclear_lookup_cachefP (void)"
  170. .br
  171. .ti -1c
  172. .RI "void fBclear_contextfP (void)"
  173. .br
  174. .ti -1c
  175. .RI "void fBdump_idx_registryfP (void)"
  176. .br
  177. .ti -1c
  178. .RI "void fBdump_registryfP (void)"
  179. .br
  180. .ti -1c
  181. .RI "int fBregister_readfdfP (int fd, void(*func)(int, void *), void *data)"
  182. .br
  183. .ti -1c
  184. .RI "int fBregister_writefdfP (int fd, void(*func)(int, void *), void *data)"
  185. .br
  186. .ti -1c
  187. .RI "int fBregister_exceptfdfP (int fd, void(*func)(int, void *), void *data)"
  188. .br
  189. .ti -1c
  190. .RI "int fBunregister_readfdfP (int fd)"
  191. .br
  192. .ti -1c
  193. .RI "int fBunregister_writefdfP (int fd)"
  194. .br
  195. .ti -1c
  196. .RI "int fBunregister_exceptfdfP (int fd)"
  197. .br
  198. .ti -1c
  199. .RI "RETSIGTYPE fBagent_SIGCHLD_handlerfP (int sig)"
  200. .br
  201. .ti -1c
  202. .RI "int fBregister_signalfP (int sig, void(*func)(int))"
  203. .br
  204. .ti -1c
  205. .RI "int fBunregister_signalfP (int sig)"
  206. .br
  207. .in -1c
  208. .SS "Variables"
  209. .in +1c
  210. .ti -1c
  211. .RI "fBsubtree_context_cachefP * fBcontext_subtreesfP = NULL"
  212. .br
  213. .ti -1c
  214. .RI "int fBlookup_cache_sizefP = 0"
  215. .br
  216. .ti -1c
  217. .RI "fBnetsnmp_subtreefP * fBlookup_cache_s::previousfP"
  218. .br
  219. .ti -1c
  220. .RI "fBlookup_cache_context_sfP * fBlookup_cache_context_s::nextfP"
  221. .br
  222. .ti -1c
  223. .RI "int fBlookup_cache_context_s::thecachecountfP"
  224. .br
  225. .ti -1c
  226. .RI "int fBlookup_cache_context_s::currentposfP"
  227. .br
  228. .ti -1c
  229. .RI "fBlookup_cachefP fBlookup_cache_context_s::cachefP [SUBTREE_MAX_CACHE_SIZE]"
  230. .br
  231. .ti -1c
  232. .RI "int fBexternal_readfdfP [NUM_EXTERNAL_FDS]"
  233. .br
  234. .ti -1c
  235. .RI "int fBexternal_readfdlenfP = 0"
  236. .br
  237. .ti -1c
  238. .RI "int fBexternal_writefdfP [NUM_EXTERNAL_FDS]"
  239. .br
  240. .ti -1c
  241. .RI "int fBexternal_writefdlenfP = 0"
  242. .br
  243. .ti -1c
  244. .RI "int fBexternal_exceptfdfP [NUM_EXTERNAL_FDS]"
  245. .br
  246. .ti -1c
  247. .RI "int fBexternal_exceptfdlenfP = 0"
  248. .br
  249. .ti -1c
  250. .RI "void(* fBexternal_readfdfuncfP [NUM_EXTERNAL_FDS])(int, void *)"
  251. .br
  252. .ti -1c
  253. .RI "void(* fBexternal_writefdfuncfP [NUM_EXTERNAL_FDS])(int, void *)"
  254. .br
  255. .ti -1c
  256. .RI "void(* fBexternal_exceptfdfuncfP [NUM_EXTERNAL_FDS])(int, void *)"
  257. .br
  258. .ti -1c
  259. .RI "void * fBexternal_readfd_datafP [NUM_EXTERNAL_FDS]"
  260. .br
  261. .ti -1c
  262. .RI "void * fBexternal_writefd_datafP [NUM_EXTERNAL_FDS]"
  263. .br
  264. .ti -1c
  265. .RI "void * fBexternal_exceptfd_datafP [NUM_EXTERNAL_FDS]"
  266. .br
  267. .ti -1c
  268. .RI "int fBexternal_signal_scheduledfP [NUM_EXTERNAL_SIGS]"
  269. .br
  270. .ti -1c
  271. .RI "void(* fBexternal_signal_handlerfP [NUM_EXTERNAL_SIGS])(int)"
  272. .br
  273. .in -1c
  274. .SH "Function Documentation"
  275. .PP 
  276. .SS "int netsnmp_acm_check_subtree (fBnetsnmp_pdufP * pdu, oid * name, size_t namelen)"
  277. .PP
  278. checks to see if everything within a given subtree is either: in view, not in view, or possibly both. 
  279. .PP
  280. If the entire subtree is not-in-view we can use this information to skip calling the sub-handlers entirely. 
  281. .PP
  282. fBReturns:fP
  283. .RS 4
  284. 0 if entire subtree is accessible, 5 if not and 7 if portions are both. 1 on error (illegal pdu version).
  285. .RE
  286. .PP
  287. .PP
  288. Definition at line 1265 of file agent_registry.c.
  289. .PP
  290. References view_parameters::check_subtree, view_parameters::errorcode, snmp_pdu::flags, view_parameters::name, view_parameters::namelen, view_parameters::pdu, snmp_call_callbacks(), and snmp_pdu::version.
  291. .PP
  292. Referenced by netsnmp_add_varbind_to_cache().
  293. .SS "int netsnmp_get_lookup_cache_size (void)"
  294. .PP
  295. retrieves the current value of the lookup cache size 
  296. .PP
  297. fBReturns:fP
  298. .RS 4
  299. the current lookup cache size
  300. .RE
  301. .PP
  302. .PP
  303. Definition at line 1338 of file agent_registry.c.
  304. .PP
  305. Referenced by netsnmp_register_mib(), and unregister_mib_context().
  306. .SS "void netsnmp_set_lookup_cache_size (int newsize)"
  307. .PP
  308. set the lookup cache size for optimized agent registration performance. 
  309. .PP
  310. fBParameters:fP
  311. .RS 4
  312. fInewsizefP set to the maximum size of a cache for a given context. Set to 0 to completely disable caching, or to -1 to set to the default cache size (8), or to a number of your chosing. The rough guide is that it should be equal to the maximum number of simultanious managers you expect to talk to the agent (M) times 80% (or so, he says randomly) the average number (N) of varbinds you expect to receive in a given request for a manager. ie, M times N. Bigger does NOT necessarily mean better. Certainly 16 should be an upper limit. 32 is the hard coded limit.
  313. .RE
  314. .PP
  315. .PP
  316. Definition at line 1325 of file agent_registry.c.
  317. .PP
  318. References SUBTREE_DEFAULT_CACHE_SIZE, and SUBTREE_MAX_CACHE_SIZE.
  319. .PP
  320. Referenced by init_master_agent(), netsnmp_register_mib(), and unregister_mib_context().
  321. .SS "int unregister_mib_context (oid * name, size_t len, int priority, int range_subid, oid range_ubound, const char * context)"
  322. .PP
  323. Unregisters an OID that has an associated context name value. 
  324. .PP
  325. Typically used when a module has multiple contexts defined. The parameters priority, range_subid, and range_ubound should be used in conjunction with agentx, see RFC 2741, otherwise these values should always be 0.
  326. .PP
  327. fBParameters:fP
  328. .RS 4
  329. fInamefP the specific OID to unregister if it conatins the associated context.
  330. .br
  331. fIlenfP the length of the OID, use OID_LENGTH macro.
  332. .br
  333. fIpriorityfP a value between 1 and 255, used to achieve a desired configuration when different sessions register identical or overlapping regions. Subagents with no particular knowledge of priority should register with the default value of 127.
  334. .br
  335. fIrange_subidfP permits specifying a range in place of one of a subtree sub-identifiers. When this value is zero, no range is being specified.
  336. .br
  337. fIrange_uboundfP the upper bound of a sub-identifier's range. This field is present only if range_subid is not 0.
  338. .br
  339. fIcontextfP a context name that has been created
  340. .RE
  341. .PP
  342. fBReturns:fP
  343. .RS 4
  344. .RE
  345. .PP
  346. .PP
  347. Definition at line 937 of file agent_registry.c.
  348. .PP
  349. References netsnmp_subtree_s::children, invalidate_lookup_cache(), netsnmp_subtree_s::name_a, netsnmp_subtree_s::namelen, netsnmp_get_lookup_cache_size(), netsnmp_oid_equals(), netsnmp_set_lookup_cache_size(), netsnmp_subtree_find(), netsnmp_subtree_find_first(), netsnmp_subtree_free(), netsnmp_subtree_unload(), netsnmp_subtree_s::next, NULL, netsnmp_subtree_s::priority, and snmp_call_callbacks().
  350. .PP
  351. Referenced by netsnmp_register_mib(), netsnmp_unregister_handler(), remove_tree_entry(), and unregister_mib_range().