]> arthur.barton.de Git - netatalk.git/blob - man/man8/papd.8.tmpl
8176675e9154186b2f1b009a854e77a05a12634a
[netatalk.git] / man / man8 / papd.8.tmpl
1 '\" t
2 .TH PAPD 8 "06 Mar 2001" "netatalk 1.5"
3 .SH NAME
4 papd \- AppleTalk print server daemon
5 .SH SYNOPSIS
6 .B :SBINDIR:/papd
7 [
8 .B -d
9 ] [
10 .B -f
11 .I configfile
12 ] [
13 .B -p
14 .I printcap
15 ]
16 .SH DESCRIPTION
17 .B papd
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).
21 .B papd
22 spools jobs directly into an
23 .BR lpd (8)
24 spool directory and wakes up
25 .B lpd
26 after accepting a job from the network to have it re-examine the
27 appropriate spool directory.  The actual printing and spooling is
28 handled entirely by
29 .B lpd.
30 .B papd
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.
34 .LP
35 .B papd
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
40 .BR /etc/printcap .
41 See
42 .BR printcap (5)
43 for details.  The name of the entry is registered with
44 .BR NBP .
45 The following options are supported:
46 .LP
47 .TS
48 c c l l
49 cfB l l l .
50 Name    Type    Default Descripton
51 .sp .5
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      bool    false   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?
59 .TE
60 .LP
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.
63 .SH OPTIONS
64 .TP
65 .B -d
66 Do not fork or disassociate from the terminal.  Write some
67 debugging information to stderr.
68 .HP
69 .B -f
70 .I configfile
71 .br
72 Consult
73 .I configfile
74 instead of
75 .B :ETCDIR:/papd.conf
76 for the configuration information.
77 .HP
78 .B -p
79 .I printcap
80 .br
81 Consult
82 .I printcap
83 instead of
84 .B /etc/printcap
85 for LPD configuration information.
86 .SH EXAMPLE
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
94 .B HP Printer
95 and all options are the default. The third spooler is known as
96 .B HP 8100 .
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.
101 .sp
102 .RS
103 .nf
104 Mac Printer Spooler:\\ 
105         :pr=ps:\\
106         :pd=/usr/share/lib/ppd/HPLJ_4M.PPD:\\
107         :op=mcs:
108
109 HP Printer:\\ 
110         :
111
112 HP 8100:\\
113         :pr=|/usr/bin/lpr -Plp:\\
114         :sp:\\
115         :ca:\\
116         :am=uams_guest.so,uams_pam.so:\\
117         :pd=/etc/atalk/ppds/hp8100.ppd:
118 .fi
119 .RE
120 .SH NOTES
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.
130 .LP
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.
134 .B afpd
135 records the username in a temporary file named after the clients
136 Appletalk address, and it deletes the temporary file when the user
137 disconnects.
138 .B papd
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.
144 .LP
145
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.
154 .SH FILES
155 .TP 16
156 .B :ETCDIR:/papd.conf
157 Default configuration file.
158 .TP 16
159 .B /etc/printcap
160 Printer capabilities database.
161 .TP 16
162 .B .ppd
163 PostScript Printer Description file.
164 .B papd
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/PPDfiles
168 (ftp://ftp.adobe.com/pub/adobe/PPDfiles), or from the printer's
169 manufacturer.  If no PPD file is configured,
170 .B papd
171 will return the default answer, possibly causing the client to send
172 excessively large jobs.
173 .SH SEE ALSO
174 .BR lpr (1),
175 .BR lprm (1),
176 \." .BR pap (4),
177 .BR printcap (5).
178 .BR lpc (8),
179 .BR lpd (8).
180 .SH CAVEATS
181 .I papd
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.