summaryrefslogtreecommitdiff
path: root/docs/docbook/smbdotconf/printing/printcapname.xml
blob: fcfeada54c1cd22cc836b4b569f8312e784d2697 (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
<samba:parameter xmlns:samba="http://samba.org/common">
		<term><anchor id="PRINTCAPNAME"/>printcap name (G)</term>
		<listitem><para>This parameter may be used to override the 
		compiled-in default printcap name used by the server (usually <filename moreinfo="none">
		/etc/printcap</filename>). See the discussion of the <link linkend="PRINTERSSECT">[printers]</link> section above for reasons 
		why you might want to do this.</para>

		<para>To use the CUPS printing interface set <command moreinfo="none">printcap name = cups
		</command>. This should be supplemented by an addtional setting 
		<link linkend="PRINTING">printing = cups</link> in the [global] 
		section.  <command moreinfo="none">printcap name = cups</command> will use the  
		&quot;dummy&quot; printcap created by CUPS, as specified in your CUPS
		configuration file.
		</para>

		<para>On System V systems that use <command moreinfo="none">lpstat</command> to 
		list available printers you can use <command moreinfo="none">printcap name = lpstat
		</command> to automatically obtain lists of available printers. This 
		is the default for systems that define SYSV at configure time in 
		Samba (this includes most System V based systems). If <parameter moreinfo="none">
		printcap name</parameter> is set to <command moreinfo="none">lpstat</command> on 
		these systems then Samba will launch <command moreinfo="none">lpstat -v</command> and 
		attempt to parse the output to obtain a printer list.</para>

		<para>A minimal printcap file would look something like this:</para>

<para><programlisting format="linespecific">
print1|My Printer 1
print2|My Printer 2
print3|My Printer 3
print4|My Printer 4
print5|My Printer 5
</programlisting></para>
	
		<para>where the '|' separates aliases of a printer. The fact 
		that the second alias has a space in it gives a hint to Samba 
		that it's a comment.</para>

		<para><emphasis>NOTE</emphasis>: Under AIX the default printcap 
		name is <filename moreinfo="none">/etc/qconfig</filename>. Samba will assume the 
		file is in AIX <filename moreinfo="none">qconfig</filename> format if the string
		<filename moreinfo="none">qconfig</filename> appears in the printcap filename.</para>

		<para>Default: <command moreinfo="none">printcap name = /etc/printcap</command></para>
		<para>Example: <command moreinfo="none">printcap name = /etc/myprintcap</command></para>
		</listitem>
		</samba:parameter>