sys/man/1/lp

   1 .TH LP 1
   2 .SH NAME
   3 lp \- printer output
   4 .SH SYNOPSIS
   5 .B lp
   6 [
   7 .I option ...
   8 ]
   9 [
  10 .I file ...
  11 ]
  12 .SH DESCRIPTION
  13 .I Lp
  14 is a generalized output printing service.
  15 It can be used to queue files for printing,
  16 check a queue, or kill jobs in a queue.
  17 The options are:
  18 .TF -d\ \fIde\fP
  19 .TP
  20 .BI -d " dest"
  21 Select the destination printer.
  22 If
  23 .I dest
  24 is
  25 .LR ? ,
  26 list the currently available printers.
  27 In the absence of
  28 .LR -d ,
  29 the destination is taken from the environment variable
  30 .BR LPDEST .
  31 Destination
  32 .L stdout
  33 is the standard output.
  34 Destination
  35 .L safari
  36 is
  37 .L /dev/lpt1data
  38 line printer port on a 386 machine, assumed
  39 to be connected to a PostScript printer.
  40 Destinations
  41 .L hpdeskjet
  42 and
  43 .L bjc240l
  44 are also
  45 .L /dev/lpt1data
  46 but assumed to be connected to an HP Deskjet 670 or
  47 Canon BJC-240.
  48 .I Lp
  49 can print to any printer supported by
  50 Ghostscript using syntax
  51 .BI gs!device
  52 where
  53 .I device
  54 is a Ghostscript output device.
  55 See
  56 .IR gs (1)
  57 and the
  58 .L canonbjc240l
  59 entry in
  60 .LR /sys/lib/lp/devices .
  61 .TP
  62 .B -k
  63 Kill the job(s) given as subsequent arguments, instead of file names,
  64 for the given destination.
  65 .TP
  66 .BI -p " proc"
  67 The given processor is invoked.
  68 The default processor is
  69 .LR generic ,
  70 which tries to do the right thing for regular text, HTML, or
  71 .IR troff (1)
  72 output.
  73 If no processing is desired
  74 .L noproc
  75 may be specified.
  76 .TP
  77 .B -q
  78 Print the queue for the given destination.
  79 For some devices, include printer status.
  80 .TP
  81 .B -R
  82 Stops and restarts the printer daemon.
  83 If the printer is wedged, it is often useful to cycle the power on the printer
  84 before running this command.
  85 .PD
  86 .PP
  87 The remaining options may be used to affect the output at a given device.
  88 These options may not be applicable to all devices.
  89 .TF "-p\ \fIpr\fP"
  90 .TP
  91 .BI -c " n"
  92 Print
  93 .I n
  94 copies.
  95 .TP
  96 .BI -f " font"
  97 Set the font (default
  98 .LR CW.11 ).
  99 .TP
 100 .BI -H
 101 Suppress printing of header page.
 102 .TP
 103 .BI -i " n"
 104 Select paper input tray.
 105 .I n
 106 may be a number 0-9, the word
 107 .L man
 108 for the manual feed slot, and/or
 109 .L simplex
 110 or
 111 .L duplex
 112 to get single or double sided output.
 113 Multiple input tray options may be specified if they are
 114 separated by commas.
 115 .TP
 116 .BI -l " n"
 117 Set the number of lines per page to
 118 .IR n .
 119 .TP
 120 .B -L
 121 Print pages in landscape mode (i.e. turned 90 degrees).
 122 .TP
 123 .BI -m " v"
 124 Set magnification to
 125 .IR v .
 126 .TP
 127 .BI -n " n"
 128 Print
 129 .I n
 130 logical pages per physical page.
 131 .TP
 132 .BI -o " list"
 133 Print only pages whose page numbers appear in
 134 the comma-separated
 135 .I list
 136 of numbers and ranges.
 137 A range
 138 .IB n - m
 139 means pages
 140 .I n
 141 through
 142 .IR m ;
 143 a range
 144 .BI - n
 145 means from the beginning to page
 146 .IR n ;
 147 a range
 148 .IB n -
 149 means from page
 150 .I n
 151 to the end.
 152 .TP
 153 .B -r
 154 Reverse the order of page printing.
 155 .TP
 156 .BI -x " v"
 157 Set the horizontal
 158 offset of the print image, measured in inches.
 159 .TP
 160 .BI -y " v"
 161 Set the vertical
 162 offset of the print image, measured in inches.
 163 .SH EXAMPLES
 164 .TP 0
 165 .L
 166 eqn paper | troff -ms | lp -dsafari
 167 Typeset and print a paper containing equations.
 168 .TP
 169 .L
 170 pr -l100 file | lp -l100 -fCW.8
 171 Print a file in a small font at 100 lines per page.
 172 .TP
 173 .L
 174 lp -dstdout /dev/windows/3/window > doc.ps
 175 Convert an image to a postscript file.
 176 .SH SOURCE
 177 .nf
 178 .B /rc/bin/lp
 179 .B /sys/src/cmd/lp
 180 .SH SEE ALSO
 181 .IR lp (8)
 182 .br
 183 P. Glick,
 184 ``A Guide to the Lp Printer Spooler''.
 185 .SH BUGS
 186 Not all options work with all output devices.
 187 Any user can kill any job.