projects / thirdparty / cups.git / blame
| Commit | Line | Data |
|---|---|---|
| f3c17241 | 1 | .\" |
| ce0ddeb2 | 2 | .\" SNMP backend man page for CUPS. |
| f3c17241 | 3 | .\" |
| 87030afb | 4 | .\" Copyright © 2012-2019 by Apple Inc. |
| f3c17241 | 5 | .\" |
| 3bd38497 MS |
6 | .\" Licensed under Apache License v2.0. See the file "LICENSE" for more |
| 7 | .\" information. | |
| f3c17241 | 8 | .\" |
| 87030afb | 9 | .TH cups-snmp 8 "CUPS" "26 April 2019" "Apple Inc." |
| f3c17241 | 10 | .SH NAME |
| 87030afb | 11 | snmp \- cups snmp backend (deprecated) |
| f3c17241 | 12 | .SH SYNOPSIS |
| ffa2ca90 MS |
13 | .B /usr/lib/cups/backend/snmp |
| 14 | .I ip-address-or-hostname | |
| 15 | .br | |
| 16 | .B /usr/libexec/cups/backend/snmp | |
| f3c17241 MS |
17 | .I ip-address-or-hostname |
| 18 | .br | |
| ce0ddeb2 MS |
19 | .B lpinfo |
| 20 | .B \-v | |
| 21 | .B \-\-include-schemes | |
| 22 | snmp | |
| f3c17241 | 23 | .SH DESCRIPTION |
| 3bd38497 | 24 | The \fBDEPRECATED\fR CUPS SNMP backend provides legacy discovery and identification of network printers using SNMPv1. |
| ce0ddeb2 MS |
25 | When used for discovery through the scheduler, the backend will list all printers that respond to a broadcast SNMPv1 query with the "public" community name. |
| 26 | Additional queries are then sent to printers that respond in order to determine the correct device URI, make and model, and other information needed for printing. | |
| f3c17241 | 27 | .LP |
| ce0ddeb2 MS |
28 | In the first form, the SNMP backend is run directly by the user to look up the device URI and other information when you have an IP address or hostname. |
| 29 | This can be used for programs that need to configure print queues where the user has supplied an address but nothing else. | |
| f3c17241 | 30 | .LP |
| ce0ddeb2 MS |
31 | In the second form, the SNMP backend is run indirectly using the |
| 32 | .BR lpinfo (8) | |
| 33 | command. | |
| 34 | The output provides all printers detected via SNMP on the configured | |
| 35 | broadcast addresses. | |
| 36 | \fINote: no broadcast addresses are configured by default.\fR | |
| 37 | .SH ENVIRONMENT | |
| 38 | The DebugLevel value can be overridden using the CUPS_DEBUG_LEVEL environment variable. | |
| 39 | The MaxRunTime value can be overridden using the CUPS_MAX_RUN_TIME environment variable. | |
| 40 | .SH FILES | |
| 41 | The SNMP backend reads the \fI/etc/cups/snmp.conf\fR configuration file, if | |
| f3c17241 | 42 | present, to set the default broadcast address, community name, and logging |
| ce0ddeb2 | 43 | level. |
| 3bd38497 MS |
44 | .SH NOTES |
| 45 | The CUPS SNMP backend is deprecated and will no longer be supported in a future | |
| 46 | version of CUPS. | |
| ce0ddeb2 MS |
47 | .SH CONFORMING TO |
| 48 | The CUPS SNMP backend uses the information from the Host, Printer, and Port Monitor MIBs along with some vendor private MIBs and intelligent port probes to determine the correct device URI and make and model for each printer. | |
| f3c17241 | 49 | .SH SEE ALSO |
| ce0ddeb2 MS |
50 | .BR backend (7), |
| 51 | .BR cups-snmp.conf (5), | |
| 52 | .BR cupsd (8), | |
| 53 | .BR lpinfo (8), | |
| 54 | CUPS Online Help (http://localhost:631/help) | |
| f3c17241 | 55 | .SH COPYRIGHT |
| 87030afb | 56 | Copyright \[co] 2007-2019 by Apple Inc. |