doc/help/ref-snmp-conf.html

   1 <HTML>
   2 <!-- SECTION: References -->
   3 <HEAD>
   4         <TITLE>snmp.conf</TITLE>
   5 </HEAD>
   6 <BODY>
   7
   8 <P>The <VAR>/etc/cups/snmp.conf</VAR> file contains several
   9 directives that determine how the SNMP printer discovery backend
  10 behaves. Each directive is listed on a line by itself followed
  11 by its value. Comments are introduced using the number sign ("#")
  12 character at the beginning of a line.</P>
  13
  14 <P>The SNMP backend uses the SNMPv1 protocol to discover network
  15 printers, collecting information from the Host MIB along with
  16 intelligent port probes to determine the correct device URI and
  17 make and model for each printer. Future versions of CUPS will
  18 likely support the new Port Monitor MIB as well.</P>
  19
  20 <H2 CLASS="title"><A NAME="Address">Address</A></H2>
  21
  22 <H3>Examples</H3>
  23
  24 <PRE CLASS="command">
  25 Address @LOCAL
  26 Address @IF(name)
  27 Address 255.255.255.255
  28 Address 192.168.2.255
  29 </PRE>
  30
  31 <H3>Description</H3>
  32
  33 <P>The <CODE>Address</CODE> directive specifies a broadcast
  34 address to use when discovering printers. Multiple
  35 <CODE>Address</CODE> lines can be provided to scan different
  36 subnets.</P>
  37
  38 <P>The default address is <VAR>@LOCAL</VAR>, which broadcasts to
  39 all LANs.</P>
  40
  41
  42 <H2 CLASS="title"><A NAME="Community">Community</A></H2>
  43
  44 <H3>Examples</H3>
  45
  46 <PRE CLASS="command">
  47 Community public
  48 Community easysw
  49 Community BigCorp
  50 </PRE>
  51
  52 <H3>Description</H3>
  53
  54 <P>The <CODE>Community</CODE> directive specifies a community
  55 name to use when discovering printers. Multiple
  56 <CODE>Community</CODE> lines can be provided to scan different
  57 SNMP communities.</P>
  58
  59 <P>The default community is "public".</P>
  60
  61
  62 <H2 CLASS="title"><A NAME="DebugLevel">DebugLevel</A></H2>
  63
  64 <H3>Examples</H3>
  65
  66 <PRE CLASS="command">
  67 DebugLevel 0
  68 DebugLevel 1
  69 DebugLevel 2
  70 DebugLevel 3
  71 </PRE>
  72
  73 <H3>Description</H3>
  74
  75 <P>The <CODE>DebugLevel</CODE> directive specifies the debugging
  76 level to use when searching for network printers. Level 0
  77 produces no debugging information. Level 1 produces basic
  78 debugging information. Level 2 adds printing of the SNMP
  79 messages. Level 3 adds a hex dump of the network data.</P>
  80
  81 <P>The default setting is <VAR>0</VAR>.</P>
  82
  83 <H2 CLASS="title"><A NAME="HostNameLookups">HostNameLookups</A></H2>
  84
  85 <H3>Examples</H3>
  86
  87 <PRE CLASS="command">
  88 HostNameLookups on
  89 HostNameLookups off
  90 </PRE>
  91
  92 <H3>Description</H3>
  93
  94 <P>The <CODE>HostNameLookups</CODE> directive specifies whether printer
  95 addresses are converted to hostnames or left as numeric IP addresses.</P>
  96
  97 <P>The default setting is <VAR>off</VAR>.</P>
  98
  99 <H2 CLASS="title"><A NAME="MaxRunTime">MaxRunTime</A></H2>
 100
 101 <H3>Examples</H3>
 102
 103 <PRE CLASS="command">
 104 MaxRunTime 10
 105 MaxRunTime 300
 106 </PRE>
 107
 108 <H3>Description</H3>
 109
 110 <P>The <CODE>MaxRunTime</CODE> directive specifies the maxium
 111 number of seconds that the SNMP backend will spend looking for
 112 printer devices on the network.</P>
 113
 114 <P>The default setting is <VAR>10</VAR>.</P>
 115
 116 </BODY>
 117 </HTML>