1
0
mirror of https://github.com/samba-team/samba.git synced 2024-12-23 17:34:34 +03:00
samba-mirror/docs-xml/smbdotconf/printing/lpqcommand.xml
Ralph Boehme 24905ba82d docs-xml: remove explicit "constant"
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>
2019-11-27 10:25:37 +00:00

42 lines
1.9 KiB
XML

<samba:parameter name="lpq 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 obtain <command moreinfo="none">lpq
</command>-style printer status information.</para>
<para>This command should be a program or script which
takes a printer name as its only parameter and outputs printer
status information.</para>
<para>Currently nine styles of printer status information
are supported; BSD, AIX, LPRNG, PLP, SYSV, HPUX, QNX, CUPS, and SOFTQ.
This covers most UNIX systems. You control which type is expected
using the <parameter moreinfo="none">printing =</parameter> option.</para>
<para>Some clients (notably Windows for Workgroups) may not
correctly send the connection number for the printer they are
requesting status information about. To get around this, the
server reports on the first printer service connected to by the
client. This only happens if the connection number sent is invalid.</para>
<para>If a <parameter moreinfo="none">%p</parameter> is given then the printer name
is put in its place. Otherwise it is placed at the end of the
command.</para>
<para>Note that it is good practice to include the absolute path
in the <parameter moreinfo="none">lpq command</parameter> as the <envar>$PATH
</envar> may not be available to the server. When compiled with
the CUPS libraries, no <parameter moreinfo="none">lpq command</parameter> is
needed because smbd will make a library call to obtain the
print queue listing.</para>
</description>
<related>printing</related>
<value type="example">/usr/bin/lpq -P%p</value>
<value type="default"><comment>determined by printing parameter</comment></value>
</samba:parameter>