man/man8/papstatus.8.tmpl

   1 '\" t
   2 .\"     Title: papstatus
   3 .\"    Author: [FIXME: author] [see http://docbook.sf.net/el/author]
   4 .\" Generator: DocBook XSL Stylesheets v1.74.3 <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 "PAPSTATUS" "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 papstatus \- get the status of an AppleTalk\-connected printer
  23 .SH "SYNOPSIS"
  24 .HP \w'\fB:SBINDIR:/papstatus\fR\fB\fR\ 'u
  25 \fB:SBINDIR:/papstatus\fR\fB\fR [\-d] [\-p\ \fIprinter\fR] [\fIretrytime\fR]
  26 .SH "DESCRIPTION"
  27 .PP
  28 \fBpapstatus\fR
  29 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\&.
  30 .PP
  31 If no printer is specified on the command line,
  32 \fBpapstatus\fR
  33 looks for a file called
  34 \fB\&.paprc\fR
  35 in the current directory and reads it to obtain the name of a printer\&. The
  36 \fB\&.paprc\fR
  37 file should contain a single line of the form
  38 \fIobject\fR\fB:\fR\fItype\fR\fB@\fR\fIzone\fR
  39 where each of
  40 \fIobject\fR,
  41 \fB:\fR\fItype\fR\fB,\fR
  42 and
  43 \fB@\fR\fIzone\fR
  44 are optional\&.
  45 \fItype\fR
  46 and
  47 \fIzone\fR
  48 must be proceeded by `\fB:\fR\' and `\fB@\fR\' respectively\&. Blank lines and lines the begin with a `\fB#\fR\' are ignored\&.
  49 \fItype\fR
  50 and
  51 \fIzone\fR
  52 default to
  53 \fBLaserWriter\fR
  54 and the zone of the local host, respectively\&.
  55 .SH "OPTIONS"
  56 .PP
  57 \fB\-d\fR
  58 .RS 4
  59 Turns on a debugging mode that prints some extra information to standard error\&.
  60 .RE
  61 .PP
  62 \fB\-p\fR \fIprinter\fR
  63 .RS 4
  64 Get status from
  65 \fIprinter\fR
  66 (do not consult any
  67 \fB\&.paprc\fR
  68 files to find a printer name)\&. The syntax for
  69 \fIprinter\fR
  70 is the same as discussed above for the
  71 \fB\&.paprc\fR
  72 file\&.
  73 .RE
  74 .PP
  75 \fIretrytime\fR
  76 .RS 4
  77 Normally,
  78 \fBpapstatus\fR
  79 only gets the status from the printer once\&. If
  80 \fIretrytime\fR
  81 is specified, the status is obtained repeatedly, with a sleep of
  82 \fIretrytime\fR
  83 seconds between inquiring the printer\&.
  84 .RE
  85 .SH "FILES"
  86 .PP
  87 \fB\&.paprc\fR
  88 .RS 4
  89 file that contains printer name
  90 .RE
  91 .SH "SEE ALSO"
  92 .PP
  93 \fBnbp\fR(1),
  94 \fBpap\fR(1)