man/man8/psf.8.tmpl

   1 '\" t
   2 .\"     Title: psf
   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: 17 Dec 1991
   6 .\"    Manual: Netatalk 2.1
   7 .\"    Source: Netatalk 2.1
   8 .\"  Language: English
   9 .\"
  10 .TH "PSF" "8" "17 Dec 1991" "Netatalk 2.1" "Netatalk 2.1"
  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 psf \- PostScript filter
  23 .SH "SYNOPSIS"
  24 .HP \w'\fBpsf\fR\fB\fR\ 'u
  25 \fBpsf\fR\fB\fR [\-n\ \fIname\fR] [\-h\ \fIhost\fR] [\-w\ \fIwidth\fR] [\-l\ \fIlength\fR] [\-i\ \fIindent\fR] [\-c]
  26 .SH "DESCRIPTION"
  27 .PP
  28 \fBpsf\fR
  29 is an
  30 \fBlpd\fR
  31 filter for PostScript printing\&.
  32 \fBpsf\fR
  33 interprets the name it was called with to determine what filters to invoke\&. First, if the string ``pap\'\' appears anywhere in the name,
  34 \fBpsf\fR
  35 invokes
  36 \fBpap\fR
  37 to talk to a printer via AppleTalk\&. Next, if the string ``rev\'\' appears,
  38 \fBpsf\fR
  39 invokes
  40 \fBpsorder\fR
  41 to reverse the pages of the job\&. Finally, if
  42 \fBpsf\fR
  43 was called with a filter\'s name as the leading string, it invokes that filter\&. If there is no filter to run,
  44 \fBpsf\fR
  45 examines the magic number of the input, and if the input is not PostScript, converts it to PostScript\&.
  46 .SH "KLUDGE"
  47 .PP
  48 In the default configuration,
  49 \fBpsf\fR
  50 supports two kludges\&. The first causes
  51 \fBpsf\fR
  52 to check its name for the letter `m\'\&. If this letter is found and accounting is turned on,
  53 \fBpsf\fR
  54 calls
  55 \fBpap\fR
  56 twice, once to get an initial page count and to print the job, and another time to get a final page count\&. This is a work\-around for bugs in a variety of PAP implementions that cause printers to never properly close the PAP output file\&. A notable example is any printer by Hewlett\-Packard\&.
  57 .PP
  58 The second kludge causes
  59 \fBpsf\fR
  60 to examine its name for the letter `w\'\&. If this letter is found and accounting is turned on,
  61 \fBpsf\fR
  62 calls
  63 \fBpap\fR
  64 with the
  65 \fB\-w\fR
  66 flag\&. This flag causes
  67 \fBpap\fR
  68 to wait until the printer\'s status contains the string `idle\'\&. Once this string is found, the job is printed as normal\&. This kludge is a work\-around for printers, notably Hewlett\-Packard\'s LaserJet IV, which will report a page count while a previous jobs is still printing\&.
  69 .SH "EXAMPLE"
  70 .PP
  71 The sample
  72 \fBprintcap\fR
  73 entry below invokes
  74 \fBpsf\fR
  75 to print text files, PostScript files,
  76 \fBtroff\fR\'s C/A/T output, and
  77 \fBTeX\fR\'s DVI output, to an AppleTalk connected LaserWriter Plus\&. Since the LaserWriter Plus stacks pages in descending order, we reverse the pages and print the burst page last\&.
  78 .sp
  79 .if n \{\
  80 .RS 4
  81 .\}
  82 .nf
  83 laser|lp|LaserWriter Plus on AppleTalk:\e
  84     :sd=/usr/spool/lpd/laser:\e
  85     :lp=/usr/spool/lpd/laser/null:\e
  86     :lf=/var/adm/lpd\-errs:pw#80:hl:\e
  87     :of=:LIBEXECDIR:/ofpap:\e
  88     :if=:LIBEXECDIR:/ifpaprev:\e
  89     :tf=:LIBEXECDIR:/tfpaprev:\e
  90     :df=:LIBEXECDIR:/dfpaprev:
  91 .fi
  92 .if n \{\
  93 .RE
  94 .\}
  95 .PP
  96 Note that if the host in question spools to more than one AppleTalk printer,
  97 /dev/null
  98 should not be used for the
  99 \fBlp\fR
 100 capability\&. Instead, a null device should be created with
 101 \fBmknod\fR
 102 for each printer, as has been done above\&.
 103 .PP
 104 Finally, there is a file in the spool directory,
 105 /var/spool/lpd/laser, called
 106 \fB\&.paprc\fR, which
 107 \fBpap\fR
 108 reads for the AppleTalk name of the printer\&.
 109 .SH "SEE ALSO"
 110 .PP
 111 \fBpsorder\fR(1),
 112 \fBprintcap\fR(5),
 113 \fBlpd\fR(1),
 114 \fBmknod\fR(1),
 115 \fBpap\fR(1)\&.