summaryrefslogtreecommitdiff
path: root/docs/docbook/smbdotconf/printing/printcommand.xml
blob: c996ed6c2e2cc7450b261b997f78259819404c6e (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
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
<samba:parameter xmlns:samba="http://samba.org/common">
		<term><anchor id="PRINTCOMMAND"/>print command (S)</term>
		<listitem><para>After a print job has finished spooling to 
		a service, this command will be used via a <command moreinfo="none">system()</command> 
		call to process the spool file. Typically the command specified will 
		submit the spool file to the host's printing subsystem, but there 
 		is no requirement that this be the case. The server will not remove 
		the spool file, so whatever command you specify should remove the 
		spool file when it has been processed, otherwise you will need to 
		manually remove old spool files.</para>
		
		<para>The print command is simply a text string. It will be used 
		verbatim after macro substitutions have been made:</para>

		<para>s, %p - the path to the spool
		file name</para>

		<para>%p - the appropriate printer 
		name</para>

		<para>%J - the job 
		name as transmitted by the client.</para>

		<para>%c - The number of printed pages
		of the spooled job (if known).</para>

		<para>%z - the size of the spooled
		print job (in bytes)</para>

		<para>The print command <emphasis>MUST</emphasis> contain at least 
		one occurrence of <parameter moreinfo="none">%s</parameter> or <parameter moreinfo="none">%f
		</parameter> - the <parameter moreinfo="none">%p</parameter> is optional. At the time 
		a job is submitted, if no printer name is supplied the <parameter moreinfo="none">%p
		</parameter> will be silently removed from the printer command.</para>

		<para>If specified in the [global] section, the print command given 
		will be used for any printable service that does not have its own 
		print command specified.</para>

		<para>If there is neither a specified print command for a 
		printable service nor a global print command, spool files will 
		be created but not processed and (most importantly) not removed.</para>

		<para>Note that printing may fail on some UNIXes from the 
		<constant>nobody</constant> account. If this happens then create 
		an alternative guest account that can print and set the <link linkend="GUESTACCOUNT"><parameter moreinfo="none">guest account</parameter></link> 
		in the [global] section.</para>

		<para>You can form quite complex print commands by realizing 
		that they are just passed to a shell. For example the following 
		will log a print job, print the file, then remove it. Note that 
		';' is the usual separator for command in shell scripts.</para>

		<para><command moreinfo="none">print command = echo Printing %s &gt;&gt; 
		/tmp/print.log; lpr -P %p %s; rm %s</command></para>

		<para>You may have to vary this command considerably depending 
		on how you normally print files on your system. The default for 
		the parameter varies depending on the setting of the <link linkend="PRINTING">
		<parameter moreinfo="none">printing</parameter></link> parameter.</para>

		<para>Default: For <command moreinfo="none">printing = BSD, AIX, QNX, LPRNG 
		or PLP :</command></para>
		<para><command moreinfo="none">print command = lpr -r -P%p %s</command></para>

		<para>For <command moreinfo="none">printing = SYSV or HPUX :</command></para>
		<para><command moreinfo="none">print command = lp -c -d%p %s; rm %s</command></para>

		<para>For <command moreinfo="none">printing = SOFTQ :</command></para>
		<para><command moreinfo="none">print command = lp -d%p -s %s; rm %s</command></para>

		<para>For printing = CUPS :   If SAMBA is compiled against
		libcups, then <link linkend="PRINTING">printcap = cups</link> 
		uses the CUPS API to
		submit jobs, etc.  Otherwise it maps to the System V
		commands with the -oraw option for printing, i.e. it
		uses <command moreinfo="none">lp -c -d%p -oraw; rm %s</command>.   
		With <command moreinfo="none">printing = cups</command>,
		and if SAMBA is compiled against libcups, any manually 
		set print command will be ignored.</para>


		<para>Example: <command moreinfo="none">print command = /usr/local/samba/bin/myprintscript
		%p %s</command></para>
		</listitem>
		</samba:parameter>