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