summaryrefslogtreecommitdiff
path: root/docs/docbook/smbdotconf/printing/lprmcommand.xml
blob: 567602c4f94678bfe5909facd706e4747c8eb7e5 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
<samba:parameter name="lprm command"
                 context="S"
		 print="1"
                 xmlns:samba="http://samba.org/common">
<listitem>
    <para>This parameter specifies the command to be 
    executed on the server host in order to delete a print job.</para>

    <para>This command should be a program or script which takes 
    a printer name and job number, and deletes the print job.</para>

    <para>If a <parameter moreinfo="none">%p</parameter> is given then the printer name 
    is put in its place. A <parameter moreinfo="none">%j</parameter> is replaced with 
    the job number (an integer).</para>

    <para>Note that it is good practice to include the absolute 
    path in the <parameter moreinfo="none">lprm command</parameter> as the PATH may not be 
    available to the server.</para>

    <para>See also the <link linkend="PRINTING"><parameter moreinfo="none">printing
    </parameter></link> parameter.</para>

    <para>Default: <emphasis>depends on the setting of <parameter moreinfo="none">printing
    </parameter></emphasis></para>

    <para>Example 1: <command moreinfo="none">lprm command = /usr/bin/lprm -P%p %j</command></para>

    <para>Example 2: <command moreinfo="none">lprm command = /usr/bin/cancel %p-%j</command></para>
</listitem>
</samba:parameter>