~ubuntu-branches/ubuntu/precise/netatalk/precise

« back to all changes in this revision

Viewing changes to man/man8/papd.8.tmpl

  • Committer: Bazaar Package Importer
  • Author(s): Sebastian Rittau
  • Date: 2004-01-19 12:43:49 UTC
  • Revision ID: james.westby@ubuntu.com-20040119124349-es563jbp0hk0ae51
Tags: upstream-1.6.4
ImportĀ upstreamĀ versionĀ 1.6.4

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
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.