]> git.ipfire.org Git - thirdparty/cups.git/blame - doc/help/man-cups-snmp.conf.html
Import CUPS v1.7.5
[thirdparty/cups.git] / doc / help / man-cups-snmp.conf.html
CommitLineData
94436c5a
MS
1<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
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
20apply only to the SNMP backend (<a href='man-cups-snmp.html?TOPIC=Man+Pages'>cups-snmp(8)</a>).
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:
24<dl>
25<dt>Address @IF(<i>name</i>)
26</dt>
27<dd></dd>
28<dt>Address @LOCAL
29</dt>
30<dd></dd>
31<dt>Address <i>address</i>
32</dt>
33<dd></dd>
34<dd>Sends SNMP broadcast queries to the specified address(es). There is no default
35for the broadcast address.
36</dd>
37<dt>Community <i>name</i>
38</dt>
39<dd></dd>
40<dd>Specifies the community name to use. Only a single community name may be
41specified. The default community name is "public".
42</dd>
43<dt>DebugLevel number
44</dt>
45<dd></dd>
46<dd>Specifies the logging level from 0 (none) to 3 (everything). Typically only used
47for debugging (thus the name). The default debug level is 0.
48</dd>
49<dt>DeviceURI "regular expression" device-uri [... device-uri]
50</dt>
51<dd></dd>
52<dd>Specifies one or more device URIs that should be used for a given make and model
53string. The regular expression is used to match the detected make and model, and
54the device URI strings must be of the form "scheme://%s[:port]/[path]", where
55"%s" represents the detected address or hostname. There are no default device
56URI matching rules.
57</dd>
58<dt>HostNameLookups on
59</dt>
60<dd></dd>
61<dt>HostNameLookups off
62</dt>
63<dd></dd>
64<dd>Specifies whether the addresses of printers should be converted to hostnames or
65left as numeric IP addresses. The default is "off".
66</dd>
67<dt>MaxRunTime <i>seconds</i>
68</dt>
69<dd></dd>
70<dd>Specifies the maximum number of seconds that the SNMP backend will scan the
71network for printers. The default is 120 seconds (2 minutes).
72</dd>
73</dl>
74<h2 class="title"><a name="SEE_ALSO">See Also</a></h2>
75cups-snmp(8),
76<br>
77<a href='http://localhost:631/help'>http://localhost:631/help</a>
78<h2 class="title"><a name="COPYRIGHT">Copyright</a></h2>
79Copyright 2007-2013 by Apple Inc.
80
81</body>
82</html>