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      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?
  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=/tmp/print:\\
 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.  If both CAP and PSSP are enabled for a particular printer, CAP
 142 will be tried first, then it will fall back to PSSP.
 143 .LP
 144
 145 The list of UAMS to use for authentication (specified with the 'am'
 146 option) applies to all printers.  It is not possible to define different
 147 authentication methods on each printer. You can specify the list of UAMS
 148 multiple times, but only the last setting will be used.  Currently only
 149 uams_guest.so, uams_passwd.so, and uams_pam.so are supported as printer
 150 authentication methods.  The guest method requires a valid username, but
 151 not a password. The passwd and pam methods require both a valid username
 152 and the correct password.
 153 .SH FILES
 154 .TP 16
 155 .B :ETCDIR:/papd.conf
 156 Default configuration file.
 157 .TP 16
 158 .B /etc/printcap
 159 Printer capabilities database.
 160 .TP 16
 161 .B .ppd
 162 PostScript Printer Description file.
 163 .B papd
 164 answers configuration and font queries from printing clients by
 165 consulting the configured PPD file.  Such files are available from
 166 Adobe, Inc, via anonymous ftp from ftp.adobe.com in /pub/adobe/printerdrivers/mac/all/ppdfiles/
 167 (ftp://ftp.adobe.com//pub/adobe/printerdrivers/mac/all/ppdfiles/), or from the printer's
 168 manufacturer.  If no PPD file is configured,
 169 .B papd
 170 will return the default answer, possibly causing the client to send
 171 excessively large jobs.
 172 .SH SEE ALSO
 173 .BR lpr (1),
 174 .BR lprm (1),
 175 \." .BR pap (4),
 176 .BR printcap (5).
 177 .BR lpc (8),
 178 .BR lpd (8).
 179 .SH CAVEATS
 180 .I papd
 181 accepts characters with the high bit set (a full 8-bits) from the clients,
 182 but some PostScript printers (including Apple Computer's LaserWriter family)
 183 only accept 7-bit characters on their serial interface by default.  You will
 184 need to configure your printer to accept a full 8 bits.