docs/docbook/smbdotconf/printing/printcapname.xml

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