docs-xml/smbdotconf/printing/lprmcommand.xml

   1 <samba:parameter name="lprm 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 delete a print job.</para>
   8
   9     <para>This command should be a program or script which takes
  10     a printer name and job number, and deletes the print job.</para>
  11
  12     <para>If a <parameter moreinfo="none">%p</parameter> is given then the printer name
  13     is put in its place. A <parameter moreinfo="none">%j</parameter> is replaced with
  14     the job number (an integer).</para>
  15
  16     <para>Note that it is good practice to include the absolute
  17     path in the <parameter moreinfo="none">lprm command</parameter> as the PATH may not be
  18     available to the server.</para>
  19
  20         <para>
  21         Examples of use are:
  22 <programlisting>
  23 lprm command = /usr/bin/lprm -P%p %j
  24
  25 or
  26
  27 lprm command = /usr/bin/cancel %p-%j
  28 </programlisting>
  29         </para>
  30
  31 </description>
  32 <related>printing</related>
  33
  34 <value type="default"><comment>determined by printing parameter</comment></value>
  35 </samba:parameter>