2 .TH PAPD 8 "06 Mar 2001" "netatalk 1.5"
4 papd \- AppleTalk print server daemon
18 is the AppleTalk printer daemon. This daemon accepts print jobs from
19 AppleTalk clients (typically Macintosh computers) using the Printer
20 Access Protocol (PAP).
22 spools jobs directly into an
24 spool directory and wakes up
26 after accepting a job from the network to have it re-examine the
27 appropriate spool directory. The actual printing and spooling is
31 can also pipe the print job to an external program for processing, and
32 this is the preferred method to avoid compatibility problems with all
33 the flavors of lpd in use.
36 is typically started at boot time, out of system init scripts.
37 It first reads from its configuration file,
38 .BR :ETCDIR:/papd.conf .
39 The file is in the same format as
43 for details. The name of the entry is registered with
45 The following options are supported:
50 Name Type Default Descripton
52 pd str `.ppd' Pathname to PPD file
53 pr str `lp' LPD printer name (or print command)
54 op str `operator' Operator name for LPD spooling
55 ca str NULL Pathname used for CAP-style authentication
56 sp bool false PSSP-style authentication
57 am str NULL UAMS to use for authentication
58 pa str NULL Printer's AppleTalk address?
61 If no configuration file is given, the hostname of the machine is used
62 as the NBP name and all options take their default value.
66 Do not fork or disassociate from the terminal. Write some
67 debugging information to stderr.
76 for the configuration information.
85 for LPD configuration information.
87 The following papd configuration file sets up three print spoolers.
88 The first spooler is known by the NBP name
89 .B Mac Printer Spooler,
90 and uses a PPD file located in /usr/share/lib/ppd.
91 In addition, the user mcs
92 will be the owner of all jobs that are spooled.
93 The second spooler is known as
95 and all options are the default. The third spooler is known as
97 It pipes the print job to lpr for printing. PSSP authenticated printing
98 is enabled, as is CAP-style authenticated printing. Both methods support
99 guest and cleartext authentication as specified by the 'am' option. The
100 PPD used is /etc/atalk/ppds/hp8100.ppd.
104 Mac Printer Spooler:\\
106 :pd=/usr/share/lib/ppd/HPLJ_4M.PPD:\\
113 :pr=|/usr/bin/lpr -Plp:\\
116 :am=uams_guest.so,uams_pam.so:\\
117 :pd=/etc/atalk/ppds/hp8100.ppd:
121 PSSP (Print Server Security Protocol) is an authentication protocol
122 carried out through postscript printer queries to the print server. Using
123 PSSP requires LaserWriter 8.6.1 or greater on the client mac. The user
124 will be prompted to enter their username and password before they print.
125 It may be necessary to re-setup the printer on each client the first time
126 PSSP is enabled, so that the client can figure out that authentication is
127 required to print. You can enable PSSP on a per-printer basis. PSSP is
128 the recommended method of authenticating printers as it is more robust
129 that CAP-style authentication, described below.
131 CAP-style authentication gets its name from the method the CAP (Columbia
132 APpletalk) package used to authenticate its mac clients' printing. This
133 method requires that a user login to a file share before they print.
135 records the username in a temporary file named after the clients
136 Appletalk address, and it deletes the temporary file when the user
139 gets the username from the file with the same Appletalk address as the
140 machine connecting to it. CAP-style authentication will work with any
141 mac client. CAP-style authenticated printing is a compile-time option for
142 netatalk. If both CAP and PSSP are enabled for a particular printer, CAP
143 will be tried first, then it will fall back to PSSP.
146 The list of UAMS to use for authentication (specified with the 'am'
147 option) applies to all printers. It is not possible to define different
148 authentication methods on each printer. You can specify the list of UAMS
149 multiple times, but only the last setting will be used. Currently only
150 uams_guest.so, uams_passwd.so, and uams_pam.so are supported as printer
151 authentication methods. The guest method requires a valid username, but
152 not a password. The passwd and pam methods require both a valid username
153 and the correct password.
156 .B :ETCDIR:/papd.conf
157 Default configuration file.
160 Printer capabilities database.
163 PostScript Printer Description file.
165 answers configuration and font queries from printing clients by
166 consulting the configured PPD file. Such files are available from
167 Adobe, Inc, via anonymous ftp from ftp.adobe.com in /pub/adobe/printerdrivers/mac/all/ppdfiles/
168 (ftp://ftp.adobe.com//pub/adobe/printerdrivers/mac/all/ppdfiles/), or from the printer's
169 manufacturer. If no PPD file is configured,
171 will return the default answer, possibly causing the client to send
172 excessively large jobs.
182 accepts characters with the high bit set (a full 8-bits) from the clients,
183 but some PostScript printers (including Apple Computer's LaserWriter family)
184 only accept 7-bit characters on their serial interface by default. You will
185 need to configure your printer to accept a full 8 bits.