man/cups-snmp.conf.man

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