]> git.ipfire.org Git - thirdparty/cups.git/blob - doc/help/man-cups-snmp.html
Fix a state transition issue that affected ippserver.
[thirdparty/cups.git] / doc / help / man-cups-snmp.html
1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
2 <html>
3 <!-- SECTION: Man Pages -->
4 <head>
5 <link rel="stylesheet" type="text/css" href="../cups-printable.css">
6 <title>cups-snmp(8)</title>
7 </head>
8 <body>
9 <h1 class="title">cups-snmp(8)</h1>
10 <h2 class="title"><a name="NAME">Name</a></h2>
11 snmp - cups snmp backend
12 <h2 class="title"><a name="SYNOPSIS">Synopsis</a></h2>
13 <b>/usr/libexec/cups/backend/snmp
14 </b><i>ip-address-or-hostname
15 </i><br>
16 <b>lpinfo -v --include-schemes snmp
17 </b><h2 class="title"><a name="DESCRIPTION">Description</a></h2>
18 The CUPS SNMP backend provides legacy discovery and identification of network
19 printers using SNMPv1. When used for discovery through the scheduler, the
20 backend will list all printers that respond to a broadcast SNMPv1 query with the
21 "public" community name. Additional queries are then sent to printers that
22 respond in order to determine the correct device URI, make and model, and other
23 information needed for printing.
24 <p>In the first form, the SNMP backend is run directly by the user to look up the
25 device URI and other information when you have an IP address or hostname. This
26 can be used for programs that need to configure print queues where the user has
27 supplied an address but nothing else.
28 <p>In the second form, the SNMP backend is run indirectly using the <a href='man-lpinfo.html?TOPIC=Man+Pages'>lpinfo(8)</a>
29 command. The output provides all printers detected via SNMP on the configured
30 broadcast addresses. <b>Note</b>: no broadcast addresses are configured by
31 default.
32 <h2 class="title"><a name="MIBS">Mibs</a></h2>
33 The CUPS SNMP backend uses the information from the Host, Printer, and Port
34 Monitor MIBs along with some vendor private MIBs and intelligent port probes to
35 determine the correct device URI and make and model for each printer.
36 <h2 class="title"><a name="CONFIGURATION">Configuration</a></h2>
37 The SNMP backend reads the /private/etc/cups/snmp.conf configuration file, if
38 present, to set the default broadcast address, community name, and logging
39 level. The configuration file is documented in <a href='man-cups-snmp.conf.html?TOPIC=Man+Pages'>cups-snmp.conf(5)</a>. The
40 DebugLevel value can be overridden using the CUPS_DEBUG_LEVEL environment
41 variable and the MaxRunTime value can be overridden using the CUPS_MAX_RUN_TIME
42 environment variable.
43 <h2 class="title"><a name="SEE_ALSO">See Also</a></h2>
44 <a href='man-backend.html?TOPIC=Man+Pages'>backend(7)</a>, <a href='man-cups-snmp.conf.html?TOPIC=Man+Pages'>cups-snmp.conf(5)</a>, <a href='man-cupsd.html?TOPIC=Man+Pages'>cupsd(8)</a>, <a href='man-cupsd.conf.html?TOPIC=Man+Pages'>cupsd.conf(5)</a>,
45 <a href='man-filter.html?TOPIC=Man+Pages'>filter(7)</a>, <a href='man-lpinfo.html?TOPIC=Man+Pages'>lpinfo(8)</a>,
46 <br>
47 <a href='http://localhost:631/help'>http://localhost:631/help</a>
48 <h2 class="title"><a name="COPYRIGHT">Copyright</a></h2>
49 Copyright 2007-2013 by Apple Inc.
50
51 </body>
52 </html>