docs/docbook/smbdotconf/printing/lpqcommand.xml

   1 <samba:parameter xmlns:samba="http://samba.org/common">
   2                 <term><anchor id="LPQCOMMAND"/>lpq command (S)</term>
   3                 <listitem><para>This parameter specifies the command to be
   4                 executed on the server host in order to obtain <command moreinfo="none">lpq
   5                 </command>-style printer status information.</para>
   6
   7                 <para>This command should be a program or script which
   8                 takes a printer name as its only parameter and outputs printer
   9                 status information.</para>
  10
  11                 <para>Currently nine styles of printer status information
  12                 are supported; BSD, AIX, LPRNG, PLP, SYSV, HPUX, QNX, CUPS, and SOFTQ.
  13                 This covers most UNIX systems. You control which type is expected
  14                 using the <parameter moreinfo="none">printing =</parameter> option.</para>
  15
  16                 <para>Some clients (notably Windows for Workgroups) may not
  17                 correctly send the connection number for the printer they are
  18                 requesting status information about. To get around this, the
  19                 server reports on the first printer service connected to by the
  20                 client. This only happens if the connection number sent is invalid.</para>
  21
  22                 <para>If a <parameter moreinfo="none">%p</parameter> is given then the printer name
  23                 is put in its place. Otherwise it is placed at the end of the
  24                 command.</para>
  25
  26                 <para>Note that it is good practice to include the absolute path
  27                 in the <parameter moreinfo="none">lpq command</parameter> as the <envar>$PATH
  28                 </envar> may not be available to the server.  When compiled with
  29                 the CUPS libraries, no <parameter moreinfo="none">lpq command</parameter> is
  30                 needed because smbd will make a library call to obtain the
  31                 print queue listing.</para>
  32
  33                 <para>See also the <link linkend="PRINTING"><parameter moreinfo="none">printing
  34                 </parameter></link> parameter.</para>
  35
  36                 <para>Default: <emphasis>depends on the setting of <parameter moreinfo="none">
  37                 printing</parameter></emphasis></para>
  38
  39                 <para>Example: <command moreinfo="none">lpq command = /usr/bin/lpq -P%p</command></para>
  40                 </listitem>
  41                 </samba:parameter>