NAME | DESCRIPTION | DIRECTIVES | SEE ALSO | COPYRIGHT | COLOPHON

snmp.conf(5)                     Apple Inc.                     snmp.conf(5)

NAME         top

       snmp.conf - snmp configuration file for cups

DESCRIPTION         top

       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         top

       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         top

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

COPYRIGHT         top

       Copyright © 2007-2017 by Apple Inc.

COLOPHON         top

       This page is part of the CUPS (a standards-based, open source
       printing system) project.  Information about the project can be found
       at ⟨http://www.cups.org/⟩.  If you have a bug report for this manual
       page, see ⟨http://www.cups.org/⟩.  This page was obtained from the
       project's upstream Git repository ⟨https://github.com/apple/cups⟩ on
       2017-03-13.  If you discover any rendering problems in this HTML ver‐
       sion 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 man‐
       ual page), send a mail to man-pages@man7.org

10 June 2014                        CUPS                        snmp.conf(5)