|
Packit |
2fc92b |
.\"
|
|
Packit |
2fc92b |
.\" snmp.conf man page for CUPS.
|
|
Packit |
2fc92b |
.\"
|
|
Packit |
2fc92b |
.\" Copyright 2007-2014 by Apple Inc.
|
|
Packit |
2fc92b |
.\" Copyright 2006 by Easy Software Products.
|
|
Packit |
2fc92b |
.\"
|
|
Packit |
2fc92b |
.\" These coded instructions, statements, and computer programs are the
|
|
Packit |
2fc92b |
.\" property of Apple Inc. and are protected by Federal copyright
|
|
Packit |
2fc92b |
.\" law. Distribution and use rights are outlined in the file "LICENSE.txt"
|
|
Packit |
2fc92b |
.\" which should have been included with this file. If this file is
|
|
Packit |
2fc92b |
.\" file is missing or damaged, see the license at "http://www.cups.org/".
|
|
Packit |
2fc92b |
.\"
|
|
Packit |
2fc92b |
.TH snmp.conf 5 "CUPS" "10 June 2014" "Apple Inc."
|
|
Packit |
2fc92b |
.SH NAME
|
|
Packit |
2fc92b |
snmp.conf \- snmp configuration file for cups
|
|
Packit |
2fc92b |
.SH DESCRIPTION
|
|
Packit |
2fc92b |
The
|
|
Packit |
2fc92b |
.B snmp.conf
|
|
Packit |
2fc92b |
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 \fI/etc/cups\fR directory.
|
|
Packit |
2fc92b |
Each line in the file can be a configuration directive, a blank line, or a comment. Comment lines start with the # character.
|
|
Packit |
2fc92b |
.LP
|
|
Packit |
2fc92b |
The Community and DebugLevel directives are used by all backends. The remainder apply only to the SNMP backend -
|
|
Packit |
2fc92b |
.BR cups-snmp (8).
|
|
Packit |
2fc92b |
.SH DIRECTIVES
|
|
Packit |
2fc92b |
The following directives are understood by the CUPS network backends:
|
|
Packit |
2fc92b |
.TP 5
|
|
Packit |
2fc92b |
\fBAddress @IF(\fIname\fB)\fR
|
|
Packit |
2fc92b |
.TP 5
|
|
Packit |
2fc92b |
\fBAddress @LOCAL\fR
|
|
Packit |
2fc92b |
.TP 5
|
|
Packit |
2fc92b |
\fBAddress \fIaddress\fR
|
|
Packit |
2fc92b |
Sends SNMP broadcast queries (for discovery) to the specified address(es).
|
|
Packit |
2fc92b |
There is no default for the broadcast address.
|
|
Packit |
2fc92b |
.TP 5
|
|
Packit |
2fc92b |
\fBCommunity \fIname\fR
|
|
Packit |
2fc92b |
Specifies the community name to use.
|
|
Packit |
2fc92b |
Only a single community name may be specified.
|
|
Packit |
2fc92b |
The default community name is "public".
|
|
Packit |
2fc92b |
.TP 5
|
|
Packit |
2fc92b |
\fBDebugLevel \fInumber\fR
|
|
Packit |
2fc92b |
Specifies the logging level from 0 (none) to 3 (everything).
|
|
Packit |
2fc92b |
Typically only used for debugging (thus the name).
|
|
Packit |
2fc92b |
The default debug level is 0.
|
|
Packit |
2fc92b |
.TP 5
|
|
Packit |
2fc92b |
\fBDeviceURI "\fIregular expression\fB" \fIdevice-uri \fR[... \fIdevice-uri\fR]
|
|
Packit |
2fc92b |
Specifies one or more device URIs that should be used for a given make and model string.
|
|
Packit |
2fc92b |
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.
|
|
Packit |
2fc92b |
There are no default device URI matching rules.
|
|
Packit |
2fc92b |
.TP 5
|
|
Packit |
2fc92b |
\fBHostNameLookups on\fR
|
|
Packit |
2fc92b |
.TP 5
|
|
Packit |
2fc92b |
\fBHostNameLookups off\fR
|
|
Packit |
2fc92b |
Specifies whether the addresses of printers should be converted to hostnames or left as numeric IP addresses.
|
|
Packit |
2fc92b |
The default is "off".
|
|
Packit |
2fc92b |
.TP 5
|
|
Packit |
2fc92b |
\fBMaxRunTime \fIseconds\fR
|
|
Packit |
2fc92b |
Specifies the maximum number of seconds that the SNMP backend will scan the
|
|
Packit |
2fc92b |
network for printers.
|
|
Packit |
2fc92b |
The default is 120 seconds (2 minutes).
|
|
Packit |
2fc92b |
.SH SEE ALSO
|
|
Packit |
2fc92b |
.BR cups-snmp (8),
|
|
Packit |
2fc92b |
CUPS Online Help (http://localhost:631/help)
|
|
Packit |
2fc92b |
.SH COPYRIGHT
|
|
Packit |
2fc92b |
Copyright \[co] 2007-2017 by Apple Inc.
|