snmp.conf.5.def
上传用户:wxp200602
上传日期:2007-10-30
资源大小:4028k
文件大小:8k
源码类别:

SNMP编程

开发平台:

Unix_Linux

  1. .TH SNMP.CONF 5 "29 Jun 2005" VVERSIONINFO "Net-SNMP"
  2. .UC 4
  3. .SH NAME
  4. snmp.conf - configuration files for the Net-SNMP applications
  5. .SH DESCRIPTION
  6. .B snmp.conf
  7. is the configuration file which define how the Net-SNMP applications
  8. operate.  Tokens that can be put in them are described in the
  9. .B DIRECTIVES
  10. section below.
  11. .PP
  12. SYSCONFDIR/snmp/snmp.conf is a common file, shared by all users of the system.
  13. .br
  14. ~/.snmp/snmp.conf is a personal file, with configuration settings for a
  15. particular user.
  16. .SH PLEASE READ FIRST
  17. Make sure you make these files readable only by the user if you are
  18. storing sensitive information in them like passphrases!
  19. .PP
  20. First, make sure you have read the
  21. .I snmp_config(5)
  22. manual page that describes how the Net-SNMP configuration files
  23. operate, where they are located and how they all work together.
  24. .SH DIRECTIVES
  25. .IP "mibdirs (mib-dirs|+mib-dirs)"
  26. Look for textual MIBs to parse in the list of ':' separated
  27. directories.  If the directive value starts with a '+' it prepends
  28. this list to the front of the default directory list compiled into the
  29. application.  Note that this value can be overridden by the
  30. .B MIBDIRS
  31. environment variable.
  32. .IP "mibs (mib-tokens|+mib-tokens)"
  33. Specifies a ':' separated list of MIB tokens that represent textual
  34. MIB files that should be found and parsed.  If the directive value
  35. starts with a '+' it prepends this list to the front of the default
  36. MIB token list compiled into the application.  The special keyword of
  37. "ALL" forces all MIBs files found to be read. Note that the value
  38. specified here can be overridden by the
  39. .B MIBS
  40. environment variable.
  41. .IP "mibfile file"
  42. Specifies a textual MIB file to read and parse, in addition to the
  43. list read from the MIBs token.  Note that the value specified here can
  44. be overridden by the
  45. .B MIBFILES
  46. environment variable.
  47. .IP "persistentDir directory"
  48. The directory where snmpd and snmptrapd stores their persistent data
  49. files.
  50. .IP "tempFilePattern pattern"
  51. The file pattern used by snmptrapd to create temporary files.  Example:
  52. /tmp/snmpdXXXXXX.  Used by mkstemp() and mktemp() functions.
  53. .IP "clientaddr [<transport-specifier>:]<transport-address>"
  54. Specify source address used by command-line tools, see
  55. .I snmpcmd(1)
  56. , and by snmpd when sending notifications.
  57. .IP "defaultPort port"
  58. The default port number that all SNMP applications and daemons should use.
  59. .IP "defVersion (1|2c|3)"
  60. The default SNMP version to use.
  61. .IP "defCommunity string"
  62. The default SNMPv1 and SNMPv2c community string to use.
  63. .IP "defSecurityModel string"
  64. The SNMP security model to use. Defaults to "usm" which is the only widely 
  65. used security model for SNMPv3.
  66. .IP "defSecurityName string"
  67. The default SNMPv3 USM security name you want to use for SNMPv3 requests.
  68. .IP "defContext string"
  69. The default SNMPv3 context name you want to use.
  70. .IP "defPassphrase string"
  71. .IP "defAuthPassphrase string"
  72. .IP "defPrivPassphrase string"
  73. The default SNMPv3 USM passphrase(s) to use.  
  74. .B defPassphrase
  75. will be used for both authentication and privacy pass phrases if it is 
  76. specified.
  77. .IP "defAuthType MD5|SHA"
  78. The SNMPv3 USM authentication type to use.
  79. .IP "defPrivType DES|AES"
  80. The SNMPv3 USM privacy type to use.
  81. .IP "defSecurityLevel noAuthNoPriv|authNoPriv|authPriv"
  82. The SNMPv3 default security level to use.
  83. .IP "defAuthMasterKey 0xHEXSTRING"
  84. .IP "defPrivMasterKey 0xHEXSTRING"
  85. .IP "defAuthLocalizedKey 0xHEXSTRING"
  86. .IP "defPrivLocalizedKey 0xHEXSTRING"
  87. Defines the SNMPv3 keys to be used for SNMPv3 secure communications.
  88. SNMPv3 keys are frequently derived from a passphrase, as discussed in
  89. the defPassphrase section above, however for improved security a
  90. truely random key can be generated and used instead (which would
  91. normally has better entropy than a password unless your password is
  92. amazingly long).  But to do this, you need to specify the hexadecimal
  93. keys directly to be used for authentication and encryption.  These
  94. tokens let you do just that.  They are equivalent to the short-form
  95. command line arguments -3m, -3M, -3k, and -3K.  Localized keys are
  96. master keys which have been converted to a unique key which is only
  97. suitable for on particular SNMP engine (agent).  The length of the key
  98. needs to be appropriate for the authentication or encryption type
  99. being used (auth keys: MD5=16 bytes, SHA1=20 bytes, DES=16 bytes (8
  100. bytes of which is used as an IV and not a key), and AES=16 bytes).
  101. .IP "showMibErrors (1|yes|true|0|no|false)"
  102. Whether or not to display textual MIB parsing errors when commands are
  103. run.
  104. .IP "strictCommentTerm (1|yes|true|0|no|false)"
  105. Whether or not MIBs that are parsed should be strict about comment
  106. termination.  "--" terminates a comment if this is true.  Many
  107. MIBs have broken comments in them, hence this option.
  108. .IP "mibAllowUnderline (1|yes|true|0|no|false)"
  109. Allow underline characters in MIBs (illegal).
  110. .IP "mibWarningLevel integerValue"
  111. The minimum warning level of the warnings printed by the MIB parser.
  112. .IP "logTimestamp (1|yes|true|0|no|false)"
  113. Whether the commands should log timestamps with their error/message
  114. logging or not.  Note that output will not look as pretty with
  115. timestamps if the source code that is doing the logging does
  116. incremental logging of messages that are not line buffered before
  117. being passed to the logging routines.  This option is only used when file logging is active. 
  118. .IP "printNumericEnums (1|yes|true|0|no|false)"
  119. Equivalent to
  120. .BR -Oe .
  121. .IP "printNumericOids (1|yes|true|0|no|false)"
  122. Equivalent to
  123. .BR -On .
  124. .IP "dontBreakdownOids (1|yes|true|0|no|false)"
  125. Equivalent to
  126. .BR -Ob .
  127. .IP "escapeQuotes (1|yes|true|0|no|false)"
  128. Equivalent to
  129. .BR -OE .
  130. .IP "quickPrinting (1|yes|true|0|no|false)"
  131. Equivalent to
  132. .BR -Oq .
  133. .IP "printValueOnly (1|yes|true|0|no|false)"
  134. Equivalent to
  135. .BR -Ov .
  136. .IP "dontPrintUnits (1|yes|true|0|no|false)"
  137. Equivalent to
  138. .BR -OU .
  139. .IP "numericTimeticks (1|yes|true|0|no|false)"
  140. Equivalent to
  141. .BR -Ot .
  142. .IP "printHexText (1|yes|true|0|no|false)"
  143. Equivalent to
  144. .BR -OT .
  145. .IP "hexOutputLength integer"
  146. Specifies where to break up the output of hexadecimal strings.  
  147. Set to 0 to disable line breaks.  Defaults to 16.
  148. .IP "suffixPrinting (0|1|2)"
  149. If the value is 1, its equivalent to
  150. .B -Os
  151. and if the value is 2 it's equivalent to
  152. .BR -OS .
  153. .IP "oidOutputFormat (1|2|3|4|5|6)"
  154. Maps -O options as follow: -Os=1, -OS=2, -Of=3, -On=4, -Ou=5.
  155. The value 6 has no matching -O option. It suppresses output.
  156. .IP "extendedIndex (1|yes|true|0|no|false)"
  157. Equivalent to
  158. .BR -OX .
  159. .IP "noRangeCheck (1|yes|true|0|no|false)"
  160. Disables the validation of values that is done by
  161. .B snmpset
  162. before issuing the request to the agent.
  163. Equivalent to
  164. .BR -Ir .
  165. .IP "noDisplayHint (1|yes|true|0|no|false)"
  166. Disables the use of DISPLAY-HINT information when parsing indices and
  167. values to set. Equivalent to
  168. .BR -Ih .
  169. .IP "dumpPacket (1|yes|true|0|no|false)"
  170. Whether the commands should dump packets by default.
  171. .IP "doDebugging (1|0)"
  172. Turns on debugging for all applications run if set to 1.
  173. .IP "debugTokens TOKEN[,TOKEN...]"
  174. The debugging tokens that should be printed.  See the
  175. .I snmpcmd(1)
  176. manual page for debugging usage details.
  177. .IP "serverRecvBuf integer"
  178. .B serverRecvBuf
  179. is used to specify the receive buffer size (in bytes)
  180. for the initialization of server sockets (eg. snmpd, snmptrapd).
  181. If the OS hard limit is smaller than
  182. .B serverRecvBuf
  183. the resulting buffer will be lowered so it is close to the hard limit.  
  184. Some platforms may decide to increment the actual buffersize themselves 
  185. for internal housekeeping.
  186. This directive will be ignored on platforms that don't support
  187. ..I setsockopt()
  188. .IP "serverSendBuf integer"
  189. Similar to serverRecvBuf, but this directive applies to the send 
  190. buffer of server sockets. 
  191. .IP "clientRecvBuf integer"
  192. Similar to serverRecvBuf, but this directive applies to the receive 
  193. buffer of client sockets (eg. snmpget). 
  194. .IP "clientSendBuf integer"
  195. Similar to serverRecvBuf, but this directive applies to the send 
  196. buffer of client sockets. 
  197. .IP "reverseEncodeBER (1|yes|true|0|no|false)"
  198. Encode packets from back to front. Defaults to true. You'll rarely want to
  199. change that.
  200. .IP "16bitIDs (1|yes|true|0|no|false)"
  201. Restrict requestIDs, etc to 16-bit values.
  202. .IP "noTokenWarnings"
  203. Do not warn about unknown config file tokens.
  204. .SH FILES
  205. SYSCONFDIR/snmp/snmp.conf,
  206. SYSCONFDIR/snmp/snmp.conf.local - common configuration settings
  207. ~/.snmp/snmp.conf - user-specific configuration settings
  208. .SH "SEE ALSO"
  209. snmp_config(5), read_config(3), snmpcmd(1).
  210. ." Local Variables:
  211. ."  mode: nroff
  212. ." End: