]> git.ipfire.org Git - thirdparty/cups.git/blame - doc/help/man-cups-snmp.conf.html
More man page updates.
[thirdparty/cups.git] / doc / help / man-cups-snmp.conf.html
CommitLineData
c277f98c 1<!DOCTYPE HTML>
94436c5a
MS
2<html>
3<!-- SECTION: Man Pages -->
4<head>
5 <link rel="stylesheet" type="text/css" href="../cups-printable.css">
6 <title>snmp.conf(5)</title>
7</head>
8<body>
9<h1 class="title">snmp.conf(5)</h1>
10
11<h2 class="title"><a name="NAME">Name</a></h2>
12snmp.conf - snmp configuration file for cups
13<h2 class="title"><a name="DESCRIPTION">Description</a></h2>
14The <i>snmp.conf</i> file configures how the standard CUPS network backends
15(http, https, ipp, ipps, lpd, snmp, and socket) access printer information using
16SNMPv1 and is normally located in the <i>/etc/cups</i> directory. Each line in
17the file can be a configuration directive, a blank line, or a comment. Comment
18lines start with the # character.
19<p>The Community and DebugLevel directives are used by all backends. The remainder
c277f98c 20apply only to the SNMP backend (<i>cups-snmp(8)</i>).
94436c5a
MS
21<h2 class="title"><a name="DIRECTIVES">Directives</a></h2>
22The following directives are understood by the CUPS network backends. Consult
23the on-line help for detailed descriptions:
c277f98c
MS
24<p style="margin-left: 5.0em; text-indent: -5.0em">Address @IF(<i>name</i>)
25<br>
26<p style="margin-left: 5.0em; text-indent: -5.0em">Address @LOCAL
27<br>
28<p style="margin-left: 5.0em; text-indent: -5.0em">Address <i>address</i>
29<br>
30<br>
31Sends SNMP broadcast queries to the specified address(es). There is no default
94436c5a 32for the broadcast address.
c277f98c
MS
33<p style="margin-left: 5.0em; text-indent: -5.0em">Community <i>name</i>
34<br>
35<br>
36Specifies the community name to use. Only a single community name may be
94436c5a 37specified. The default community name is "public".
c277f98c
MS
38<p style="margin-left: 5.0em; text-indent: -5.0em">DebugLevel number
39<br>
40<br>
41Specifies the logging level from 0 (none) to 3 (everything). Typically only used
94436c5a 42for debugging (thus the name). The default debug level is 0.
c277f98c
MS
43<p style="margin-left: 5.0em; text-indent: -5.0em">DeviceURI "regular expression" device-uri [... device-uri]
44<br>
45<br>
46Specifies one or more device URIs that should be used for a given make and model
94436c5a
MS
47string. The regular expression is used to match the detected make and model, and
48the device URI strings must be of the form "scheme://%s[:port]/[path]", where
49"%s" represents the detected address or hostname. There are no default device
50URI matching rules.
c277f98c
MS
51<p style="margin-left: 5.0em; text-indent: -5.0em">HostNameLookups on
52<br>
53<p style="margin-left: 5.0em; text-indent: -5.0em">HostNameLookups off
54<br>
55<br>
56Specifies whether the addresses of printers should be converted to hostnames or
94436c5a 57left as numeric IP addresses. The default is "off".
c277f98c
MS
58<p style="margin-left: 5.0em; text-indent: -5.0em">MaxRunTime <i>seconds</i>
59<br>
60<br>
61Specifies the maximum number of seconds that the SNMP backend will scan the
94436c5a 62network for printers. The default is 120 seconds (2 minutes).
94436c5a
MS
63<h2 class="title"><a name="SEE_ALSO">See Also</a></h2>
64cups-snmp(8),
65<br>
c277f98c 66<a href="http://localhost:631/help">http://localhost:631/help</a>
94436c5a
MS
67<h2 class="title"><a name="COPYRIGHT">Copyright</a></h2>
68Copyright 2007-2013 by Apple Inc.
69
70</body>
71</html>