man/cups-snmp.conf.man

   1 .\"
   2 .\" "$Id$"
   3 .\"
   4 .\" snmp.conf man page for CUPS.
   5 .\"
   6 .\" Copyright 2007-2014 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 "CUPS" "10 June 2014" "Apple Inc."
  16 .SH NAME
  17 snmp.conf \- snmp configuration file for cups
  18 .SH DESCRIPTION
  19 The
  20 .B snmp.conf
  21 file configures how the standard CUPS network backends (http, https, ipp, ipps, lpd, snmp, and socket) access printer information using SNMPv1 and is normally located in the \fI/etc/cups\fR directory.
  22 Each line in the file can be a configuration directive, a blank line, or a comment. Comment lines start with the # character.
  23 .LP
  24 The Community and DebugLevel directives are used by all backends. The remainder apply only to the SNMP backend -
  25 .BR cups-snmp (8).
  26 .SH DIRECTIVES
  27 The following directives are understood by the CUPS network backends:
  28 .TP 5
  29 \fBAddress @IF(\fIname\fB)\fR
  30 .TP 5
  31 \fBAddress @LOCAL\fR
  32 .TP 5
  33 \fBAddress \fIaddress\fR
  34 Sends SNMP broadcast queries (for discovery) to the specified address(es).
  35 There is no default for the broadcast address.
  36 .TP 5
  37 \fBCommunity \fIname\fR
  38 Specifies the community name to use.
  39 Only a single community name may be specified.
  40 The default community name is "public".
  41 .TP 5
  42 \fBDebugLevel \fInumber\fR
  43 Specifies the logging level from 0 (none) to 3 (everything).
  44 Typically only used for debugging (thus the name).
  45 The default debug level is 0.
  46 .TP 5
  47 \fBDeviceURI "\fIregular expression\fB" \fIdevice-uri \fR[... \fIdevice-uri\fR]
  48 Specifies one or more device URIs that should be used for a given make and model string.
  49 The regular expression is used to match the detected make and model, and the device URI strings must be of the form "scheme://%s[:port]/[path]", where "%s" represents the detected address or hostname.
  50 There are no default device URI matching rules.
  51 .TP 5
  52 \fBHostNameLookups on\fR
  53 .TP 5
  54 \fBHostNameLookups off\fR
  55 Specifies whether the addresses of printers should be converted to hostnames or left as numeric IP addresses.
  56 The default is "off".
  57 .TP 5
  58 \fBMaxRunTime \fIseconds\fR
  59 Specifies the maximum number of seconds that the SNMP backend will scan the
  60 network for printers.
  61 The default is 120 seconds (2 minutes).
  62 .SH SEE ALSO
  63 .BR cups-snmp (8),
  64 CUPS Online Help (http://localhost:631/help)
  65 .SH COPYRIGHT
  66 Copyright \[co] 2007-2014 by Apple Inc.
  67 .\"
  68 .\" End of "$Id$".
  69 .\"