Update DTD location
[tprouty/samba.git] / docs / smbdotconf / printing / lpresumecommand.xml
1 <samba:parameter name="lpresume command"
2                  context="S"
3                                  type="string"
4                  print="1"
5                  xmlns:samba="http://www.samba.org/samba/DTD/samba-doc">
6 <description>
7     <para>This parameter specifies the command to be 
8     executed on the server host in order to restart or continue 
9     printing or spooling a specific print job.</para>
10
11     <para>This command should be a program or script which takes 
12     a printer name and job number to resume the print job. See 
13     also the <link linkend="LPPAUSECOMMAND"><parameter moreinfo="none">lppause command
14     </parameter></link> parameter.</para>
15
16     <para>If a <parameter moreinfo="none">%p</parameter> is given then the printer name 
17     is put in its place. A <parameter moreinfo="none">%j</parameter> is replaced with 
18     the job number (an integer).</para>
19                 
20     <para>Note that it is good practice to include the absolute path 
21     in the <parameter moreinfo="none">lpresume command</parameter> as the PATH may not 
22     be available to the server.</para>
23                 
24     <para>See also the <link linkend="PRINTING"><parameter moreinfo="none">printing
25     </parameter></link> parameter.</para>
26
27     <para>Default: Currently no default value is given 
28     to this string, unless the value of the <parameter moreinfo="none">printing</parameter> 
29     parameter is <constant>SYSV</constant>, in which case the default is :</para>
30
31     <para><command moreinfo="none">lp -i %p-%j -H resume</command></para>
32
33     <para>or if the value of the <parameter moreinfo="none">printing</parameter> parameter 
34                 is <constant>SOFTQ</constant>, then the default is:</para>
35
36     <para><command moreinfo="none">qstat -s -j%j -r</command></para>
37 </description>
38
39 <value type="default">lpresume command = /usr/bin/lpalt %p-%j -p2</value>
40 </samba:parameter>