man/man8/papd.8.tmpl

   1 .\" t
   2 .TH papd 8 "06 September 2004" 2.0.2 Netatalk
   3 .SH NAME
   4 papd \- AppleTalk print server daemon
   5 .SH SYNOPSIS
   6 \fBpapd\fR [\-d] [\-f configfile] [\-p printcap]
   7 .SH DESCRIPTION
   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
  15 entirely by lpd.
  16 .PP
  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
  20 lpd in use.
  21 .PP
  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.
  26 .PP
  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
  31 NBP.
  32 .PP
  33 The following options are supported:
  34 .TS
  35 c c c l.
  36 T{
  37 Name
  38 T}      T{
  39 Type
  40 T}      T{
  41 Default
  42 T}      T{
  43 Description
  44 T}
  45 .T&
  46 c l l l.
  47 T{
  48 pd
  49 T}      T{
  50 str
  51 T}      T{
  52 \&'.ppd'
  53 T}      T{
  54 Pathname to PPD file
  55 T}
  56 T{
  57 pr
  58 T}      T{
  59 str
  60 T}      T{
  61 \&'lp'
  62 T}      T{
  63 LPD or CUPS printer name (or pipe to a print
  64 command)
  65 T}
  66 T{
  67 op
  68 T}      T{
  69 str
  70 T}      T{
  71 \&'operator'
  72 T}      T{
  73 Operator name for LPD spooling
  74 T}
  75 T{
  76 au
  77 T}      T{
  78 bool
  79 T}      T{
  80 false
  81 T}      T{
  82 Whether to do authenticated printing or not
  83 T}
  84 T{
  85 ca
  86 T}      T{
  87 str
  88 T}      T{
  89 NULL
  90 T}      T{
  91 Pathname used for CAP\-style authentification
  92 T}
  93 T{
  94 sp
  95 T}      T{
  96 bool
  97 T}      T{
  98 false
  99 T}      T{
 100 PSSP\-style authetication
 101 T}
 102 T{
 103 am
 104 T}      T{
 105 str
 106 T}      T{
 107 NULL
 108 T}      T{
 109 UAMS to use for authentication
 110 T}
 111 T{
 112 pa
 113 T}      T{
 114 str
 115 T}      T{
 116 NULL
 117 T}      T{
 118 Printer's AppleTalk address
 119 T}
 120 T{
 121 co
 122 T}      T{
 123 str
 124 T}      T{
 125 NULL
 126 T}      T{
 127 CUPS options as supplied to the \fBlp\fR(1) command with "\-o"
 128 T}
 129 T{
 130 fo
 131 T}      T{
 132 bool
 133 T}      T{
 134 false
 135 T}      T{
 136 adjust lineending for foomatic\-rip
 137 T}
 138 .TE
 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
 141 value.
 142 .SH OPTIONS
 143 .TP
 144 \-d
 145 Do not fork or disassociate from the terminal. Write some
 146 debugging information to stderr.
 147 .TP
 148 \-f \fIconfigfile\fR
 149 Consult \fIconfigfile\fR instead of
 150 \fB:ETCDIR:/papd.conf\fR for the configuration
 151 information.
 152 .TP
 153 \-p \fIprintcap\fR
 154 Consult \fIprintcap\fR instead of
 155 \fB/etc/printcap\fR for LPD configuration
 156 information.
 157 .SH NOTES
 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.
 167 .PP
 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.
 180 .PP
 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
 188 password.
 189 .RS
 190 \fBNote\fR
 191 .PP
 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.
 195 .RE
 196 .PP
 197 .SH FILES
 198 .TP
 199 \fB:ETCDIR:/papd.conf\fR
 200 Default configuration file.
 201 .TP
 202 \fB/etc/printcap\fR
 203 Printer capabilities database.
 204 .TP
 205 \fB\&.ppd\fR
 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.
 213 .SH CAVEATS
 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
 221 above).
 222 .PP
 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).
 228 .SH "SEE ALSO"
 229 \fBlpr\fR(1),\fBlprm\fR(1),\fBprintcap\fR(5),\fBlpc\fR(8),\fBlpd\fR(8), \fBlp\fR(1).
 230