]>
Commit | Line | Data |
---|---|---|
89d46774 | 1 | .\" |
61515785 | 2 | .\" "$Id: cups-snmp.conf.man 11022 2013-06-06 22:14:09Z msweet $" |
89d46774 | 3 | .\" |
321d8d57 | 4 | .\" snmp.conf man page for CUPS. |
89d46774 | 5 | .\" |
0fa6c7fa | 6 | .\" Copyright 2007-2013 by Apple Inc. |
89d46774 | 7 | .\" Copyright 2006 by Easy Software Products. |
8 | .\" | |
9 | .\" These coded instructions, statements, and computer programs are the | |
bc44d920 | 10 | .\" property of Apple Inc. and are protected by Federal copyright |
11 | .\" law. Distribution and use rights are outlined in the file "LICENSE.txt" | |
12 | .\" which should have been included with this file. If this file is | |
13 | .\" file is missing or damaged, see the license at "http://www.cups.org/". | |
89d46774 | 14 | .\" |
f3c17241 MS |
15 | .TH snmp.conf 5 "CUPS" "23 April 2012" "Apple Inc." |
16 | ||
89d46774 | 17 | .SH NAME |
18 | snmp.conf \- snmp configuration file for cups | |
19 | .SH DESCRIPTION | |
f3c17241 MS |
20 | The \fIsnmp.conf\fR file configures how the standard CUPS network backends |
21 | (http, https, ipp, ipps, lpd, snmp, and socket) access printer information using | |
22 | SNMPv1 and is normally located in the \fI/etc/cups\fR directory. Each line in | |
23 | the file can be a configuration directive, a blank line, or a comment. Comment | |
24 | lines start with the # character. | |
89d46774 | 25 | .LP |
f3c17241 MS |
26 | The Community and DebugLevel directives are used by all backends. The remainder |
27 | apply only to the SNMP backend (\fIcups-snmp(8)\fR). | |
89d46774 | 28 | .SH DIRECTIVES |
f3c17241 MS |
29 | The following directives are understood by the CUPS network backends. Consult |
30 | the on-line help for detailed descriptions: | |
89d46774 | 31 | .TP 5 |
32 | Address @IF(\fIname\fR) | |
33 | .TP 5 | |
34 | Address @LOCAL | |
35 | .TP 5 | |
36 | Address \fIaddress\fR | |
37 | .br | |
f3c17241 MS |
38 | Sends SNMP broadcast queries to the specified address(es). There is no default |
39 | for the broadcast address. | |
89d46774 | 40 | .TP 5 |
41 | Community \fIname\fR | |
42 | .br | |
f3c17241 MS |
43 | Specifies the community name to use. Only a single community name may be |
44 | specified. The default community name is "public". | |
89d46774 | 45 | .TP 5 |
f3c17241 | 46 | DebugLevel number |
89d46774 | 47 | .br |
f3c17241 MS |
48 | Specifies the logging level from 0 (none) to 3 (everything). Typically only used |
49 | for debugging (thus the name). The default debug level is 0. | |
50 | .TP 5 | |
51 | DeviceURI "regular expression" device-uri [... device-uri] | |
52 | .br | |
53 | Specifies one or more device URIs that should be used for a given make and model | |
54 | string. The regular expression is used to match the detected make and model, and | |
55 | the device URI strings must be of the form "scheme://%s[:port]/[path]", where | |
56 | "%s" represents the detected address or hostname. There are no default device | |
57 | URI matching rules. | |
89d46774 | 58 | .TP 5 |
59 | HostNameLookups on | |
60 | .TP 5 | |
61 | HostNameLookups off | |
62 | .br | |
f3c17241 MS |
63 | Specifies whether the addresses of printers should be converted to hostnames or |
64 | left as numeric IP addresses. The default is "off". | |
d09495fa | 65 | .TP 5 |
66 | MaxRunTime \fIseconds\fR | |
67 | .br | |
f3c17241 MS |
68 | Specifies the maximum number of seconds that the SNMP backend will scan the |
69 | network for printers. The default is 120 seconds (2 minutes). | |
89d46774 | 70 | .SH SEE ALSO |
f3c17241 MS |
71 | cups-snmp(8), |
72 | .br | |
89d46774 | 73 | http://localhost:631/help |
74 | .SH COPYRIGHT | |
0fa6c7fa | 75 | Copyright 2007-2013 by Apple Inc. |
89d46774 | 76 | .\" |
61515785 | 77 | .\" End of "$Id: cups-snmp.conf.man 11022 2013-06-06 22:14:09Z msweet $". |
89d46774 | 78 | .\" |