doc/help/man-cups-snmp.conf.html

   1 <!DOCTYPE HTML>
   2 <html>
   3 <!-- SECTION: Man Pages -->
   4 <head>
   5         <link rel="stylesheet" type="text/css" href="../cups-printable.css">
   6         <title>snmp.conf(5)</title>
   7 </head>
   8 <body>
   9 <h1 class="title">snmp.conf(5)</h1>
  10
  11 <h2 class="title"><a name="NAME">Name</a></h2>
  12 snmp.conf - snmp configuration file for cups
  13 <h2 class="title"><a name="DESCRIPTION">Description</a></h2>
  14 The <i>snmp.conf</i> file configures how the standard CUPS network backends
  15 (http, https, ipp, ipps, lpd, snmp, and socket) access printer information using
  16 SNMPv1 and is normally located in the <i>/etc/cups</i> directory. Each line in
  17 the file can be a configuration directive, a blank line, or a comment. Comment
  18 lines start with the # character.
  19 <p>The Community and DebugLevel directives are used by all backends. The remainder
  20 apply only to the SNMP backend (<i>cups-snmp(8)</i>).
  21 <h2 class="title"><a name="DIRECTIVES">Directives</a></h2>
  22 The following directives are understood by the CUPS network backends. Consult
  23 the on-line help for detailed descriptions:
  24 <p style="margin-left: 5.0em; text-indent: -5.0em">Address @IF(<i>name</i>)
  25 <br>
  26 <p style="margin-left: 5.0em; text-indent: -5.0em">Address @LOCAL
  27 <br>
  28 <p style="margin-left: 5.0em; text-indent: -5.0em">Address <i>address</i>
  29 <br>
  30 <br>
  31 Sends SNMP broadcast queries to the specified address(es). There is no default
  32 for the broadcast address.
  33 <p style="margin-left: 5.0em; text-indent: -5.0em">Community <i>name</i>
  34 <br>
  35 <br>
  36 Specifies the community name to use. Only a single community name may be
  37 specified. The default community name is "public".
  38 <p style="margin-left: 5.0em; text-indent: -5.0em">DebugLevel number
  39 <br>
  40 <br>
  41 Specifies the logging level from 0 (none) to 3 (everything). Typically only used
  42 for debugging (thus the name). The default debug level is 0.
  43 <p style="margin-left: 5.0em; text-indent: -5.0em">DeviceURI "regular expression" device-uri [... device-uri]
  44 <br>
  45 <br>
  46 Specifies one or more device URIs that should be used for a given make and model
  47 string. The regular expression is used to match the detected make and model, and
  48 the device URI strings must be of the form "scheme://%s[:port]/[path]", where
  49 "%s" represents the detected address or hostname. There are no default device
  50 URI matching rules.
  51 <p style="margin-left: 5.0em; text-indent: -5.0em">HostNameLookups on
  52 <br>
  53 <p style="margin-left: 5.0em; text-indent: -5.0em">HostNameLookups off
  54 <br>
  55 <br>
  56 Specifies whether the addresses of printers should be converted to hostnames or
  57 left as numeric IP addresses. The default is "off".
  58 <p style="margin-left: 5.0em; text-indent: -5.0em">MaxRunTime <i>seconds</i>
  59 <br>
  60 <br>
  61 Specifies the maximum number of seconds that the SNMP backend will scan the
  62 network for printers. The default is 120 seconds (2 minutes).
  63 <h2 class="title"><a name="SEE_ALSO">See Also</a></h2>
  64 cups-snmp(8),
  65 <br>
  66 <a href="http://localhost:631/help">http://localhost:631/help</a>
  67 <h2 class="title"><a name="COPYRIGHT">Copyright</a></h2>
  68 Copyright 2007-2013 by Apple Inc.
  69
  70 </body>
  71 </html>