docs:smbdotconf: make formatting of headers uniform.
[Samba.git] / docs-xml / smbdotconf / printing / lpresumecommand.xml
blob153ba76a693f9c6b2da9b7d344c572d8500c3235
1 <samba:parameter name="lpresume 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 restart or continue 
8     printing or spooling a specific print job.</para>
10     <para>This command should be a program or script which takes 
11     a printer name and job number to resume the print job. See 
12     also the <smbconfoption name="lppause command"/> parameter.</para>
14     <para>If a <parameter moreinfo="none">%p</parameter> is given then the printer name 
15     is put in its place. A <parameter moreinfo="none">%j</parameter> is replaced with 
16     the job number (an integer).</para>
17                 
18     <para>Note that it is good practice to include the absolute path 
19     in the <parameter moreinfo="none">lpresume command</parameter> as the PATH may not 
20     be available to the server.</para>
21                 
22     <para>See also the <smbconfoption name="printing"/> parameter.</para>
24     <para>Default: Currently no default value is given 
25     to this string, unless the value of the <parameter moreinfo="none">printing</parameter> 
26     parameter is <constant>SYSV</constant>, in which case the default is:</para>
28     <para><command moreinfo="none">lp -i %p-%j -H resume</command></para>
30     <para>or if the value of the <parameter moreinfo="none">printing</parameter> parameter 
31     is <constant>SOFTQ</constant>, then the default is:</para>
33     <para><command moreinfo="none">qstat -s -j%j -r</command></para>
34 </description>
36 <value type="default"><comment>determined by printing parameter</comment></value>
37 <value type="example">/usr/bin/lpalt %p-%j -p2</value>
38 </samba:parameter>