Next update of VFS modules development guide
[gd/samba-autobuild/.git] / docs-xml / 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 <smbconfoption name="lppause command"/> parameter.</para>
14
15     <para>If a <parameter moreinfo="none">%p</parameter> is given then the printer name 
16     is put in its place. A <parameter moreinfo="none">%j</parameter> is replaced with 
17     the job number (an integer).</para>
18                 
19     <para>Note that it is good practice to include the absolute path 
20     in the <parameter moreinfo="none">lpresume command</parameter> as the PATH may not 
21     be available to the server.</para>
22                 
23     <para>See also the <smbconfoption name="printing"/> parameter.</para>
24
25     <para>Default: Currently no default value is given 
26     to this string, unless the value of the <parameter moreinfo="none">printing</parameter> 
27     parameter is <constant>SYSV</constant>, in which case the default is:</para>
28
29     <para><command moreinfo="none">lp -i %p-%j -H resume</command></para>
30
31     <para>or if the value of the <parameter moreinfo="none">printing</parameter> parameter 
32     is <constant>SOFTQ</constant>, then the default is:</para>
33
34     <para><command moreinfo="none">qstat -s -j%j -r</command></para>
35 </description>
36
37 <value type="example">/usr/bin/lpalt %p-%j -p2</value>
38 </samba:parameter>