1PAPD.CONF(5) Netatalk 2.1 PAPD.CONF(5)
2
3
4
6 papd.conf - Configuration file used by papd(8) to determine the
7 configuration of printers used by the Netatalk printing daemon
8
10 /etc/netatalk//papd.conf is the configuration file used by papd to
11 configure the printing services offered by netatalk. Please note that
12 papd must be enabled in /etc/netatalk//netatalk.conf for this to take
13 any effect. papd shares the same defaults as lpd on many systems, but
14 not Solaris.
15
16 Any line not prefixed with # is interpreted. The configuration lines
17 are composed like:
18
19 printername:[options]
20
21 On systems running a System V printing system the simplest case is to
22 have either no papd.conf, or to have one that has no active lines. In
23 this case, atalkd should auto-discover the local printers on the
24 machine. Please note that you can split lines by using \\fR.
25
26 printername may be just a name (Printer 1), or it may be a full name in
27 nbp_name format (Printer 1:LaserWriter@My Zone).
28
29 Systems using a BSD printing system should make use of a pipe to the
30 printing command in question within the pr option (eg.
31 pr=|/usr/bin/lpr).
32
33 When CUPS support is compiled in, then cupsautoadd as the first entry
34 in papd.conf will automagically share all CUPS printers by papd
35 utilizing the PPDs assigned in CUPS (customizable -- see below). This
36 can be overwritten for individal printers by subsequently adding
37 individual entries using the CUPS queue name as pr entry. Note: CUPS
38 support is mutually exclusive with System V support described above.
39
40 The possible options are colon delimited (:), and lines must be
41 terminated with colons. The possible options and flags are:
42
43 am=(uams list)
44 The am option allows specific UAMs to be specified for a particular
45 printer. It has no effect if the au flag is not present or if papd
46 authentication was not built into netatalk. Note: possible values
47 are uams_guest.so and
48 uams_clrtxt.so only. The first method requires a valid username,
49 but no password. The second requires both a valid username and the
50 correct password.
51
52 au
53 If present, this flag enables authentication for the printer.
54 Please note that papd authentication must be built into netatalk
55 for this to take effect.
56
57 co=(CUPS options)
58 The co option allows options to be passed through to CUPS (eg.
59 co="protocol=TBCP" or co="raw").
60
61 cupsautoadd[:type][@zone]
62 If used as the first entry in papd.conf this will share all CUPS
63 printers via papd. type/zone settings as well as other parameters
64 assigned to this special printer share will apply to all CUPS
65 printers. Unless the pd option is set, the CUPS PPDs will be used.
66 To overwrite these global settings for individual printers simply
67 add them subsequently to papd.conf and assign different settings.
68
69 fo
70 If present, this flag enables a hack to translate line endings
71 originating from pre Mac OS X LaserWriter drivers to let
72 foomatic-rip recognize foomatic PPD options set in the printer
73 dialog. Attention: Use with caution since this might corrupt binary
74 print jobs!
75
76 op=(operator)
77 This specifies the operator name, for lpd spooling.
78
79 pa=(appletalk address)
80 Allows specification of Appletalk addresses. Usually not needed.
81
82 pd=(path to ppd file)
83 Specifies a particular PPD (printer description file) to associate
84 with the selected printer.
85
86 pr=(lpd/CUPS printer name or pipe command)
87 Sets the lpd or CUPS printer that this is spooled to.
88
90 Unless CUPS support has been compiled in (which is default from
91 Netatalk 2.0 on) one simply defines the lpd queue in question by
92 setting the pr parameter to the queue name, in the following example
93 "ps". If no pr parameter is set, the default printer will be used.
94
95 Example. papd.conf System V printing system examples
96
97 The first spooler is known by the AppleTalk name Mac Printer Spooler,
98 and uses a PPD file located in /usr/share/lib/ppd. In addition, the
99 user mcs will be the owner of all jobs that are spooled. The second
100 spooler is known as HP Printer and all options are the default.
101
102 Mac Printer Spooler:\
103 :pr=ps:\
104 :pd=/usr/share/lib/ppd/HPLJ_4M.PPD:\
105 :op=mcs:
106
107 HP Printer:\
108 :
109
110
111 An alternative to the technique outlined above is to direct papd´s
112 output via a pipe into another program. Using this mechanism almost all
113 printing systems can be driven.
114
115 Example. papd.conf examples using pipes
116
117 The first spooler is known as HP 8100. It pipes the print job to
118 /usr/bin/lpr for printing. PSSP authenticated printing is enabled, as
119 is CAP-style authenticated printing. Both methods support guest and
120 cleartext authentication as specified by the ´am´ option. The PPD used
121 is /etc/atalk/ppds/hp8100.ppd.
122
123 HP 8100:\
124 :pr=|/usr/bin/lpr -Plp:\
125 :sp:\
126 :ca=/tmp/print:\
127 :am=uams_guest.so,uams_pam.so:\
128 :pd=/etc/atalk/ppds/hp8100.ppd:
129
130
131
132
133 Starting with Netatalk 2.0 direct CUPS integration is available. In
134 this case, defining only a queue name as pr parameter won´t invoke the
135 SysV lpd daemon but uses CUPS instead. Unless a specific PPD has been
136 assigned using the pd switch, the PPD configured in CUPS will be used
137 by papd, too.
138
139 There exists one special share named "cupsautoadd". If this is present
140 as the first entry then all available CUPS queues will be served
141 automagically using the parameters assigned to this global share. But
142 subsequent printer definitions can be used to override these global
143 settings for individual spoolers.
144
145 Example. papd.conf CUPS examples
146
147 The first entry sets up automatic sharing of all CUPS printers. All
148 those shares appear in the zone "1st floor" and since no additional
149 settings have been made, they use the CUPS printer name as NBP name and
150 use the PPD configured in CUPS. The second entry defines different
151 settings for one single CUPS printer. It´s NBP name is differing from
152 the printer´s name and the registration happens in another zone.
153
154 cupsautoadd@1st floor:op=root:
155
156 Boss´ LaserWriter@2nd floor:\
157 :pr=laserwriter-chief:
158
159
161 papd(8), atalkd.conf(5), lpd(8), lpoptions(8)
162
163
164
165Netatalk 2.1 06 Sep 2004 PAPD.CONF(5)