docs-xml/smbdotconf/printing/lpqcommand.xml

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