docs/docbook/smbdotconf/printing/printcapname.xml

   1 <samba:parameter xmlns:samba="http://samba.org/common">
   2                 <term><anchor id="PRINTCAPNAME"/>printcap name (G)</term>
   3                 <listitem><para>This parameter may be used to override the
   4                 compiled-in default printcap name used by the server (usually <filename moreinfo="none">
   5                 /etc/printcap</filename>). See the discussion of the <link linkend="PRINTERSSECT">[printers]</link> section above for reasons
   6                 why you might want to do this.</para>
   7
   8                 <para>To use the CUPS printing interface set <command moreinfo="none">printcap name = cups
   9                 </command>. This should be supplemented by an addtional setting
  10                 <link linkend="PRINTING">printing = cups</link> in the [global]
  11                 section.  <command moreinfo="none">printcap name = cups</command> will use the
  12                 &quot;dummy&quot; printcap created by CUPS, as specified in your CUPS
  13                 configuration file.
  14                 </para>
  15
  16                 <para>On System V systems that use <command moreinfo="none">lpstat</command> to
  17                 list available printers you can use <command moreinfo="none">printcap name = lpstat
  18                 </command> to automatically obtain lists of available printers. This
  19                 is the default for systems that define SYSV at configure time in
  20                 Samba (this includes most System V based systems). If <parameter moreinfo="none">
  21                 printcap name</parameter> is set to <command moreinfo="none">lpstat</command> on
  22                 these systems then Samba will launch <command moreinfo="none">lpstat -v</command> and
  23                 attempt to parse the output to obtain a printer list.</para>
  24
  25                 <para>A minimal printcap file would look something like this:</para>
  26
  27 <para><programlisting format="linespecific">
  28 print1|My Printer 1
  29 print2|My Printer 2
  30 print3|My Printer 3
  31 print4|My Printer 4
  32 print5|My Printer 5
  33 </programlisting></para>
  34
  35                 <para>where the '|' separates aliases of a printer. The fact
  36                 that the second alias has a space in it gives a hint to Samba
  37                 that it's a comment.</para>
  38
  39                 <note><para>Under AIX the default printcap
  40                 name is <filename moreinfo="none">/etc/qconfig</filename>. Samba will assume the
  41                 file is in AIX <filename moreinfo="none">qconfig</filename> format if the string
  42                 <filename moreinfo="none">qconfig</filename> appears in the printcap filename.</para></note>
  43
  44                 <para>Default: <command moreinfo="none">printcap name = /etc/printcap</command></para>
  45                 <para>Example: <command moreinfo="none">printcap name = /etc/myprintcap</command></para>
  46                 </listitem>
  47                 </samba:parameter>