1PAPD(8) Netatalk 2.1 PAPD(8)
2
6 papd - AppleTalk print server daemon
7
9 papd [-d] [-f configfile] [-p printcap]
10
12 papd is the AppleTalk printer daemon. This daemon accepts print jobs
13 from AppleTalk clients (typically Macintosh computers) using the
14 Printer Access Protocol (PAP). When used with System V printing
15 systems, papd spools jobs directly into an lpd(8) spool directory and
16 wakes up lpd after accepting a job from the network to have it
17 re-examine the appropriate spool directory. The actual printing and
18 spooling is handled entirely by lpd.
19 papd can also pipe the print job to an external program for processing,
21 and this is the preferred method on systems not using CUPS to avoid
22 compatibility problems with all the flavours of lpd in use.
23 As of version 2.0, CUPS is also supported. Simply using cupsautoadd as
25 first papd.conf entry will share all CUPS printers automagically using
26 the PPD files configured in CUPS. It ist still possible to overwrite
27 these defaults by individually define printer shares. See papd.conf(5)
28 for details.
29 papd is typically started at boot time, out of system init scripts. It
31 first reads from its configuration file, /etc/netatalk//papd.conf. The
32 file is in the same format as /etc/printcap. See printcap(5) for
33 details. The name of the entry is registered with NBP.
34 The following options are supported:
36 Name Type Default Description
38 pd str ´.ppd´ Pathname to PPD
39 file
40 pr str ´lp´ LPD or CUPS
41 printer name (or
42 pipe to a print
43 command)
44 op str ´operator´ Operator name for LPD
45 spooling
46 au bool false Whether to do
47 authenticated printing
48 or not
49 ca str NULL Pathname used for
50 CAP-style
51 authentification
52 sp bool false PSSP-style
53 authetication
54 am str NULL UAMS to use for
55 authentication
56 pa str NULL Printer´s AppleTalk
57 address
58 co str NULL CUPS options as
59 supplied to the lp(1)
60 command with "-o"
61 fo bool false adjust lineending for
62 foomatic-rip
63 If no configuration file is given, the hostname of the machine is used
65 as the NBP name and all options take their default value.
66
68 -d
69 Do not fork or disassociate from the terminal. Write some debugging
70 information to stderr.
71 -f configfile
73 Consult configfile instead of /etc/netatalk//papd.conf for the
74 configuration information.
75 -p printcap
77 Consult printcap instead of /etc/printcap for LPD configuration
78 information.
79
81 PSSP (Print Server Security Protocol) is an authentication protocol
82 carried out through postscript printer queries to the print server.
83 Using PSSP requires LaserWriter 8.6.1 or greater on the client mac. The
84 user will be prompted to enter their username and password before they
85 print. It may be necessary to re-setup the printer on each client the
86 first time PSSP is enabled, so that the client can figure out that
87 authentication is required to print. You can enable PSSP on a
88 per-printer basis. PSSP is the recommended method of authenticating
89 printers as it is more robust than CAP-style authentication, described
90 below.
91 CAP-style authentication gets its name from the method the CAP
93 (Columbia APpletalk) package used to authenticate its mac clients´
94 printing. This method requires that a user login to a file share before
95 they print. afpd records the username in a temporary file named after
96 the client´s Appletalk address, and it deletes the temporary file when
97 the user disconnects. Therefore CAP style authentification will not
98 work for clients connected to afpd via TCP/IP. papd gets the username
99 from the file with the same Appletalk address as the machine connecting
100 to it. CAP-style authentication will work with any mac client. If both
101 CAP and PSSP are enabled for a particular printer, CAP will be tried
102 first, then papd will fall back to PSSP.
103 The list of UAMs to use for authentication (specified with the ´am´
105 option) applies to all printers. It is not possible to define different
106 authentication methods on each printer. You can specify the list of
107 UAMS multiple times, but only the last setting will be used. Currently
108 only uams_guest.so and uams_clrtxt.so are supported as printer
109 authentication methods. The guest method requires a valid username, but
110 not a password. The Cleartext UAM requires both a valid username and
111 the correct password.
112 Note
114 As of this writing, Mac OS X makes no use of PSSP authentication
115 any longer. CAP-style authentication normally won´t be an option,
116 too caused by the use of AFP over TCP these days.
117
119 /etc/netatalk//papd.conf
120 Default configuration file.
121 /etc/printcap
123 Printer capabilities database.
124 .ppd
126 PostScript Printer Description file. papd answers configuration and
127 font queries from printing clients by consulting the configured PPD
128 file. Such files are available for download from Adobe, Inc.
129 (http://www.adobe.com/support/downloads/main.htm[1]), or from the
130 printer´s manufacturer. If no PPD file is configured, papd will
131 return the default answer, possibly causing the client to send
132 excessively large jobs.
133
135 papd accepts characters with the high bit set (a full 8-bits) from the
136 clients, but some PostScript printers (including Apple Computer´s
137 LaserWriter family) only accept 7-bit characters on their serial
138 interface by default. The same applies for some printers when they´re
139 accessed via TCP/IP methods (remote LPR or socket). You will need to
140 configure your printer to accept a full 8 bits or take special
141 precautions and convert the printjob´s encoding (eg. by using
142 co="protocol=BCP" when using CUPS 1.1.19 or above).
143 When printing clients run MacOS 10.2 or above, take care that PPDs do
145 not make use of *cupsFilter: comments unless the appropriate filters
146 are installed at the client´s side, too (remember: Starting with 10.2
147 Apple chose to integrate CUPS into MacOS X). For in-depth information
148 on how CUPS uses PPDs see chapter 3.4 in http://tinyurl.com/zbxn[2]).
149
151 lpr(1),lprm(1),printcap(5),lpc(8),lpd(8), lp(1).
152
154 1. http://www.adobe.com/support/downloads/main.htm
155 http://www.adobe.com/support/downloads/main.html#Printer
156 2. http://tinyurl.com/zbxn
158 http://tinyurl.com/zbxn
159Netatalk 2.1 06 September 2004 PAPD(8)