man/man5/papd.conf.5.tmpl

   1 '\" t
   2 .\"     Title: papd.conf
   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 Sep 2004
   6 .\"    Manual: Netatalk 2.2
   7 .\"    Source: Netatalk 2.2
   8 .\"  Language: English
   9 .\"
  10 .TH "PAPD\&.CONF" "5" "06 Sep 2004" "Netatalk 2.2" "Netatalk 2.2"
  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.conf \- Configuration file used by papd(8) to determine the configuration of printers used by the Netatalk printing daemon
  23 .SH "DESCRIPTION"
  24 .PP
  25 \fB:ETCDIR:/papd\&.conf\fR
  26 is the configuration file used by papd to configure the printing services offered by netatalk\&. Please note that papd must be enabled in
  27 \fB:ETCDIR:/netatalk\&.conf\fR
  28 for this to take any effect\&.
  29 \fBpapd\fR
  30 shares the same defaults as lpd on many systems, but not Solaris\&.
  31 .PP
  32 Any line not prefixed with
  33 \fB#\fR
  34 is interpreted\&. The configuration lines are composed like:
  35 .PP
  36 \fIprintername:[options]\fR
  37 .PP
  38 On systems running a System V printing system the simplest case is to have either no papd\&.conf, or to have one that has no active lines\&. In this case, atalkd should auto\-discover the local printers on the machine\&. Please note that you can split lines by using
  39 \fB\e\efR\&.\fR
  40 .PP
  41 printername may be just a name (\fBPrinter 1\fR), or it may be a full name in nbp_name format (\fBPrinter 1:LaserWriter@My Zone\fR)\&.
  42 .PP
  43 Systems using a BSD printing system should make use of a pipe to the printing command in question within the
  44 \fBpr\fR
  45 option (eg\&.
  46 \fBpr=|/usr/bin/lpr\fR)\&.
  47 .PP
  48 When CUPS support is compiled in, then
  49 \fBcupsautoadd \fR
  50 as the first entry in papd\&.conf will automagically share all CUPS printers by papd utilizing the PPDs assigned in CUPS (customizable \-\- see below)\&. This can be overwritten for individal printers by subsequently adding individual entries using the CUPS queue name as
  51 \fBpr \fR
  52 entry\&. Note: CUPS support is mutually exclusive with System V support described above\&.
  53 .PP
  54 The possible options are colon delimited (\fB:\fR), and lines must be terminated with colons\&. The possible options and flags are:
  55 .PP
  56 \fBam=(uams list)\fR
  57 .RS 4
  58 The
  59 \fBam\fR
  60 option allows specific UAMs to be specified for a particular printer\&. It has no effect if the
  61 \fBau\fR
  62 flag is not present or if papd authentication was not built into netatalk\&. Note: possible values are
  63 \fBuams_guest\&.so\fR
  64 and
  65 \fB uams_clrtxt\&.so\fR
  66 only\&. The first method requires a valid username, but no password\&. The second requires both a valid username and the correct password\&.
  67 .RE
  68 .PP
  69 \fBau\fR
  70 .RS 4
  71 If present, this flag enables authentication for the printer\&. Please note that papd authentication must be built into netatalk for this to take effect\&.
  72 .RE
  73 .PP
  74 \fBco=(CUPS options)\fR
  75 .RS 4
  76 The
  77 \fBco\fR
  78 option allows options to be passed through to CUPS (eg\&.
  79 \fBco="protocol=TBCP" \fR
  80 or
  81 \fBco="raw"\fR)\&.
  82 .RE
  83 .PP
  84 \fBcupsautoadd[:type][@zone]\fR
  85 .RS 4
  86 If used as the first entry in papd\&.conf this will share all CUPS printers via papd\&. type/zone settings as well as other parameters assigned to this special printer share will apply to all CUPS printers\&. Unless the
  87 \fBpd\fR
  88 option is set, the CUPS PPDs will be used\&. To overwrite these global settings for individual printers simply add them subsequently to papd\&.conf and assign different settings\&.
  89 .RE
  90 .PP
  91 \fBfo\fR
  92 .RS 4
  93 If present, this flag enables a hack to translate line endings originating from pre Mac OS X LaserWriter drivers to let
  94 \fBfoomatic\-rip\fR
  95 recognize foomatic PPD options set in the printer dialog\&. Attention: Use with caution since this might corrupt binary print jobs!
  96 .RE
  97 .PP
  98 \fBop=(operator)\fR
  99 .RS 4
 100 This specifies the operator name, for lpd spooling\&.
 101 .RE
 102 .PP
 103 \fBpa=(appletalk address)\fR
 104 .RS 4
 105 Allows specification of Appletalk addresses\&. Usually not needed\&.
 106 .RE
 107 .PP
 108 \fBpd=(path to ppd file)\fR
 109 .RS 4
 110 Specifies a particular PPD (printer description file) to associate with the selected printer\&.
 111 .RE
 112 .PP
 113 \fBpr=(lpd/CUPS printer name or pipe command)\fR
 114 .RS 4
 115 Sets the
 116 \fBlpd\fR
 117 or
 118 \fBCUPS\fR
 119 printer that this is spooled to\&.
 120 .RE
 121 .SH "EXAMPLES"
 122 .PP
 123 Unless CUPS support has been compiled in (which is default from Netatalk 2\&.0 on) one simply defines the lpd queue in question by setting the
 124 \fBpr\fR
 125 parameter to the queue name, in the following example "ps"\&. If no
 126 \fBpr\fR
 127 parameter is set, the default printer will be used\&.
 128 .PP
 129 \fBExample.\ \&papd.conf System V printing system examples\fR
 130 .PP
 131 The first spooler is known by the AppleTalk name Mac Printer Spooler, and uses a PPD file located in
 132 /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\&.
 133 .sp
 134 .if n \{\
 135 .RS 4
 136 .\}
 137 .nf
 138 Mac Printer Spooler:\e
 139    :pr=ps:\e
 140    :pd=/usr/share/lib/ppd/HPLJ_4M\&.PPD:\e
 141    :op=mcs:
 142
 143 HP Printer:\e
 144    :
 145 .fi
 146 .if n \{\
 147 .RE
 148 .\}
 149
 150 .PP
 151 An alternative to the technique outlined above is to direct papd\'s output via a pipe into another program\&. Using this mechanism almost all printing systems can be driven\&.
 152 .PP
 153 \fBExample.\ \&papd.conf examples using pipes\fR
 154 .PP
 155 The first spooler is known as HP 8100\&. It pipes the print job to
 156 \fB/usr/bin/lpr\fR
 157 for printing\&. PSSP authenticated printing is enabled, as is CAP\-style authenticated printing\&. Both methods support guest and cleartext authentication as specified by the \'\fBam\fR\' option\&. The PPD used is
 158 /etc/atalk/ppds/hp8100\&.ppd\&.
 159 .sp
 160 .if n \{\
 161 .RS 4
 162 .\}
 163 .nf
 164 HP 8100:\e
 165    :pr=|/usr/bin/lpr \-Plp:\e
 166    :sp:\e
 167    :ca=/tmp/print:\e
 168    :am=uams_guest\&.so,uams_pam\&.so:\e
 169    :pd=/etc/atalk/ppds/hp8100\&.ppd:
 170
 171 .fi
 172 .if n \{\
 173 .RE
 174 .\}
 175 .sp
 176
 177 .PP
 178 Starting with Netatalk 2\&.0 direct CUPS integration is available\&. In this case, defining only a queue name as
 179 \fBpr\fR
 180 parameter won\'t invoke the SysV lpd daemon but uses CUPS instead\&. Unless a specific PPD has been assigned using the
 181 \fBpd\fR
 182 switch, the PPD configured in CUPS will be used by
 183 \fBpapd\fR, too\&.
 184 .PP
 185 There exists one special share named "cupsautoadd"\&. If this is present as the first entry then all available CUPS queues will be served automagically using the parameters assigned to this global share\&. But subsequent printer definitions can be used to override these global settings for individual spoolers\&.
 186 .PP
 187 \fBExample.\ \&papd.conf CUPS examples\fR
 188 .PP
 189 The first entry sets up automatic sharing of all CUPS printers\&. All those shares appear in the zone "1st floor" and since no additional settings have been made, they use the CUPS printer name as NBP name and use the PPD configured in CUPS\&. The second entry defines different settings for one single CUPS printer\&. It\'s NBP name is differing from the printer\'s name and the registration happens in another zone\&.
 190 .sp
 191 .if n \{\
 192 .RS 4
 193 .\}
 194 .nf
 195 cupsautoadd@1st floor:op=root:
 196
 197 Boss\' LaserWriter@2nd floor:\e
 198    :pr=laserwriter\-chief:
 199 .fi
 200 .if n \{\
 201 .RE
 202 .\}
 203
 204 .SH "SEE ALSO"
 205 .PP
 206 \fBpapd\fR(8),
 207 \fBatalkd.conf\fR(5),
 208 \fBlpd\fR(8),
 209 \fBlpoptions\fR(8)