'\" t
.\"     Title: papstatus
.\"    Author: [FIXME: author] [see http://docbook.sf.net/el/author]
.\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>
.\"      Date: 17 Dec 1991
.\"    Manual: Netatalk 2.1
.\"    Source: Netatalk 2.1
.\"  Language: English
.\"
.TH "PAPSTATUS" "8" "17 Dec 1991" "Netatalk 2.1" "Netatalk 2.1"
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
papstatus \- get the status of an AppleTalk\-connected printer
.SH "SYNOPSIS"
.HP \w'\fB:SBINDIR:/papstatus\fR\fB\fR\ 'u
\fB:SBINDIR:/papstatus\fR\fB\fR [\-d] [\-p\ \fIprinter\fR] [\fIretrytime\fR]
.SH "DESCRIPTION"
.PP
\fBpapstatus\fR
is used to obtain the current status message from an AppleTalk connected printer\&. It uses the Printer Access Protocol (PAP) to obtain the status information\&.
.PP
If no printer is specified on the command line,
\fBpapstatus\fR
looks for a file called
\fB\&.paprc\fR
in the current directory and reads it to obtain the name of a printer\&. The
\fB\&.paprc\fR
file should contain a single line of the form
\fIobject\fR\fB:\fR\fItype\fR\fB@\fR\fIzone\fR
where each of
\fIobject\fR,
\fB:\fR\fItype\fR\fB,\fR
and
\fB@\fR\fIzone\fR
are optional\&.
\fItype\fR
and
\fIzone\fR
must be proceeded by `\fB:\fR\' and `\fB@\fR\' respectively\&. Blank lines and lines the begin with a `\fB#\fR\' are ignored\&.
\fItype\fR
and
\fIzone\fR
default to
\fBLaserWriter\fR
and the zone of the local host, respectively\&.
.SH "OPTIONS"
.PP
\fB\-d\fR
.RS 4
Turns on a debugging mode that prints some extra information to standard error\&.
.RE
.PP
\fB\-p\fR \fIprinter\fR
.RS 4
Get status from
\fIprinter\fR
(do not consult any
\fB\&.paprc\fR
files to find a printer name)\&. The syntax for
\fIprinter\fR
is the same as discussed above for the
\fB\&.paprc\fR
file\&.
.RE
.PP
\fIretrytime\fR
.RS 4
Normally,
\fBpapstatus\fR
only gets the status from the printer once\&. If
\fIretrytime\fR
is specified, the status is obtained repeatedly, with a sleep of
\fIretrytime\fR
seconds between inquiring the printer\&.
.RE
.SH "FILES"
.PP
\fB\&.paprc\fR
.RS 4
file that contains printer name
.RE
.SH "SEE ALSO"
.PP
\fBnbp\fR(1),
\fBpap\fR(1)