papd(8) - f7

1papd(8)                            Netatalk                            papd(8)
2
3
4

NAME

6       papd - AppleTalk print server daemon
7

SYNOPSIS

9       papd [-d] [-f configfile] [-p printcap]
10

DESCRIPTION

12       papd  is  the  AppleTalk printer daemon. This daemon accepts print jobs
13       from  AppleTalk  clients  (typically  Macintosh  computers)  using  the
14       Printer  Access  Protocol  (PAP). When used with System V printing sys‐
15       tems, papd spools jobs directly into  an  lpd(8)  spool  directory  and
16       wakes up lpd after accepting a job from the network to have it re-exam‐
17       ine the appropriate spool directory. The actual printing  and  spooling
18       is handled entirely by lpd.
19
20       papd can also pipe the print job to an external program for processing,
21       and this is the preferred method on systems not  using  CUPS  to  avoid
22       compatibility problems with all the flavours of lpd in use.
23
24       As  of version 2.0, CUPS is also supported. Simply using cupsautoadd as
25       first papd.conf entry will share all CUPS printers automagically  using
26       the  PPD  files  configured in CUPS. It ist still possible to overwrite
27       these defaults by individually define printer shares. See  papd.conf(5)
28       for details.
29
30       papd  is typically started at boot time, out of system init scripts. It
31       first reads from its  configuration  file,  /etc/atalk//papd.conf.  The
32       file  is  in  the  same  format  as  /etc/printcap. See printcap(5) for
33       details. The name of the entry is registered with NBP.
34
35       The following options are supported:
36
37       Name   Type    Default     Description
38        pd    str    '.ppd'       Pathname to  PPD
39                                  file
40        pr    str    'lp'         LPD    or   CUPS
41                                  printer name (or
42                                  pipe  to a print
43                                  command)
44        op    str    'operator'   Operator    name
45                                  for LPD spooling
46        au    bool   false        Whether   to  do
47                                  authenticated
48                                  printing or not
49        ca    str    NULL         Pathname    used
50                                  for    CAP-style
51                                  authentification
52        sp    bool   false        PSSP-style
53                                  authetication
54        am    str    NULL         UAMS to use  for
55                                  authentication
56        pa    str    NULL         Printer's
57                                  AppleTalk
58                                  address
59        co    str    NULL         CUPS  options as
60                                  supplied to  the
61                                  lp(1)    command
62                                  with "-o"
63        fo    bool   false        adjust  lineend‐
64                                  ing          for
65                                  foomatic-rip
66       If no configuration file is given, the hostname of the machine is  used
67       as the NBP name and all options take their default value.
68

OPTIONS

70       -d     Do not fork or disassociate from the terminal. Write some debug‐
71              ging information to stderr.
72
73       -f configfile
74              Consult configfile instead of /etc/atalk//papd.conf for the con‐
75              figuration information.
76
77       -p printcap
78              Consult  printcap instead of /etc/printcap for LPD configuration
79              information.
80

NOTES

82       PSSP (Print Server Security Protocol)  is  an  authentication  protocol
83       carried  out  through  postscript  printer queries to the print server.
84       Using PSSP requires LaserWriter 8.6.1 or greater on the client mac. The
85       user  will be prompted to enter their username and password before they
86       print. It may be necessary to re-setup the printer on each  client  the
87       first  time  PSSP  is  enabled,  so that the client can figure out that
88       authentication  is  required  to  print.  You  can  enable  PSSP  on  a
89       per-printer  basis.  PSSP  is  the recommended method of authenticating
90       printers as it is more robust than CAP-style authentication,  described
91       below.
92
93       CAP-style  authentication gets its name from the method the CAP (Colum‐
94       bia APpletalk) package used to authenticate its mac clients'  printing.
95       This  method  requires  that  a  user login to a file share before they
96       print.  afpd records the username in a temporary file named  after  the
97       client's  Appletalk address, and it deletes the temporary file when the
98       user disconnects. Therefore CAP style authentification  will  not  work
99       for  clients  connected to afpd via TCP/IP. papd gets the username from
100       the file with the same Appletalk address as the machine  connecting  to
101       it.  CAP-style  authentication  will work with any mac client.  If both
102       CAP and PSSP are enabled for a particular printer, CAP  will  be  tried
103       first, then papd will fall back to PSSP.
104
105       The  list  of  UAMs  to use for authentication (specified with the 'am'
106       option) applies to all printers. It is not possible to define different
107       authentication  methods  on  each  printer. You can specify the list of
108       UAMS multiple times, but only the last setting will be used.  Currently
109       only  uams_guest.so and uams_clrtxt.so are supported as printer authen‐
110       tication methods. The guest method requires a valid username, but not a
111       password.   The  Cleartext  UAM  requires both a valid username and the
112       correct password.
113              Note
114
115              As of this writing, Mac OS X makes no use of PSSP authentication
116              any  longer.  CAP-style  authentication  normally  won't  be  an
117              option, too caused by the use of AFP over TCP these days.
118

FILES

120       /etc/atalk//papd.conf
121              Default configuration file.
122
123       /etc/printcap
124              Printer capabilities database.
125
126       .ppd   PostScript Printer Description file. papd answers  configuration
127              and font queries from printing clients by consulting the config‐
128              ured PPD file. Such files are available for download from Adobe,
129              Inc.  (http://www.adobe.com/support/downloads/main.htm), or from
130              the printer's manufacturer. If no PPD file is  configured,  papd
131              will  return  the default answer, possibly causing the client to
132              send excessively large jobs.
133

CAVEATS

135       papd accepts characters with the high bit set (a full 8-bits) from  the
136       clients,  but  some  PostScript  printers  (including  Apple Computer's
137       LaserWriter family) only accept 7-bit characters on their serial inter‐
138       face  by  default.  The  same  applies  for  some printers when they're
139       accessed via TCP/IP methods (remote LPR or socket). You  will  need  to
140       configure  your printer to accept a full 8 bits or take special precau‐
141       tions and convert the printjob's  encoding  (eg.  by  using  co="proto‐
142       col=BCP" when using CUPS 1.1.19 or above).
143
144       When  printing  clients run MacOS 10.2 or above, take care that PPDs do
145       not make use of *cupsFilter: comments unless  the  appropriate  filters
146       are  installed  at the client's side, too (remember: Starting with 10.2
147       Apple chose to integrate CUPS into MacOS X).  For in-depth  information
148       on how CUPS uses PPDs see chapter 3.4 in http://tinyurl.com/zbxn).
149