man/man1/pap.1

   1 .TH PAP 1 "6 May 2002" "netatalk 1.5"
   2 .SH NAME
   3 pap, papstatus \- client interface to remote printers using Printer Access Protocol
   4 .SH SYNOPSIS
   5 .B pap
   6 [
   7 .B -A
   8 .I address
   9 ] [
  10 .B -c
  11 ] [
  12 .B -d
  13 ] [
  14 .B -e
  15 ] [
  16 .B -E
  17 ] [
  18 .B -p
  19 .I nbpname
  20 ] [
  21 .B -s
  22 .I statusfile
  23 ] [
  24 .B -w
  25 ] [
  26 .B -W
  27 ] [
  28 .I FILES
  29 ]
  30 .sp
  31 .B papstatus
  32 [
  33 .B -p
  34 .I nbpname
  35 ]
  36 .SH DESCRIPTION
  37 .B pap
  38 is used to connect and send files to an AppleTalk connected printer using
  39 the Apple Printer Access Protocol (PAP).
  40 When
  41 .B pap
  42 starts execution, it
  43 tries to open a session with the printer using PAP, and
  44 then downloads the
  45 .I files
  46 to the printer.
  47 .LP
  48 If no
  49 .I files
  50 are given on the command line,
  51 .B pap
  52 begins reading from standard input.
  53 .LP
  54 If no printer is specified on the command line,
  55 .B pap
  56 looks for a file called
  57 .B .paprc
  58 in the current working directory and reads it to obtain the
  59 .I nbpname
  60 of a
  61 printer.
  62 Blank lines and lines that begin with a
  63 .RB ` # '
  64 are ignored.
  65 .I type
  66 and
  67 .I zone
  68 default to
  69 .B LaserWriter
  70 and the zone of the local host, respectively.
  71 .LP
  72 Note that
  73 .B pap
  74 is designed to be useful as a communication filter for sending
  75 .BR lpd (8)
  76 spooled print jobs to AppleTalk connected printers.  See
  77 .BR psf (8)
  78 for hints on how to use it this way.
  79 .SH OPTIONS
  80 .HP
  81 .B -A
  82 .I address
  83 .br
  84 Connect to the printer with Appletalk address
  85 .I address
  86 and do not consult the
  87 .B .paprc
  88 file to find a printer name.  See
  89 .BR atalk_aton (3)
  90 for the syntax of
  91 .IR address .
  92 .TP
  93 .B -c
  94 Take cuts.  The PAP protocol specified a simple queuing
  95 procedure, such that the clients tell the printer how long
  96 they have been waiting to print.  This option causes
  97 .B pap
  98 to lie about how long it has been waiting.
  99 .TP
 100 .B -d
 101 Enable debug output.
 102 .TP
 103 .B -e
 104 Send any message from the printer to stderr instead of stdout.
 105 .BR psf (8)
 106 invokes
 107 .B pap
 108 with this option.
 109 .TP
 110 .B -E
 111 Don't wait for EOF from the printer.  This option is useful
 112 for printers which don't implement PAP correctly.  In a correct
 113 implementation, the client side should wait for the printer to
 114 return EOF before closing the connection.  Some clients don't
 115 wait, and hence some printers have related bugs in their
 116 implementation.
 117 .HP
 118 .B -p
 119 .I nbpname
 120 .br
 121 Connect to the printer named
 122 .I nbpname
 123 and do not consult the
 124 .B .paprc
 125 file to find a printer name.  See
 126 .BR nbp_name (3)
 127 for the syntax of
 128 .IR nbpname .
 129 .HP
 130 .B -s
 131 .I statusfile
 132 .br
 133 Update the file called
 134 .I statusfile
 135 to contain the most recent status message from the printer.
 136 .B pap
 137 gets the status from the printer when it is waiting for the printer to
 138 process input.  The
 139 .I statusfile
 140 will contain a single line terminated with a newline.  This is useful
 141 when
 142 .B pap
 143 is invoked by
 144 .BR psf (8)
 145 within
 146 .BR lpd 's
 147 spool directory.
 148 .TP
 149 .B -w
 150 Wait for the printer status to contain the word "waiting" before
 151 sending the job.  This is to defeat printer-side spool available
 152 on HP IV and V printers.
 153 .TP
 154 .B -W
 155 Wait for the printer status to contain the word "idle" before
 156 sending the job.  This is to defeat printer-side spool available
 157 on HP IV and V printers.
 158 .SH FILES
 159 .TP 20
 160 .B .paprc
 161 file read to obtain printer name if not specified on command line
 162 .SH SEE ALSO
 163 .BR nbp_name (3),
 164 .BR atalk_aton (3),
 165 .BR lpd (8),
 166 .BR psf (8).