If you want to use your own printer—or someone else's—with your Mac, this lesson explains how to set everything up to print. Note: The information in this article applies to Mac OS 10.4 through 10.4.11.
PAPD(8) System Manager's Manual PAPD(8)NAME
papd - AppleTalk print server daemon
SYNOPSIS
/usr/sbin/papd [ -d ] [ -f configfile ] [ -p printcap ]
DESCRIPTION
papd is the AppleTalk printer daemon. This daemon accepts print jobs from AppleTalk clients (typically Macintosh computers) using the
Printer Access Protocol (PAP). papd spools jobs directly into an lpd(8) spool directory and wakes up lpd 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 lpd. papd can also
pipe the print job to an external program for processing, and this is the preferred method to avoid compatibility problems with all the
flavors of lpd in use.
papd is typically started at boot time, out of system init scripts. It first reads from its configuration file, /etc/atalk//papd.conf.
The file is in the same format as /etc/printcap. See printcap(5) for details. The name of the entry is registered with NBP. The follow-
ing options are supported:
Name Type Default Descripton
pd str `.ppd' Pathname to PPD file
pr str `lp' LPD printer name (or print command)
op str `operator' Operator name for LPD spooling
ca str NULL Pathname used for CAP-style authentication
sp bool false PSSP-style authentication
am str NULL UAMS to use for authentication
pa str NULL Printer's AppleTalk address?
If no configuration file is given, the hostname of the machine is used as the NBP name and all options take their default value.
OPTIONS -d Do not fork or disassociate from the terminal. Write some debugging information to stderr.
-f configfile
Consult configfile instead of /etc/atalk//papd.conf for the configuration information.
-p printcap
Consult printcap instead of /etc/printcap for LPD configuration information.
EXAMPLE
The following papd configuration file sets up three print spoolers. The first spooler is known by the NBP name Mac Printer Spooler, and
uses a PPD file located in /usr/share/lib/ppd. In addition, the user mcs will be the owner of all jobs that are spooled. The second
spooler is known as HP Printer and all options are the default. The third spooler is known as HP 8100 . It pipes the print job to lpr for
printing. PSSP authenticated printing is enabled, as is CAP-style authenticated printing. Both methods support guest and cleartext
authentication as specified by the 'am' option. The PPD used is /etc/atalk/ppds/hp8100.ppd.
Mac Printer Spooler:
:pr=ps:
:pd=/usr/share/lib/ppd/HPLJ_4M.PPD:
:op=mcs:
HP Printer:
:
HP 8100:
:pr=|/usr/bin/lpr -Plp:
:sp:
:ca=/tmp/print:
:am=uams_guest.so,uams_pam.so:
:pd=/etc/atalk/ppds/hp8100.ppd:
NOTES
PSSP (Print Server Security Protocol) is an authentication protocol 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 that CAP-style authentication, described below.
CAP-style authentication 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. afpd records the username in a temporary file named after the
clients Appletalk address, and it deletes the temporary file when the user disconnects. papd 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. CAP-style authenticated print-
ing is a compile-time option for netatalk. If both CAP and PSSP are enabled for a particular printer, CAP will be tried first, then it
will fall back to PSSP.
The list of UAMS to use for authentication (specified with the 'am' option) applies to all printers. It is not possible to define differ-
ent authentication methods on each printer. You can specify the list of UAMS multiple times, but only the last setting will be used. Cur-
rently only uams_guest.so, uams_passwd.so, and uams_pam.so are supported as printer authentication methods. The guest method requires a
valid username, but not a password. The passwd and pam methods require both a valid username and the correct password.
FILES
/etc/atalk//papd.conf
Default configuration file.
/etc/printcap Printer capabilities database.
.ppd PostScript Printer Description file. papd answers configuration and font queries from printing clients by consulting the
configured PPD file. Such files are available from Adobe, Inc, via anonymous ftp from ftp.adobe.com in /pub/adobe/printer-
drivers/mac/all/ppdfiles/ (ftp://ftp.adobe.com//pub/adobe/printerdrivers/mac/all/ppdfiles/), or from the printer's manufac-
turer. If no PPD file is configured, papd will return the default answer, possibly causing the client to send excessively
large jobs.
SEE ALSO lpr(1), lprm(1), printcap(5). lpc(8), lpd(8).
CAVEATS
papd 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. You will need to configure your printer to accept a
full 8 bits.
netatalk 1.5 06 Mar 2001 PAPD(8)