/usr/share/cups/doc-root/help/ref-snmp-conf.html is in cups-server-common 1.7.2-0ubuntu1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 | <HTML>
<!-- SECTION: References -->
<HEAD>
<TITLE>snmp.conf</TITLE>
<LINK REL="STYLESHEET" TYPE="text/css" HREF="../cups-printable.css">
</HEAD>
<BODY>
<H1 CLASS="title">snmp.conf</H1>
<P>The <VAR>/etc/cups/snmp.conf</VAR> file contains several
directives that determine how the SNMP printer discovery backend
behaves. Each directive is listed on a line by itself followed
by its value. Comments are introduced using the number sign ("#")
character at the beginning of a line.</P>
<P>The SNMP backend uses the SNMPv1 protocol to discover network
printers, collecting information from the Host MIB along with
intelligent port probes to determine the correct device URI and
make and model for each printer. Future versions of CUPS will
likely support the new Port Monitor MIB as well.</P>
<H2 CLASS="title"><A NAME="Address">Address</A></H2>
<H3>Examples</H3>
<PRE CLASS="command">
Address @LOCAL
Address @IF(name)
Address 255.255.255.255
Address 192.168.2.255
</PRE>
<H3>Description</H3>
<P>The <CODE>Address</CODE> directive specifies a broadcast
address to use when discovering printers. Multiple
<CODE>Address</CODE> lines can be provided to scan different
subnets.</P>
<P>The default address is <VAR>@LOCAL</VAR>, which broadcasts to
all LANs.</P>
<H2 CLASS="title"><A NAME="Community">Community</A></H2>
<H3>Examples</H3>
<PRE CLASS="command">
Community public
Community easysw
Community BigCorp
</PRE>
<H3>Description</H3>
<P>The <CODE>Community</CODE> directive specifies a community
name to use when discovering printers and reporting status and supply
levels for network printers.</P>
<P>The default community is "public".</P>
<H2 CLASS="title"><A NAME="DebugLevel">DebugLevel</A></H2>
<H3>Examples</H3>
<PRE CLASS="command">
DebugLevel 0
DebugLevel 1
DebugLevel 2
DebugLevel 3
</PRE>
<H3>Description</H3>
<P>The <CODE>DebugLevel</CODE> directive specifies the debugging
level to use when searching for network printers. Level 0
produces no debugging information. Level 1 produces basic
debugging information. Level 2 adds printing of the SNMP
messages. Level 3 adds a hex dump of the network data.</P>
<P>The default setting is <VAR>0</VAR>.</P>
<H2 CLASS="title"><A NAME="DeviceURI">DeviceURI</A></H2>
<H3>Examples</H3>
<PRE CLASS="command">
DeviceURI "HP.*JetDirect.*" socket://%s:9100 socket://%s:9101 socket://%s:9102
DeviceURI "HP.*" socket://%s
DeviceURI "Acme.*Laser.*" lpd://%s/print
DeviceURI "Xerox.*"
</PRE>
<H3>Description</H3>
<P>The <CODE>DeviceURI</CODE> directive specifies a regular expression
(enclosed in double quotes) that is matched against the SNMP device
description OID returned by a printer. If the description matches the
regular expression, each device URI that follows the regular expression
is listed by the backend, with any occurrences of <CODE>%s</CODE>
replaced by the device's hostname or IP address. If no URIs are listed,
the device is ignored.</P>
<P>The <CODE>DeviceURI</CODE> directives are processed serially in
the order specified in the <VAR>snmp.conf</VAR> file until a match
is found.</P>
<H2 CLASS="title"><A NAME="HostNameLookups">HostNameLookups</A></H2>
<H3>Examples</H3>
<PRE CLASS="command">
HostNameLookups on
HostNameLookups off
</PRE>
<H3>Description</H3>
<P>The <CODE>HostNameLookups</CODE> directive specifies whether printer
addresses are converted to hostnames or left as numeric IP addresses.</P>
<P>The default setting is <VAR>off</VAR>.</P>
<H2 CLASS="title"><A NAME="MaxRunTime">MaxRunTime</A></H2>
<H3>Examples</H3>
<PRE CLASS="command">
MaxRunTime 10
MaxRunTime 300
</PRE>
<H3>Description</H3>
<P>The <CODE>MaxRunTime</CODE> directive specifies the maximum
number of seconds that the SNMP backend will spend looking for
printer devices on the network.</P>
<P>The default setting is <VAR>10</VAR>.</P>
</BODY>
</HTML>
|