[MAN] cups-snmp

Content-type: text/html; charset=UTF-8

snmp.conf

Section: Apple Inc. (5)
Updated: CUPS
Index Return to Main Contents

---

 

NAME

snmp.conf - snmp configuration file for cups  

DESCRIPTION

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).  

DIRECTIVES

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".

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).

 

SEE ALSO

cups-snmp(8), CUPS Online Help (http://localhost:631/help)  

COPYRIGHT

Copyright © 2007-2017 by Apple Inc.

---

 

Index

NAME

DESCRIPTION

DIRECTIVES

SEE ALSO

COPYRIGHT

---

This document was created by man2html, using the manual pages.
Time: 04:45:55 GMT, September 16, 2022 Content-type: text/html; charset=UTF-8

cups-snmp

Section: Apple Inc. (8)
Updated: CUPS
Index Return to Main Contents

---

 

NAME

snmp - cups snmp backend  

SYNOPSIS

/usr/lib/cups/backend/snmp ip-address-or-hostname
/usr/libexec/cups/backend/snmp ip-address-or-hostname
lpinfo -v --include-schemes snmp  

DESCRIPTION

The CUPS SNMP backend provides legacy discovery and identification of network printers using SNMPv1. 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. 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.

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. This can be used for programs that need to configure print queues where the user has supplied an address but nothing else.

In the second form, the SNMP backend is run indirectly using the lpinfo(8) command. The output provides all printers detected via SNMP on the configured broadcast addresses. Note: no broadcast addresses are configured by default.  

ENVIRONMENT

The DebugLevel value can be overridden using the CUPS_DEBUG_LEVEL environment variable. The MaxRunTime value can be overridden using the CUPS_MAX_RUN_TIME environment variable.  

FILES

The SNMP backend reads the /etc/cups/snmp.conf configuration file, if present, to set the default broadcast address, community name, and logging level.  

CONFORMING TO

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.  

SEE ALSO

backend(7), cups-snmp.conf(5), cupsd(8), lpinfo(8), CUPS Online Help (http://localhost:631/help)  

COPYRIGHT

Copyright © 2007-2017 by Apple Inc.

---

 

Index

NAME

SYNOPSIS

DESCRIPTION

ENVIRONMENT

FILES

CONFORMING TO

SEE ALSO

COPYRIGHT

---

This document was created by man2html, using the manual pages.
Time: 04:46:02 GMT, September 16, 2022