]> git.ipfire.org Git - thirdparty/cups.git/blame - man/cups-snmp.conf.man
Merge changes from CUPS 1.4svn-r7696.
[thirdparty/cups.git] / man / cups-snmp.conf.man
CommitLineData
89d46774 1.\"
75bd9771 2.\" "$Id: cups-snmp.conf.man 7600 2008-05-20 21:06:23Z mike $"
89d46774 3.\"
4.\" snmp.conf man page for the Common UNIX Printing System (CUPS).
5.\"
bc44d920 6.\" Copyright 2007 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.\"
bc44d920 15.TH snmp.conf 5 "Common UNIX Printing System" "31 July 2006" "Apple Inc."
89d46774 16.SH NAME
17snmp.conf \- snmp configuration file for cups
18.SH DESCRIPTION
19The \fIsnmp.conf\fR file configures the CUPS SNMP printer
20discovery backend and is normally located in the \fI/etc/cups\fR
21directory. Each line in the file can be a configuration
22directive, a blank line, or a comment. Comment lines start with
23the # character.
24.LP
25The SNMP backend uses the SNMPv1 protocol to discover network
26printers, collecting information from the Host MIB along with
27intelligent port probes to determine the correct device URI and
28make and model for each printer. Future versions of CUPS will
29likely support the new Port Monitor MIB as well.
30.SH DIRECTIVES
31The following directives are understood by the SNMP backend.
32Consult the on-line help for detailed descriptions:
33.TP 5
34Address @IF(\fIname\fR)
35.TP 5
36Address @LOCAL
37.TP 5
38Address \fIaddress\fR
39.br
40Sends SNMP broadcast queries to the specified address(es). The
41default address is "@LOCAL" which broadcasts to all LAN
42interfaces.
43.TP 5
44Community \fIname\fR
45.br
46Specifies a SNMP community to query. The default community is
47"public".
48.TP 5
49DebugLevel \fIN\fR
50.br
51Sets the debug logging level to \fIN\fR; 0 disables debug
52logging, 1 enables basic logging, 2 displays SNMP values, and 3
53displays raw hex data.
54.TP 5
55HostNameLookups on
56.TP 5
57HostNameLookups off
58.br
59Specifies whether the addresses of printers should be converted
60to hostnames or left as numeric IP addresses. The default is
61"off".
d09495fa 62.TP 5
63MaxRunTime \fIseconds\fR
64.br
65Specifies the maximum number of seconds that the SNMP backend
66will scan the network for printers.
89d46774 67.SH SEE ALSO
68http://localhost:631/help
69.SH COPYRIGHT
bc44d920 70Copyright 2007 by Apple Inc.
89d46774 71.\"
75bd9771 72.\" End of "$Id: cups-snmp.conf.man 7600 2008-05-20 21:06:23Z mike $".
89d46774 73.\"