summaryrefslogtreecommitdiff
path: root/docs/docbook/smbdotconf/printing/lpqcommand.xml
blob: ddcdf1ef499476000c8398418c4236918c51a9e1 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
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>