man/cups-snmp.conf.man

   1 .\"
   2 .\" "$Id$"
   3 .\"
   4 .\"   snmp.conf man page for the Common UNIX Printing System (CUPS).
   5 .\"
   6 .\"   Copyright 2006 by Easy Software Products.
   7 .\"
   8 .\"   These coded instructions, statements, and computer programs are the
   9 .\"   property of Easy Software Products and are protected by Federal
  10 .\"   copyright law.  Distribution and use rights are outlined in the file
  11 .\"   "LICENSE.txt" which should have been included with this file.  If this
  12 .\"   file is missing or damaged please contact Easy Software Products
  13 .\"   at:
  14 .\"
  15 .\"       Attn: CUPS Licensing Information
  16 .\"       Easy Software Products
  17 .\"       44141 Airport View Drive, Suite 204
  18 .\"       Hollywood, Maryland 20636 USA
  19 .\"
  20 .\"       Voice: (301) 373-9600
  21 .\"       EMail: cups-info@cups.org
  22 .\"         WWW: http://www.cups.org
  23 .\"
  24 .TH snmp.conf 5 "Common UNIX Printing System" "31 July 2006" "Easy Software Products"
  25 .SH NAME
  26 snmp.conf \- snmp configuration file for cups
  27 .SH DESCRIPTION
  28 The \fIsnmp.conf\fR file configures the CUPS SNMP printer
  29 discovery backend and is  normally located in the \fI/etc/cups\fR
  30 directory. Each line in the file can be a configuration
  31 directive, a blank line, or a comment. Comment lines start with
  32 the # character.
  33 .LP
  34 The SNMP backend uses the SNMPv1 protocol to discover network
  35 printers, collecting information from the Host MIB along with
  36 intelligent port probes to determine the correct device URI and
  37 make and model for each printer. Future versions of CUPS will
  38 likely support the new Port Monitor MIB as well.
  39 .SH DIRECTIVES
  40 The following directives are understood by the SNMP backend.
  41 Consult the on-line help for detailed descriptions:
  42 .TP 5
  43 Address @IF(\fIname\fR)
  44 .TP 5
  45 Address @LOCAL
  46 .TP 5
  47 Address \fIaddress\fR
  48 .br
  49 Sends SNMP broadcast queries to the specified address(es). The
  50 default address is "@LOCAL" which broadcasts to all LAN
  51 interfaces.
  52 .TP 5
  53 Community \fIname\fR
  54 .br
  55 Specifies a SNMP community to query. The default community is
  56 "public".
  57 .TP 5
  58 DebugLevel \fIN\fR
  59 .br
  60 Sets the debug logging level to \fIN\fR; 0 disables debug
  61 logging, 1 enables basic logging, 2 displays SNMP values, and 3
  62 displays raw hex data.
  63 .TP 5
  64 HostNameLookups on
  65 .TP 5
  66 HostNameLookups off
  67 .br
  68 Specifies whether the addresses of printers should be converted
  69 to hostnames or left as numeric IP addresses. The default is
  70 "off".
  71 .TP 5
  72 MaxRunTime \fIseconds\fR
  73 .br
  74 Specifies the maximum number of seconds that the SNMP backend
  75 will scan the network for printers.
  76 .SH SEE ALSO
  77 http://localhost:631/help
  78 .SH COPYRIGHT
  79 Copyright 2006 by Easy Software Products, All Rights Reserved.
  80 .\"
  81 .\" End of "$Id$".
  82 .\"