Go to main content

man pages section 5: File Formats

Exit Print View

Updated: Wednesday, February 9, 2022

cups-snmp.conf (5)


cups-snmp.conf - snmp configuration file for cups (deprecated)


Please see following description for synopsis


snmp.conf(5)                      Apple Inc.                      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 informa-
       tion  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).  Typ-
            ically 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 min-

       See attributes(7) for descriptions of the following attributes:

       |Availability   | print/cups       |
       |Stability      | Volatile         |

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

       Source  code  for open source software components in Oracle Solaris can
       be found at https://www.oracle.com/downloads/opensource/solaris-source-

       This     software     was    built    from    source    available    at
       https://github.com/oracle/solaris-userland.   The  original   community
       source    was    downloaded   from    https://github.com/apple/cups/ar-

       Further information about this software can be found on the open source
       community website at http://www.cups.org/.

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

       Copyright (C) 2007-2019 by Apple Inc.

26 April 2019                        CUPS                         snmp.conf(5)