]> arthur.barton.de Git - netatalk.git/blob - man/man1/pap.1
mirror manpages from XML for 2.0.1
[netatalk.git] / man / man1 / pap.1
1 .TH pap 1 "6 May 2002" 2.0.1 Netatalk 
2 .SH NAME
3 pap \- client interface to remote printers using Printer Access Protocol
4 .SH SYNOPSIS
5 \fBpap\fR [ \-A \fBaddress\fR ] [\-c] [\-d] [\-e] [\-E] [ \-p \fBnbpname\fR ] [ \-s \fBstatusfile\fR ] [\-w] [\-W] [\fBFILES\fR]
6 .SH DESCRIPTION
7 pap is used to connect and send files to an
8 AppleTalk connected printer using the Apple Printer Access Protocol (PAP).
9 When pap starts execution, it tries to open a session
10 with the printer using PAP, and then downloads the \fIfiles\fR
11 to the printer.
12 .PP
13 If no \fIfiles\fR are given on the command
14 line, pap begins reading from standard input.
15 .PP
16 If no printer is specified on the command line, pap
17 looks for a file called .paprc in the current working
18 directory and reads it to obtain the \fInbpname\fR
19 of a printer. Blank lines and lines that begin with a `\fI#\fR'
20 are ignored. \fItype\fR and \fIzone\fR
21 default to \fILaserWriter\fR and the zone of the
22 local host, respectively.
23 .PP
24 Note that pap is designed to be useful as a
25 communication filter for sending \fBlpd\fR(8)
26 spooled print jobs to AppleTalk connected printers. See
27 \fBpsf\fR(8)
28 for hints on how to use it this way.
29 .SH OPTIONS
30 .TP 
31 \fB\-A \fR\fIaddress\fR
32 Connect to the printer with Appletalk address \fIaddress\fR and do not consult the
33 \&.paprc file to find a printer name. See
34 \fBatalk_aton\fR(3)
35 for the syntax of \fIaddress\fR.
36 .TP 
37 \fB\-c\fR
38 Take cuts. The PAP protocol specified a simple queuing
39 procedure, such that the clients tell the printer how long they have
40 been waiting to print. This option causes pap to
41 lie about how long it has been waiting.
42 .TP 
43 \fB\-d\fR
44 Enable debug output.
45 .TP 
46 \fB\-e\fR
47 Send any message from the printer to stderr instead of stdout.
48 \fBpsf\fR(8)
49 invokes pap with this option.
50 .TP 
51 \fB\-E\fR
52 Don't wait for EOF from the printer. This option is useful
53 for printers which don't implement PAP correctly. In a correct
54 implementation, the client side should wait for the printer to
55 return EOF before closing the connection. Some clients don't
56 wait, and hence some printers have related bugs in their
57 implementation.
58 .TP 
59 \fB\-p\fR \fInbpname\fR
60 Connect to the printer named \fInbpname\fR
61 and do not consult the .paprc file to find a
62 printer name. See \fBnbp_name\fR(3)
63 for the syntax of \fInbpname\fR.
64 .TP 
65 \fB\-s\fR \fIstatusfile\fR
66 Update the file called \fIstatusfile\fR
67 to contain the most recent status message from the printer.
68 pap gets the status from the printer when it is
69 waiting for the printer to process input. The \fIstatusfile\fR
70 will contain a single line terminated with a newline. This is useful
71 when pap is invoked by
72 \fBpsf\fR(8)
73 within \fIlpd\fR's spool directory.
74 .TP 
75 \fB\-w\fR
76 Wait for the printer status to contain the word
77 "waiting" before sending the job. This is to defeat
78 printer\-side spool available on HP IV and V printers.
79 .TP 
80 \fB\-W\fR
81 Wait for the printer status to contain the word "idle"
82 before sending the job. This is to defeat printer\-side spool
83 available on HP IV and V printers.
84 .SH FILES
85 .TP 
86 \&.paprc
87 file read to obtain printer name if not specified on command
88 line
89 .SH "SEE ALSO"
90 \fBnbp_name\fR(3),
91 \fBatalk_aton\fR(3),
92 \fBlpd\fR(8),
93 \fBpsf\fR(8).
94