projects / thirdparty / cups.git / blame
| Commit | Line | Data |
|---|---|---|
| f3c17241 | 1 | .\" |
| 61515785 | 2 | .\" "$Id: cups-snmp.man.in 11109 2013-07-08 21:15:13Z msweet $" |
| f3c17241 MS |
3 | .\" |
| 4 | .\" SNMP backend man page for CUPS. | |
| 5 | .\" | |
| 0fa6c7fa | 6 | .\" Copyright 2012-2013 by Apple Inc. |
| f3c17241 MS |
7 | .\" |
| 8 | .\" These coded instructions, statements, and computer programs are the | |
| 9 | .\" property of Apple Inc. and are protected by Federal copyright | |
| 10 | .\" law. Distribution and use rights are outlined in the file "LICENSE.txt" | |
| 11 | .\" which should have been included with this file. If this file is | |
| 12 | .\" file is missing or damaged, see the license at "http://www.cups.org/". | |
| 13 | .\" | |
| ffa2ca90 | 14 | .TH cups-snmp 8 "CUPS" "8 July 2013" "Apple Inc." |
| f3c17241 MS |
15 | .SH NAME |
| 16 | snmp \- cups snmp backend | |
| 17 | .SH SYNOPSIS | |
| ffa2ca90 MS |
18 | .B /usr/lib/cups/backend/snmp |
| 19 | .I ip-address-or-hostname | |
| 20 | .br | |
| 21 | .B /usr/libexec/cups/backend/snmp | |
| f3c17241 MS |
22 | .I ip-address-or-hostname |
| 23 | .br | |
| 24 | .B lpinfo -v --include-schemes snmp | |
| 25 | .SH DESCRIPTION | |
| 26 | The CUPS SNMP backend provides legacy discovery and identification of network | |
| 27 | printers using SNMPv1. When used for discovery through the scheduler, the | |
| 28 | backend will list all printers that respond to a broadcast SNMPv1 query with the | |
| 29 | "public" community name. Additional queries are then sent to printers that | |
| 30 | respond in order to determine the correct device URI, make and model, and other | |
| 31 | information needed for printing. | |
| 32 | .LP | |
| 33 | In the first form, the SNMP backend is run directly by the user to look up the | |
| 34 | device URI and other information when you have an IP address or hostname. This | |
| 35 | can be used for programs that need to configure print queues where the user has | |
| 36 | supplied an address but nothing else. | |
| 37 | .LP | |
| 38 | In the second form, the SNMP backend is run indirectly using the \fIlpinfo(8)\fR | |
| 39 | command. The output provides all printers detected via SNMP on the configured | |
| 40 | broadcast addresses. \fBNote\fR: no broadcast addresses are configured by | |
| 41 | default. | |
| 42 | .SH MIBS | |
| 43 | The CUPS SNMP backend uses the information from the Host, Printer, and Port | |
| 44 | Monitor MIBs along with some vendor private MIBs and intelligent port probes to | |
| 45 | determine the correct device URI and make and model for each printer. | |
| 46 | .SH CONFIGURATION | |
| ffa2ca90 | 47 | The SNMP backend reads the /etc/cups/snmp.conf configuration file, if |
| f3c17241 MS |
48 | present, to set the default broadcast address, community name, and logging |
| 49 | level. The configuration file is documented in \fIcups-snmp.conf(5)\fR. The | |
| 50 | DebugLevel value can be overridden using the CUPS_DEBUG_LEVEL environment | |
| 51 | variable and the MaxRunTime value can be overridden using the CUPS_MAX_RUN_TIME | |
| 52 | environment variable. | |
| 53 | .SH SEE ALSO | |
| 54 | \fIbackend(7)\fR, \fIcups-snmp.conf(5)\fR, \fIcupsd(8)\fR, \fIcupsd.conf(5)\fR, | |
| 55 | \fIfilter(7)\fR, \fIlpinfo(8)\fR, | |
| 56 | .br | |
| 57 | http://localhost:631/help | |
| 58 | .SH COPYRIGHT | |
| 0fa6c7fa | 59 | Copyright 2007-2013 by Apple Inc. |
| f3c17241 | 60 | .\" |
| 61515785 | 61 | .\" End of "$Id: cups-snmp.man.in 11109 2013-07-08 21:15:13Z msweet $". |
| f3c17241 | 62 | .\" |