mirror of
https://github.com/samba-team/samba.git
synced 2025-01-20 14:03:59 +03:00
24905ba82d
The constant mark applied to types "string" and "ustring". The previous patches in this patchset already markes all string options as either constant or substituted, but it's still possible to add options or change existing ones to be neither constant nor substituted. In order to enforce strings to be either constant or substitued, remove the explicit constant marker. Instead, any option that is not marked as substituted is implicitly made constant. This patch doesn't change behaviour and all generated files are the same before and after this change. Signed-off-by: Ralph Boehme <slow@samba.org> Reviewed-by: Stefan Metzmacher <metze@samba.org>
42 lines
2.0 KiB
XML
42 lines
2.0 KiB
XML
<samba:parameter name="lppause 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 stop printing or spooling
|
|
a specific print job.</para>
|
|
|
|
<para>This command should be a program or script which takes
|
|
a printer name and job number to pause the print job. One way
|
|
of implementing this is by using job priorities, where jobs
|
|
having a too low priority won't be sent to the printer.</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). On HPUX (see <parameter moreinfo="none">printing=hpux
|
|
</parameter>), if the <parameter moreinfo="none">-p%p</parameter> option is added
|
|
to the lpq command, the job will show up with the correct status, i.e.
|
|
if the job priority is lower than the set fence priority it will
|
|
have the PAUSED status, whereas if the priority is equal or higher it
|
|
will have the SPOOLED or PRINTING status.</para>
|
|
|
|
<para>Note that it is good practice to include the absolute path
|
|
in the lppause command as the PATH may not be available to the server.</para>
|
|
|
|
<para>Currently no default value is given to
|
|
this string, unless the value of the <smbconfoption name="printing"/>
|
|
parameter is <constant>SYSV</constant>, in which case the default is :
|
|
<command moreinfo="none">lp -i %p-%j -H hold</command> or if the value of the
|
|
<parameter moreinfo="none">printing</parameter> parameter is
|
|
<constant>SOFTQ</constant>, then the default is:
|
|
<command moreinfo="none">qstat -s -j%j -h</command>. </para>
|
|
|
|
</description>
|
|
|
|
<related>printing</related>
|
|
|
|
<value type="default"><comment>determined by printing parameter</comment></value>
|
|
<value type="example">/usr/bin/lpalt %p-%j -p0</value>
|
|
</samba:parameter>
|