Add new framework for smb.conf(5). Please read README before trying to compile.

I will commit more meta-information updates during week-end.
(This used to be commit 8d684dffab6a90b3d612a1aa2b2c457a2bc2e6ac)

1 files changed, 41 insertions, 0 deletions

diff --git a/docs/docbook/smbdotconf/printing/lpqcommand.xml b/docs/docbook/smbdotconf/printing/lpqcommand.xml
new file mode 100644
index 0000000000..ddcdf1ef49
--- /dev/null
+++ b/docs/docbook/smbdotconf/printing/lpqcommand.xml
@@ -0,0 +1,41 @@
+<samba:parameter xmlns:samba="http://samba.org/common">
+		<term><anchor id="LPQCOMMAND"/>lpq command (S)</term>
+		<listitem><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>
+
+		<para>See also the <link linkend="PRINTING"><parameter moreinfo="none">printing
+		</parameter></link> parameter.</para>
+
+		<para>Default: <emphasis>depends on the setting of <parameter moreinfo="none">
+		printing</parameter></emphasis></para>
+
+		<para>Example: <command moreinfo="none">lpq command = /usr/bin/lpq -P%p</command></para>
+		</listitem>
+		</samba:parameter>