.TH LP 1 
.SH NAME
lp \- printer output
.SH SYNOPSIS
.B lp
[
.I option ...
]
[
.I file ...
]
.SH DESCRIPTION
.I Lp
is a generalized output printing service.
It can be used to queue files for printing,
check a queue, or kill jobs in a queue.
The options are:
.TF -p\ \fIproc\fP
.TP
.BI -d " dest"
Select the destination printer.
If
.I dest
is
.LR ? ,
list the currently available printers.
In the absence of
.LR -d ,
the destination is taken from the environment variable
.BR LPDEST .
Destination
.L stdout
is the standard output.
Destination
.L safari
is
.L /dev/lpt1data
line printer port on a 386 machine.
.TP
.BI -p " proc"
The given preprocessor is invoked.
The default preprocessor is
.LR generic ,
which tries to do the right thing for regular text, 
.IR troff (1)
output, or 
.IR tex (1)
output.
If no preprocessing is desired
.L noproc
may be specified.
.TP
.B -q
Print the queue for the given destination.
For some devices, include printer status.
.TP
.B -k
Kill the job(s) given as subsequent arguments instead of file names
for the given destination.
.PD
.PP
The remaining options may be used to affect the output at a given device.
These options may not be applicable to all devices.
.TF -p\ \fIproc\fP
.TP
.BI -c " n"
Print
.I n
copies.
.TP
.BI -f " font"
Set the font (default
.LR CW.11 ).
.TP
.BI -H
Suppress printing of header page.
.TP
.BI -i " n"
Select paper input tray
.I n.
.TP
.BI -l " n"
Set the number of lines per page to
.I n.
.TP
.B -L
Print pages in landscape mode (i.e. turned 90 degrees).
.TP
.BI -m " v"
Set magnification to
.I v.
.TP
.BI -n " n"
Print
.I n
logical pages per physical page.
.TP
.BI -o " list"
Print only pages whose page numbers appear in
the comma-separated
.I list
of numbers and ranges.
A range
.IB n - m
means pages
.I n
through
.IR m ;
a range
.BI - n
means from the beginning to page
.IR n ;
a range
.IB n -
means from page
.I n
to the end. 
.TP
.B -r
Reverse the order of page printing (currently not functional).
.TP
.BI -x " v"
Set the horizontal
offset of the print image, measured in inches.
.TP
.BI -y " v"
Set the vertical
offset of the print image, measured in inches.
.SH EXAMPLES
.TP 0
.L
eqn paper | troff -ms | lp -dsafari
Typeset and print a paper containing equations.
.TP
.L
pr -l100 file | lp -l100 -fCW.8
Print a file in a small font at 100 lines per page.
.TP
.L
lp -dstdout /dev/windows/3/window > doc.ps
Convert a bitmap to a postscript file.
.SH SEE ALSO
.IR lp (8)
.br
.I
A Guide to the Lp Printer Spooler,
P. Glick,
.I
Unix Programmer's Manual,
Tenth Edition, Volume 2.
.SH BUGS
Not all options work with all output devices.
Any user can kill any job.
.I Lp
will accept jobs from BSD style lpdaemons but cannot
send jobs to such systems.
