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

SNMP编程

开发平台:

Unix_Linux

  1. .TH "stash_cache: automatically caches data for certain handlers." 3 "28 Nov 2005" "Version 5.2.1.rc3" "net-snmp" " -*- nroff -*-
  2. .ad l
  3. .nh
  4. .SH NAME
  5. stash_cache: automatically caches data for certain handlers. - This handler caches data in an optimized way which may aleviate the need for the lower level handlers to perform as much optimization.  
  6. .PP
  7. .SS "Functions"
  8. .in +1c
  9. .ti -1c
  10. .RI "fBnetsnmp_stash_cache_infofP * fBnetsnmp_get_new_stash_cachefP (void)"
  11. .br
  12. .ti -1c
  13. .RI "fBnetsnmp_mib_handlerfP * fBnetsnmp_get_stash_cache_handlerfP (void)"
  14. .br
  15. .RI "fIreturns a stash_cache handler that can be injected into a given handler chain. fP"
  16. .ti -1c
  17. .RI "fBnetsnmp_oid_stash_nodefP ** fBnetsnmp_extract_stash_cachefP (fBnetsnmp_agent_request_infofP *reqinfo)"
  18. .br
  19. .RI "fIextracts a pointer to the stash_cache info from the reqinfo structure. fP"
  20. .ti -1c
  21. .RI "int fBnetsnmp_stash_cache_helperfP (fBnetsnmp_mib_handlerfP *handler, fBnetsnmp_handler_registrationfP *reginfo, fBnetsnmp_agent_request_infofP *reqinfo, fBnetsnmp_request_infofP *requests)"
  22. .br
  23. .ti -1c
  24. .RI "int fBnetsnmp_stash_cache_updatefP (fBnetsnmp_mib_handlerfP *handler, fBnetsnmp_handler_registrationfP *reginfo, fBnetsnmp_agent_request_infofP *reqinfo, fBnetsnmp_request_infofP *requests, fBnetsnmp_stash_cache_infofP *cinfo)"
  25. .br
  26. .RI "fIupdates a given cache depending on whether it needs to or not. fP"
  27. .ti -1c
  28. .RI "void fBnetsnmp_init_stash_cache_helperfP (void)"
  29. .br
  30. .RI "fIinitializes the stash_cache helper which then registers a stash_cache handler as a run-time injectable handler for configuration file use. fP"
  31. .in -1c
  32. .SH "Detailed Description"
  33. .PP 
  34. This handler caches data in an optimized way which may aleviate the need for the lower level handlers to perform as much optimization. 
  35. .PP
  36. Specifically, somewhere in the lower level handlers must be a handler that supports the MODE_GET_STASH operation. Note that the table_iterator helper supports this.
  37. .SH "Function Documentation"
  38. .PP 
  39. .SS "fBnetsnmp_oid_stash_nodefP** netsnmp_extract_stash_cache (fBnetsnmp_agent_request_infofP * reqinfo)"
  40. .PP
  41. extracts a pointer to the stash_cache info from the reqinfo structure. 
  42. .PP
  43. Definition at line 64 of file stash_cache.c.
  44. .PP
  45. References netsnmp_agent_get_list_data().
  46. .PP
  47. Referenced by netsnmp_table_iterator_helper_handler().
  48. .SS "fBnetsnmp_mib_handlerfP* netsnmp_get_stash_cache_handler (void)"
  49. .PP
  50. returns a stash_cache handler that can be injected into a given handler chain. 
  51. .PP
  52. Definition at line 42 of file stash_cache.c.
  53. .PP
  54. References netsnmp_mib_handler_s::myvoid, netsnmp_create_handler(), netsnmp_get_new_stash_cache(), netsnmp_stash_cache_helper(), and NULL.
  55. .PP
  56. Referenced by netsnmp_init_stash_cache_helper().
  57. .SS "void netsnmp_init_stash_cache_helper (void)"
  58. .PP
  59. initializes the stash_cache helper which then registers a stash_cache handler as a run-time injectable handler for configuration file use. 
  60. .PP
  61. Definition at line 188 of file stash_cache.c.
  62. .PP
  63. References netsnmp_get_stash_cache_handler(), and netsnmp_register_handler_by_name().
  64. .PP
  65. Referenced by netsnmp_init_helpers().
  66. .SS "int netsnmp_stash_cache_update (fBnetsnmp_mib_handlerfP * handler, fBnetsnmp_handler_registrationfP * reginfo, fBnetsnmp_agent_request_infofP * reqinfo, fBnetsnmp_request_infofP * requests, fBnetsnmp_stash_cache_infofP * cinfo)"
  67. .PP
  68. updates a given cache depending on whether it needs to or not. 
  69. .PP
  70. Definition at line 143 of file stash_cache.c.
  71. .PP
  72. References atime_newMarker(), atime_ready(), atime_setMarker(), netsnmp_stash_cache_info_s::cache, netsnmp_stash_cache_info_s::cache_length, netsnmp_stash_cache_info_s::cache_time, netsnmp_agent_request_info_s::mode, netsnmp_agent_add_list_data(), netsnmp_call_next_handler(), netsnmp_create_data_list(), netsnmp_oid_stash_free(), NULL, and snmp_free_var().
  73. .PP
  74. Referenced by netsnmp_stash_cache_helper().