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

SNMP编程

开发平台:

Unix_Linux

  1. /*
  2.  *  Host Resources 'wrapper' interface
  3.  * calls the per-group interfaces from 'hr_*.h'
  4.  */
  5. config_require(host/hr_system)
  6. config_require(host/hr_storage)
  7. config_require(host/hr_device)
  8. config_require(host/hr_other)
  9. config_require(host/hr_proc)
  10. config_require(host/hr_network)
  11. config_require(host/hr_print)
  12. config_require(host/hr_disk)
  13. config_require(host/hr_partition)
  14. config_require(host/hr_filesys)
  15. config_require(host/hr_swrun)
  16. config_require(host/hr_swinst)
  17. /* add the host resources mib to the default mibs to load */
  18. config_add_mib(HOST-RESOURCES-MIB)
  19. config_add_mib(HOST-RESOURCES-TYPES)
  20. /*********************************************
  21.  *
  22.  *   A few words about the design of the Host Resources
  23.  *     implementation - particularly as regards the hrDevice
  24.  *     group and hrDeviceIndex.  This (and hrStorageIndex) make 
  25.  *     use of the non-consecutive nature of SNMP instance identifiers.
  26.  *
  27.  *   hrDeviceIndex is structured in a 'major/minor' form,
  28.  *     with the high end indicating the type of device
  29.  *     (following the enumerations of hrDeviceType) and the low
  30.  *     end being used to differentiate between devices of that type.
  31.  *
  32.  *   The implementation of walking through the available devices
  33.  *     uses a pair of arrays of functions - indexed by hrDeviceType
  34.  *     These are used to perform any initialisation needed for that
  35.  *     type of device, and to step through the instances of that type. 
  36.  *   This latter 'get_next' routing returns the hrDeviceIndex (including
  37.  *     the hrDeviceType major number), or -1 if there are no further
  38.  *     instances of that type.
  39.  *   When all devices of a particular type have been processed, the
  40.  *     initialisation function for the next device type is called,
  41.  *     and so on until all devices have been proceesed.
  42.  *   
  43.  *   Similar arrays are used to provide type-specific functions to
  44.  *     return the "common" device information (description, ID, status
  45.  *     and error count), and to save any internal structures needed
  46.  *     to provide these.
  47.  *   A final array is used to indicate whether hrDeviceIndexes are
  48.  *     returned in a random order, or strictly increasing.  In the
  49.  *     latter case, this allows the search for a particular index to
  50.  *     terminate as soon as the 'next' device is reached, without needing
  51.  *     to check the rest of them.  Similarly, once a particular type of
  52.  *     device has been scanned, further types will not be examined unless
  53.  *     a suitable index has not yet been found.
  54.  *
  55.  *   The index used for hrFSIndex is also used as hrStorageIndex,
  56.  *     for those storage areas corresponding to filestore.
  57.  *     Additional storage areas (such as memory or swap space) are
  58.  *     distinguished by index values greater than a defined constant.
  59.  *     Currently these are individually defined entries, but other
  60.  *     ranges could be implemented similarly.
  61.  *   If hrFSIndex was re-implemented to reflect internal identifiers,
  62.  *     it would be possible to reverse the sense of the current
  63.  *     implementation, with non-filestore storage having indices
  64.  *     less than a defined constant, rather than greater.
  65.  *
  66.  *
  67.  *   Much of the detailed implementation of this group (as opposed to
  68.  *     the implementation infrastructure outlined about) is likely to
  69.  *     be very system-specific.
  70.  *   The initial implementation (for HP-UX 9 and Linux) should be
  71.  *     regarded as a 'proof of concept' example, rather than as
  72.  *     finished, releasable code.  This particularly hold for the
  73.  *     disk device discovery code, which is gross in the extreme,
  74.  *     and should never have seen the light of day!
  75.  *   Hopefully this can be ripped out and given a quiet burial as
  76.  *     soon as is decently possible.  
  77.  *
  78.  *   Now it's up to the rest of you to hammer this into some sort of
  79.  *     sensible shape.
  80.  *                                Dave Shield
  81.  *   
  82.  *********************************************/