man/man1/pap.1

   1 '\" t
   2 .\"     Title: pap
   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: 6 May 2002
   6 .\"    Manual: Netatalk 2.2
   7 .\"    Source: Netatalk 2.2
   8 .\"  Language: English
   9 .\"
  10 .TH "PAP" "1" "6 May 2002" "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 pap \- client interface to remote printers using Printer Access Protocol
  23 .SH "SYNOPSIS"
  24 .HP \w'\fBpap\fR\fB\fR\ 'u
  25 \fBpap\fR\fB\fR [\-A\ \fIaddress\fR] [\-c] [\-d] [\-e] [\-E] [\-p\ \fInbpname\fR] [\-s\ \fIstatusfile\fR] [\-w] [\-W] [\fIFILES\fR]
  26 .SH "DESCRIPTION"
  27 .PP
  28 \fBpap\fR
  29 is used to connect and send files to an AppleTalk connected printer using the Apple Printer Access Protocol (PAP)\&. When
  30 \fBpap\fR
  31 starts execution, it tries to open a session with the printer using PAP, and then downloads the
  32 \fIfiles\fR
  33 to the printer\&.
  34 .PP
  35 If no
  36 \fIfiles\fR
  37 are given on the command line,
  38 \fBpap\fR
  39 begins reading from standard input\&.
  40 .PP
  41 If no printer is specified on the command line,
  42 \fBpap\fR
  43 looks for a file called
  44 \fB\&.paprc\fR
  45 in the current working directory and reads it to obtain the
  46 \fInbpname\fR
  47 of a printer\&. Blank lines and lines that begin with a `\fB#\fR\' are ignored\&.
  48 \fItype\fR
  49 and
  50 \fIzone\fR
  51 default to
  52 \fBLaserWriter\fR
  53 and the zone of the local host, respectively\&.
  54 .PP
  55 Note that
  56 \fBpap\fR
  57 is designed to be useful as a communication filter for sending
  58 \fBlpd\fR(8)
  59 spooled print jobs to AppleTalk connected printers\&. See
  60 \fBpsf\fR(8)
  61 for hints on how to use it this way\&.
  62 .SH "OPTIONS"
  63 .PP
  64 \fB\-A \fR\fIaddress\fR
  65 .RS 4
  66 Connect to the printer with Appletalk address
  67 \fIaddress\fR
  68 and do not consult the
  69 \fB\&.paprc\fR
  70 file to find a printer name\&. See
  71 \fBatalk_aton\fR(3)
  72 for the syntax of
  73 \fIaddress\fR\&.
  74 .RE
  75 .PP
  76 \fB\-c\fR
  77 .RS 4
  78 Take cuts\&. The PAP protocol specified a simple queuing procedure, such that the clients tell the printer how long they have been waiting to print\&. This option causes
  79 \fBpap\fR
  80 to lie about how long it has been waiting\&.
  81 .RE
  82 .PP
  83 \fB\-d\fR
  84 .RS 4
  85 Enable debug output\&.
  86 .RE
  87 .PP
  88 \fB\-e\fR
  89 .RS 4
  90 Send any message from the printer to stderr instead of stdout\&.
  91 \fBpsf\fR(8)
  92 invokes
  93 \fBpap\fR
  94 with this option\&.
  95 .RE
  96 .PP
  97 \fB\-E\fR
  98 .RS 4
  99 Don\'t wait for EOF from the printer\&. This option is useful for printers which don\'t implement PAP correctly\&. In a correct implementation, the client side should wait for the printer to return EOF before closing the connection\&. Some clients don\'t wait, and hence some printers have related bugs in their implementation\&.
 100 .RE
 101 .PP
 102 \fB\-p\fR \fInbpname\fR
 103 .RS 4
 104 Connect to the printer named
 105 \fInbpname\fR
 106 and do not consult the
 107 \fB\&.paprc\fR
 108 file to find a printer name\&. See
 109 \fBnbp_name\fR(3)
 110 for the syntax of
 111 \fInbpname\fR\&.
 112 .RE
 113 .PP
 114 \fB\-s\fR \fIstatusfile\fR
 115 .RS 4
 116 Update the file called
 117 \fIstatusfile\fR
 118 to contain the most recent status message from the printer\&.
 119 \fBpap\fR
 120 gets the status from the printer when it is waiting for the printer to process input\&. The
 121 \fIstatusfile\fR
 122 will contain a single line terminated with a newline\&. This is useful when
 123 \fBpap\fR
 124 is invoked by
 125 \fBpsf\fR(8)
 126 within
 127 \fBlpd\fR\'s spool directory\&.
 128 .RE
 129 .PP
 130 \fB\-w\fR
 131 .RS 4
 132 Wait for the printer status to contain the word "waiting" before sending the job\&. This is to defeat printer\-side spool available on HP IV and V printers\&.
 133 .RE
 134 .PP
 135 \fB\-W\fR
 136 .RS 4
 137 Wait for the printer status to contain the word "idle" before sending the job\&. This is to defeat printer\-side spool available on HP IV and V printers\&.
 138 .RE
 139 .SH "FILES"
 140 .PP
 141 \fB\&.paprc\fR
 142 .RS 4
 143 file read to obtain printer name if not specified on command line
 144 .RE
 145 .SH "SEE ALSO"
 146 .PP
 147 \fBnbp_name\fR(3),
 148 \fBatalk_aton\fR(3),
 149 \fBlpd\fR(8),
 150 \fBpsf\fR(8)\&.