]> arthur.barton.de Git - netatalk.git/blob - man/man8/papstatus.8.tmpl
- merge branch-netatalk-afp-3x-dev, HEAD was tagged before
[netatalk.git] / man / man8 / papstatus.8.tmpl
1 .TH papstatus 8 "17 Dec 1991" 2.0.0 Netatalk 
2 .SH NAME
3 papstatus \- get the status of an AppleTalk\-connected printer
4 .SH SYNOPSIS
5 \fB:SBINDIR:/papstatus\fR [\-d] [ \-p \fBprinter\fR ] [\fBretrytime\fR]
6 .SH DESCRIPTION
7 \fIpapstatus\fR is used to obtain the
8 current status message from an AppleTalk connected printer. It uses the
9 Printer Access Protocol (PAP) to obtain the status information.
10 .PP
11 If no printer is specified on the command line, \fIpapstatus\fR
12 looks for a file called .paprc in the current directory
13 and reads it to obtain the name of a printer. The .paprc
14 file should contain a single line of the form \fIobject\fR\fI:\fR\fI\fR\fItype\fR\fI@\fR\fI\fR\fIzone\fR
15 where each of \fIobject\fR, \fI:\fR\fItype\fR\fI,\fR and \fI@\fR\fIzone\fR are optional.
16 \fItype\fR and \fIzone\fR
17 must be proceeded by `\fI:\fR' and `\fI@\fR' respectively. Blank lines and lines the begin
18 with a `\fI#\fR' are ignored. \fItype\fR and \fIzone\fR default
19 to \fILaserWriter\fR and the zone of the local
20 host, respectively.
21 .SH OPTIONS
22 .TP 
23 \fB\-d\fR
24 Turns on a debugging mode that prints some extra information
25 to standard error.
26 .TP 
27 \fB\-p\fR \fIprinter\fR
28 Get status from \fIprinter\fR (do not
29 consult any .paprc files to find a printer name).
30 The syntax for \fIprinter\fR is the same as
31 discussed above for the .paprc file.
32 .TP 
33 \fIretrytime\fR
34 Normally, \fIpapstatus\fR only gets
35 the status from the printer once. If \fIretrytime\fR
36 is specified, the status is obtained repeatedly, with a sleep of
37 \fIretrytime\fR seconds between inquiring
38 the printer.
39 .SH FILES
40 .TP 
41 \&.paprc
42 file that contains printer name
43 .SH "SEE ALSO"
44 \fBnbp\fR(1),
45 \fBpap\fR(1)
46