]> git.ipfire.org Git - thirdparty/cups.git/blame - doc/help/man-cups-snmp.html
Initial work on man page modernization (STR #4372)
[thirdparty/cups.git] / doc / help / man-cups-snmp.html
CommitLineData
c277f98c 1<!DOCTYPE HTML>
94436c5a
MS
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>
11snmp - cups snmp backend
12<h2 class="title"><a name="SYNOPSIS">Synopsis</a></h2>
c277f98c
MS
13<b>/usr/lib/cups/backend/snmp</b>
14<i>ip-address-or-hostname</i>
15<br>
16<b>/usr/libexec/cups/backend/snmp</b>
17<i>ip-address-or-hostname</i>
18<br>
19<b>lpinfo</b> <b>-v</b> <b>--include-schemes</b> <b>snmp</b>
20<h2 class="title"><a name="DESCRIPTION">Description</a></h2>
94436c5a
MS
21The CUPS SNMP backend provides legacy discovery and identification of network
22printers using SNMPv1. When used for discovery through the scheduler, the
23backend will list all printers that respond to a broadcast SNMPv1 query with the
24"public" community name. Additional queries are then sent to printers that
25respond in order to determine the correct device URI, make and model, and other
26information needed for printing.
27<p>In the first form, the SNMP backend is run directly by the user to look up the
28device URI and other information when you have an IP address or hostname. This
29can be used for programs that need to configure print queues where the user has
30supplied an address but nothing else.
c277f98c 31<p>In the second form, the SNMP backend is run indirectly using the <i>lpinfo(8)</i>
94436c5a
MS
32command. The output provides all printers detected via SNMP on the configured
33broadcast addresses. <b>Note</b>: no broadcast addresses are configured by
34default.
35<h2 class="title"><a name="MIBS">Mibs</a></h2>
36The CUPS SNMP backend uses the information from the Host, Printer, and Port
37Monitor MIBs along with some vendor private MIBs and intelligent port probes to
38determine the correct device URI and make and model for each printer.
39<h2 class="title"><a name="CONFIGURATION">Configuration</a></h2>
ffa2ca90 40The SNMP backend reads the /etc/cups/snmp.conf configuration file, if
94436c5a 41present, to set the default broadcast address, community name, and logging
c277f98c 42level. The configuration file is documented in <i>cups-snmp.conf(5)</i>. The
94436c5a
MS
43DebugLevel value can be overridden using the CUPS_DEBUG_LEVEL environment
44variable and the MaxRunTime value can be overridden using the CUPS_MAX_RUN_TIME
45environment variable.
46<h2 class="title"><a name="SEE_ALSO">See Also</a></h2>
c277f98c
MS
47<i>backend(7)</i>, <i>cups-snmp.conf(5)</i>, <i>cupsd(8)</i>, <i>cupsd.conf(5)</i>,
48<i>filter(7)</i>, <i>lpinfo(8)</i>,
94436c5a 49<br>
c277f98c 50<a href="http://localhost:631/help">http://localhost:631/help</a>
94436c5a
MS
51<h2 class="title"><a name="COPYRIGHT">Copyright</a></h2>
52Copyright 2007-2013 by Apple Inc.
53
54</body>
55</html>