man/man8/papstatus.8.tmpl

   1 .TH PAPSTATUS 8 "17 Dec 1991"
   2 .SH NAME
   3 papstatus \- get the status of an AppleTalk-connected printer
   4 .SH SYNOPSIS
   5 .B :SBINDIR:/papstatus
   6 [
   7 .BI -d
   8 ] [
   9 .B -p
  10 .I printer
  11 ] [
  12 .I retrytime
  13 ]
  14 .SH DESCRIPTION
  15 .B papstatus
  16 is used to obtain the current status message from an AppleTalk connected
  17 printer.  It uses the Printer Access Protocol (PAP) to obtain the
  18 status information.
  19 .LP
  20 If no printer is specified on the command line,
  21 .B papstatus
  22 looks for a file called
  23 .B .paprc
  24 in the current directory and reads it to obtain the name of a printer.  The
  25 .B .paprc
  26 file should contain a single line of the form
  27 .IB object : \c
  28 .IB type @ \c
  29 .I zone
  30 where each of
  31 .IR object ,
  32 .BI : type ,
  33 and
  34 .BI @ zone
  35 are optional.
  36 .I type
  37 and
  38 .I zone
  39 must be proceeded by
  40 .RB ` : '
  41 and
  42 .RB ` @ '
  43 respectively.  Blank lines and lines the begin with a
  44 .RB ` # '
  45 are ignored.
  46 .I type
  47 and
  48 .I zone
  49 default to
  50 .B LaserWriter
  51 and the zone of the local host, respectively.
  52 .SH OPTIONS
  53 .TP
  54 .B -d
  55 Turns on a debugging mode that prints some extra information to standard error.
  56 .HP
  57 .B -p
  58 .I printer
  59 .br
  60 Get status from
  61 .I printer
  62 (do not consult any
  63 .B .paprc
  64 files to find a printer name).  The syntax for
  65 .I printer
  66 is the same as discussed above for the
  67 .B .paprc
  68 file.
  69 .TP
  70 .I retrytime
  71 Normally,
  72 .B papstatus
  73 only gets the status from the printer once.  If
  74 .I retrytime
  75 is specified, the status is obtained repeatedly, with a sleep of
  76 .I retrytime
  77 seconds between inquiring the printer.
  78 .SH FILES
  79 .TP 20
  80 .B .paprc
  81 file that contains printer name
  82 .SH SEE ALSO
  83 .BR nbp (1),
  84 .BR pap (8)