man-pages/man5/cups-snmp.conf.5.html
2021-03-31 01:06:50 +01:00

94 lines
3.7 KiB
HTML

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<HTML><HEAD><TITLE>Man page of snmp.conf</TITLE>
</HEAD><BODY>
<H1>snmp.conf</H1>
Section: Apple Inc. (5)<BR>Updated: CUPS<BR><A HREF="#index">Index</A>
<A HREF="/cgi-bin/man/man2html">Return to Main Contents</A><HR>
<A NAME="lbAB">&nbsp;</A>
<H2>NAME</H2>
snmp.conf - snmp configuration file for cups (deprecated)
<A NAME="lbAC">&nbsp;</A>
<H2>DESCRIPTION</H2>
The
<B>snmp.conf</B>
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 <I>/etc/cups</I> directory.
Each line in the file can be a configuration directive, a blank line, or a comment. Comment lines start with the # character.
<P>
The Community and DebugLevel directives are used by all backends. The remainder apply only to the SNMP backend -
<B><A HREF="/cgi-bin/man/man2html?8+cups-snmp">cups-snmp</A></B>(8).
<A NAME="lbAD">&nbsp;</A>
<H2>DIRECTIVES</H2>
The following directives are understood by the CUPS network backends:
<DL COMPACT>
<DT id="1"><B>Address @IF(</B><I>name</I><B>)</B><DD>
<DT id="2"><B>Address @LOCAL</B><DD>
<DT id="3"><B>Address </B><I>address</I><DD>
Sends SNMP broadcast queries (for discovery) to the specified address(es).
There is no default for the broadcast address.
<DT id="4"><B>Community </B><I>name</I><DD>
Specifies the community name to use.
Only a single community name may be specified.
The default community name is &quot;public&quot;.
If no name is specified, all SNMP functions are disabled.
<DT id="5"><B>DebugLevel </B><I>number</I><DD>
Specifies the logging level from 0 (none) to 3 (everything).
Typically only used for debugging (thus the name).
The default debug level is 0.
<DT id="6"><B>DeviceURI &quot;</B><I>regular expression</I><B>&quot; </B><I>device-uri </I>[... <I>device-uri</I>]<DD>
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 &quot;<A HREF="scheme://%s[:port]/[path]">scheme://%s[:port]/[path]</A>&quot;, where &quot;%s&quot; represents the detected address or hostname.
There are no default device URI matching rules.
<DT id="7"><B>HostNameLookups on</B><DD>
<DT id="8"><B>HostNameLookups off</B><DD>
Specifies whether the addresses of printers should be converted to hostnames or left as numeric IP addresses.
The default is &quot;off&quot;.
<DT id="9"><B>MaxRunTime </B><I>seconds</I><DD>
Specifies the maximum number of seconds that the SNMP backend will scan the
network for printers.
The default is 120 seconds (2 minutes).
</DL>
<A NAME="lbAE">&nbsp;</A>
<H2>NOTES</H2>
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
<B><A HREF="/cgi-bin/man/man2html?1+ippeveprinter">ippeveprinter</A></B>(1).
<A NAME="lbAF">&nbsp;</A>
<H2>SEE ALSO</H2>
<B><A HREF="/cgi-bin/man/man2html?8+cups-snmp">cups-snmp</A></B>(8),
CUPS Online Help (<A HREF="http://localhost:631/help)">http://localhost:631/help)</A>
<A NAME="lbAG">&nbsp;</A>
<H2>COPYRIGHT</H2>
Copyright &#169; 2007-2019 by Apple Inc.
<P>
<HR>
<A NAME="index">&nbsp;</A><H2>Index</H2>
<DL>
<DT id="10"><A HREF="#lbAB">NAME</A><DD>
<DT id="11"><A HREF="#lbAC">DESCRIPTION</A><DD>
<DT id="12"><A HREF="#lbAD">DIRECTIVES</A><DD>
<DT id="13"><A HREF="#lbAE">NOTES</A><DD>
<DT id="14"><A HREF="#lbAF">SEE ALSO</A><DD>
<DT id="15"><A HREF="#lbAG">COPYRIGHT</A><DD>
</DL>
<HR>
This document was created by
<A HREF="/cgi-bin/man/man2html">man2html</A>,
using the manual pages.<BR>
Time: 00:06:02 GMT, March 31, 2021
</BODY>
</HTML>