man/man8/papd.8.tmpl

   1 '\" t
   2 .\"     Title: papd
   3 .\"    Author: [FIXME: author] [see http://docbook.sf.net/el/author]
   4 .\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>
   5 .\"      Date: 06 September 2004
   6 .\"    Manual: Netatalk 2.1
   7 .\"    Source: Netatalk 2.1
   8 .\"  Language: English
   9 .\"
  10 .TH "PAPD" "8" "06 September 2004" "Netatalk 2.1" "Netatalk 2.1"
  11 .\" -----------------------------------------------------------------
  12 .\" * set default formatting
  13 .\" -----------------------------------------------------------------
  14 .\" disable hyphenation
  15 .nh
  16 .\" disable justification (adjust text to left margin only)
  17 .ad l
  18 .\" -----------------------------------------------------------------
  19 .\" * MAIN CONTENT STARTS HERE *
  20 .\" -----------------------------------------------------------------
  21 .SH "NAME"
  22 papd \- AppleTalk print server daemon
  23 .SH "SYNOPSIS"
  24 .HP \w'\fBpapd\fR\fB\fR\fB\fR\ 'u
  25 \fBpapd\fR\fB\fR\fB\fR [\-d] [\-f\ configfile] [\-p\ printcap]
  26 .SH "DESCRIPTION"
  27 .PP
  28 \fBpapd\fR
  29 is the AppleTalk printer daemon\&. This daemon accepts print jobs from AppleTalk clients (typically Macintosh computers) using the Printer Access Protocol (PAP)\&. When used with System V printing systems,
  30 \fBpapd\fR
  31 spools jobs directly into an
  32 \fBlpd\fR(8)
  33 spool directory and wakes up
  34 \fBlpd\fR
  35 after accepting a job from the network to have it re\-examine the appropriate spool directory\&. The actual printing and spooling is handled entirely by
  36 \fBlpd\fR\&.
  37 .PP
  38 \fBpapd\fR
  39 can also pipe the print job to an external program for processing, and this is the preferred method on systems not using CUPS to avoid compatibility problems with all the flavours of
  40 \fBlpd\fR
  41 in use\&.
  42 .PP
  43 As of version 2\&.0, CUPS is also supported\&. Simply using
  44 \fBcupsautoadd\fR
  45 as first papd\&.conf entry will share all CUPS printers automagically using the PPD files configured in CUPS\&. It ist still possible to overwrite these defaults by individually define printer shares\&. See
  46 \fBpapd.conf\fR(5)
  47 for details\&.
  48 .PP
  49 \fBpapd\fR
  50 is typically started at boot time, out of system init scripts\&. It first reads from its configuration file,
  51 :ETCDIR:/papd\&.conf\&. The file is in the same format as
  52 /etc/printcap\&. See
  53 \fBprintcap\fR(5)
  54 for details\&. The name of the entry is registered with NBP\&.
  55 .PP
  56 The following options are supported:
  57 .TS
  58 tab(:);
  59 cB cB cB nB.
  60 T{
  61 Name
  62 T}:T{
  63 Type
  64 T}:T{
  65 Default
  66 T}:T{
  67 Description
  68 T}
  69 .T&
  70 c l l l
  71 c l l l
  72 c l l l
  73 c l l l
  74 c l l l
  75 c l l l
  76 c l l l
  77 c l l l
  78 c l l l
  79 c l l l.
  80 T{
  81 pd
  82 T}:T{
  83 str
  84 T}:T{
  85 \'\&.ppd\'
  86 T}:T{
  87 Pathname to PPD file
  88 T}
  89 T{
  90 pr
  91 T}:T{
  92 str
  93 T}:T{
  94 \'lp\'
  95 T}:T{
  96 LPD or CUPS printer name (or pipe to a print
  97               command)
  98 T}
  99 T{
 100 op
 101 T}:T{
 102 str
 103 T}:T{
 104 \'operator\'
 105 T}:T{
 106 Operator name for LPD spooling
 107 T}
 108 T{
 109 au
 110 T}:T{
 111 bool
 112 T}:T{
 113 false
 114 T}:T{
 115 Whether to do authenticated printing or not
 116 T}
 117 T{
 118 ca
 119 T}:T{
 120 str
 121 T}:T{
 122 NULL
 123 T}:T{
 124 Pathname used for CAP\-style authentification
 125 T}
 126 T{
 127 sp
 128 T}:T{
 129 bool
 130 T}:T{
 131 false
 132 T}:T{
 133 PSSP\-style authetication
 134 T}
 135 T{
 136 am
 137 T}:T{
 138 str
 139 T}:T{
 140 NULL
 141 T}:T{
 142 UAMS to use for authentication
 143 T}
 144 T{
 145 pa
 146 T}:T{
 147 str
 148 T}:T{
 149 NULL
 150 T}:T{
 151 Printer\'s AppleTalk address
 152 T}
 153 T{
 154 co
 155 T}:T{
 156 str
 157 T}:T{
 158 NULL
 159 T}:T{
 160 CUPS options as supplied to the \fBlp\fR(1) command with "\-o"
 161 T}
 162 T{
 163 fo
 164 T}:T{
 165 bool
 166 T}:T{
 167 false
 168 T}:T{
 169 adjust lineending for foomatic\-rip
 170 T}
 171 .TE
 172 .sp 1
 173 If no configuration file is given, the hostname of the machine is used as the NBP name and all options take their default value\&.
 174 .SH "OPTIONS"
 175 .PP
 176 \-d
 177 .RS 4
 178 Do not fork or disassociate from the terminal\&. Write some debugging information to stderr\&.
 179 .RE
 180 .PP
 181 \-f \fIconfigfile\fR
 182 .RS 4
 183 Consult
 184 \fIconfigfile\fR
 185 instead of
 186 :ETCDIR:/papd\&.conf
 187 for the configuration information\&.
 188 .RE
 189 .PP
 190 \-p \fIprintcap\fR
 191 .RS 4
 192 Consult
 193 \fIprintcap\fR
 194 instead of
 195 /etc/printcap
 196 for LPD configuration information\&.
 197 .RE
 198 .SH "NOTES"
 199 .PP
 200 PSSP
 201 (Print Server Security Protocol) is an authentication protocol
 202 carried out through postscript printer queries to the print server\&. Using PSSP requires LaserWriter 8\&.6\&.1 or greater on the client mac\&. The user will be prompted to enter their username and password before they print\&. It may be necessary to re\-setup the printer on each client the first time PSSP is enabled, so that the client can figure out that authentication is required to print\&. You can enable PSSP on a per\-printer basis\&. PSSP is the recommended method of authenticating printers as it is more robust than CAP\-style authentication, described below\&.
 203 .PP
 204 CAP\-style authentication
 205 gets its name from the method the CAP (Columbia APpletalk) package used to authenticate its mac clients\' printing\&. This method requires that a user login to a file share before they print\&.
 206 \fBafpd\fR
 207 records the username in a temporary file named after the client\'s Appletalk address, and it deletes the temporary file when the user disconnects\&. Therefore CAP style authentification will
 208 \fInot\fR
 209 work for clients connected to
 210 \fBafpd\fR
 211 via TCP/IP\&.
 212 \fBpapd\fR
 213 gets the username from the file with the same Appletalk address as the machine connecting to it\&. CAP\-style authentication will work with any mac client\&. If both CAP and PSSP are enabled for a particular printer, CAP will be tried first, then
 214 \fBpapd\fR
 215 will fall back to PSSP\&.
 216 .PP
 217 The list of UAMs to use for authentication (specified with the \'am\' option) applies to all printers\&. It is not possible to define different authentication methods on each printer\&. You can specify the list of UAMS multiple times, but only the last setting will be used\&. Currently only uams_guest\&.so and uams_clrtxt\&.so are supported as printer authentication methods\&. The guest method requires a valid username, but not a password\&. The Cleartext UAM requires both a valid username and the correct password\&.
 218 .if n \{\
 219 .sp
 220 .\}
 221 .RS 4
 222 .it 1 an-trap
 223 .nr an-no-space-flag 1
 224 .nr an-break-flag 1
 225 .br
 226 .ps +1
 227 \fBNote\fR
 228 .ps -1
 229 .br
 230 .PP
 231 As of this writing, Mac OS X makes no use of PSSP authentication any longer\&. CAP\-style authentication normally won\'t be an option, too caused by the use of AFP over TCP these days\&.
 232 .sp .5v
 233 .RE
 234 .PP
 235 .SH "FILES"
 236 .PP
 237 :ETCDIR:/papd\&.conf
 238 .RS 4
 239 Default configuration file\&.
 240 .RE
 241 .PP
 242 /etc/printcap
 243 .RS 4
 244 Printer capabilities database\&.
 245 .RE
 246 .PP
 247 \&.ppd
 248 .RS 4
 249 PostScript Printer Description file\&. papd answers configuration and font queries from printing clients by consulting the configured PPD file\&. Such files are available for download from Adobe, Inc\&. (\m[blue]\fBhttp://www\&.adobe\&.com/support/downloads/main\&.htm\fR\m[]\&\s-2\u[1]\d\s+2), or from the printer\'s manufacturer\&. If no PPD file is configured, papd will return the default answer, possibly causing the client to send excessively large jobs\&.
 250 .RE
 251 .SH "CAVEATS"
 252 .PP
 253 \fBpapd\fR
 254 accepts characters with the high bit set (a full 8\-bits) from the clients, but some PostScript printers (including Apple Computer\'s LaserWriter family) only accept 7\-bit characters on their serial interface by default\&. The same applies for some printers when they\'re accessed via TCP/IP methods (remote LPR or socket)\&. You will need to configure your printer to accept a full 8 bits or take special precautions and convert the printjob\'s encoding (eg\&. by using
 255 \fBco="protocol=BCP"\fR
 256 when using CUPS 1\&.1\&.19 or above)\&.
 257 .PP
 258 When printing clients run MacOS 10\&.2 or above, take care that PPDs do not make use of
 259 \fB*cupsFilter:\fR
 260 comments unless the appropriate filters are installed at the client\'s side, too (remember: Starting with 10\&.2 Apple chose to integrate CUPS into MacOS X)\&. For in\-depth information on how CUPS uses PPDs see chapter 3\&.4 in
 261 \m[blue]\fBhttp://tinyurl\&.com/zbxn\fR\m[]\&\s-2\u[2]\d\s+2)\&.
 262 .SH "SEE ALSO"
 263 .PP
 264 \fBlpr\fR(1),\fBlprm\fR(1),\fBprintcap\fR(5),\fBlpc\fR(8),\fBlpd\fR(8),
 265 \fBlp\fR(1)\&.
 266 .SH "NOTES"
 267 .IP " 1." 4
 268 http://www.adobe.com/support/downloads/main.htm
 269 .RS 4
 270 \%http://www.adobe.com/support/downloads/main.html#Printer
 271 .RE
 272 .IP " 2." 4
 273 http://tinyurl.com/zbxn
 274 .RS 4
 275 \%http://tinyurl.com/zbxn
 276 .RE