2 .TH papd 8 "06 September 2004" 2.0.2 Netatalk
4 papd \- AppleTalk print server daemon
6 \fBpapd\fR [\-d] [\-f configfile] [\-p printcap]
8 papd is the AppleTalk printer daemon. This daemon
9 accepts print jobs from AppleTalk clients (typically Macintosh computers)
10 using the Printer Access Protocol (PAP). When used with System V printing
11 systems, papd spools jobs directly into an
12 \fBlpd\fR(8) spool directory and wakes up lpd
13 after accepting a job from the network to have it re\-examine the
14 appropriate spool directory. The actual printing and spooling is handled
17 papd can also pipe the print job to an external
18 program for processing, and this is the preferred method on systems not
19 using CUPS to avoid compatibility problems with all the flavours of
22 As of version 2.0, CUPS is also supported. Simply using \fIcupsautoadd\fR as first papd.conf entry will share all
23 CUPS printers automagically using the PPD files configured in CUPS. It ist
24 still possible to overwrite these defaults by individually define printer
25 shares. See \fBpapd.conf\fR(5) for details.
27 papd is typically started at boot time, out of
28 system init scripts. It first reads from its configuration file,
29 \fB:ETCDIR:/papd.conf\fR. The file is in the same format as
30 \fB/etc/printcap\fR. See \fBprintcap\fR(5) for details. The name of the entry is registered with
33 The following options are supported:
63 LPD or CUPS printer name (or pipe to a print
73 Operator name for LPD spooling
82 Whether to do authenticated printing or not
91 Pathname used for CAP\-style authentification
100 PSSP\-style authetication
109 UAMS to use for authentication
118 Printer's AppleTalk address
127 CUPS options as supplied to the \fBlp\fR(1) command with "\-o"
136 adjust lineending for foomatic\-rip
139 If no configuration file is given, the hostname of the
140 machine is used as the NBP name and all options take their default
145 Do not fork or disassociate from the terminal. Write some
146 debugging information to stderr.
149 Consult \fIconfigfile\fR instead of
150 \fB:ETCDIR:/papd.conf\fR for the configuration
154 Consult \fIprintcap\fR instead of
155 \fB/etc/printcap\fR for LPD configuration
158 PSSP (Print Server Security Protocol) is an authentication
159 protocol carried out through postscript printer queries to the print
160 server. Using PSSP requires LaserWriter 8.6.1 or greater on the client
161 mac. The user will be prompted to enter their username and password before
162 they print. It may be necessary to re\-setup the printer on each client the
163 first time PSSP is enabled, so that the client can figure out that
164 authentication is required to print. You can enable PSSP on a per\-printer
165 basis. PSSP is the recommended method of authenticating printers as it is
166 more robust than CAP\-style authentication, described below.
168 CAP\-style authentication gets its name from the method the CAP (Columbia APpletalk)
169 package used to authenticate its mac clients' printing. This method
170 requires that a user login to a file share before they print.
171 afpd records the username in a temporary file named
172 after the client's Appletalk address, and it deletes the temporary file
173 when the user disconnects. Therefore CAP style authentification will
174 \fInot\fR work for clients connected to
175 afpd via TCP/IP. papd gets the
176 username from the file with the same Appletalk address as the machine
177 connecting to it. CAP\-style authentication will work with any mac client.
178 If both CAP and PSSP are enabled for a particular printer, CAP will be
179 tried first, then papd will fall back to PSSP.
181 The list of UAMs to use for authentication (specified with the 'am' option)
182 applies to all printers. It is not possible to define different
183 authentication methods on each printer. You can specify the list of UAMS
184 multiple times, but only the last setting will be used. Currently only
185 uams_guest.so and uams_clrtxt.so are supported as printer authentication
186 methods. The guest method requires a valid username, but not a password.
187 The Cleartext UAM requires both a valid username and the correct
192 As of this writing, Mac OS X makes no use of PSSP authentication
193 any longer. CAP\-style authentication normally won't be an option, too
194 caused by the use of AFP over TCP these days.
199 \fB:ETCDIR:/papd.conf\fR
200 Default configuration file.
203 Printer capabilities database.
206 PostScript Printer Description file. papd answers
207 configuration and font queries from printing clients by consulting
208 the configured PPD file. Such files are available for download from
209 Adobe, Inc. (http://www.adobe.com/support/downloads/main.htm),
210 or from the printer's manufacturer. If no PPD file is configured,
211 papd will return the default answer, possibly causing the client to
212 send excessively large jobs.
214 papd accepts characters with the high bit set (a
215 full 8\-bits) from the clients, but some PostScript printers (including
216 Apple Computer's LaserWriter family) only accept 7\-bit characters on their
217 serial interface by default. The same applies for some printers when
218 they're accessed via TCP/IP methods (remote LPR or socket). You will need
219 to configure your printer to accept a full 8 bits or take special
220 precautions and convert the printjob's encoding (eg. by using \fIco="protocol=BCP"\fR when using CUPS 1.1.19 or
223 When printing clients run MacOS 10.2 or above, take care that PPDs
224 do not make use of \fI*cupsFilter:\fR comments
225 unless the appropriate filters are installed at the client's side, too
226 (remember: Starting with 10.2 Apple chose to integrate CUPS into MacOS X).
227 For in\-depth information on how CUPS uses PPDs see chapter 3.4 in http://tinyurl.com/zbxn).
229 \fBlpr\fR(1),\fBlprm\fR(1),\fBprintcap\fR(5),\fBlpc\fR(8),\fBlpd\fR(8), \fBlp\fR(1).