summaryrefslogtreecommitdiffstats
path: root/docs-xml/smbdotconf/printing/lprmcommand.xml
blob: 4b7f3dd75c35aff54d2172b4fbeeffa034418f51 (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
31
32
33
34
35
<samba:parameter name="lprm command"
                 context="S"
                 type="string"
                 xmlns:samba="http://www.samba.org/samba/DTD/samba-doc">
<description>
    <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>
	Examples of use are:
<programlisting>
lprm command = /usr/bin/lprm -P%p %j

or

lprm command = /usr/bin/cancel %p-%j
</programlisting>
	</para>

</description>
<related>printing</related>

<value type="default"><comment>determined by printing parameter</comment></value>
</samba:parameter>