|
NAME | DESCRIPTION | DIRECTIVES | NOTES | SEE ALSO | COPYRIGHT | COLOPHON |
|
|
|
snmp.conf(5) OpenPrinting snmp.conf(5)
snmp.conf - snmp configuration file for cups (deprecated)
The snmp.conf file configures how the standard CUPS network
backends (http, https, ipp, ipps, lpd, snmp, and socket) access
printer information using SNMPv1 and is normally located in the
/etc/cups directory. Each line in the file can be a configuration
directive, a blank line, or a comment. Comment lines start with
the # character.
The Community and DebugLevel directives are used by all backends.
The remainder apply only to the SNMP backend - cups-snmp(8).
The following directives are understood by the CUPS network
backends:
Address @IF(name)
Address @LOCAL
Address address
Sends SNMP broadcast queries (for discovery) to the specified
address(es). There is no default for the broadcast address.
Community name
Specifies the community name to use. Only a single community
name may be specified. The default community name is
"public". If no name is specified, all SNMP functions are
disabled.
DebugLevel number
Specifies the logging level from 0 (none) to 3 (everything).
Typically only used for debugging (thus the name). The
default debug level is 0.
DeviceURI "regular expression" device-uri [... device-uri]
Specifies one or more device URIs that should be used for a
given make and model string. The regular expression is used
to match the detected make and model, and the device URI
strings must be of the form "scheme://%s[:port]/[path]",
where "%s" represents the detected address or hostname.
There are no default device URI matching rules.
HostNameLookups on
HostNameLookups off
Specifies whether the addresses of printers should be
converted to hostnames or left as numeric IP addresses. The
default is "off".
MaxRunTime seconds
Specifies the maximum number of seconds that the SNMP backend
will scan the network for printers. The default is 120
seconds (2 minutes).
CUPS backends are deprecated and will no longer be supported in a
future feature release of CUPS. Printers that do not support IPP
can be supported using applications such as ippeveprinter(1).
cups-snmp(8), CUPS Online Help (http://localhost:631/help)
Copyright © 2020-2024 by OpenPrinting.
This page is part of the CUPS (a standards-based, open source
printing system) project. Information about the project can be
found at ⟨https://github.com/openprinting/cups⟩. If you have a
bug report for this manual page, see
⟨https://github.com/OpenPrinting/cups/issues⟩. This page was
obtained from the project's upstream Git repository
⟨https://github.com/openprinting/cups⟩ on 2025-08-11. (At that
time, the date of the most recent commit that was found in the
repository was 2025-08-07.) If you discover any rendering
problems in this HTML version of the page, or you believe there is
a better or more up-to-date source for the page, or you have
corrections or improvements to the information in this COLOPHON
(which is not part of the original manual page), send a mail to
man-pages@man7.org
2021-02-28 CUPS snmp.conf(5)
Pages that refer to this page: cups-snmp(8)