.\"
-.\" "$Id: lp.man 4493 2005-02-18 02:09:53Z mike $"
+.\" "$Id: lp.man 5099 2006-02-13 02:46:10Z mike $"
.\"
-.\" lp/cancel man page for the Common UNIX Printing System (CUPS).
+.\" lp man page for the Common UNIX Printing System (CUPS).
.\"
-.\" Copyright 1997-2005 by Easy Software Products.
+.\" Copyright 1997-2006 by Easy Software Products.
.\"
.\" These coded instructions, statements, and computer programs are the
.\" property of Easy Software Products and are protected by Federal
.\" EMail: cups-info@cups.org
.\" WWW: http://www.cups.org
.\"
-.TH lp 1 "Common UNIX Printing System" "1 May 2003" "Easy Software Products"
+.TH lp 1 "Common UNIX Printing System" "12 February 2006" "Easy Software Products"
.SH NAME
-lp \- print files
-.br
-cancel \- cancel jobs
+lp - print files
.SH SYNOPSIS
.B lp
-[ -E ] [ \-c ] [ \-d
-.I destination
-] [ \-h
-.I server
-] [ \-m ] [ \-n
+[ -E ] [ -U
+.I username
+] [ -c ] [ -d
+.I destination[/instance]
+] [ -h
+.I hostname[:port]
+] [ -m ] [ -n
.I num-copies
-[ \-o
-.I option
-] [ \-q
+[ -o
+.I option[=value]
+] [ -q
.I priority
-] [ \-s ] [ \-t
+] [ -s ] [ -t
.I title
-] [ \-H
+] [ -H
.I handling
-] [ \-P
+] [ -P
.I page-list
-] [
+] [ -- ] [
.I file(s)
]
.br
.B lp
-[ -E ] [ \-c ] [ \-h
-.I server
-] [ \-i
+[ -E ] [ -U
+.I username
+] [ -c ] [ -h
+.I hostname[:port]
+] [ -i
.I job-id
-] [ \-n
+] [ -n
.I num-copies
-[ \-o
-.I option
-] [ \-q
+[ -o
+.I option[=value]
+] [ -q
.I priority
-] [ \-t
+] [ -t
.I title
-] [ \-H
+] [ -H
.I handling
-] [ \-P
+] [ -P
.I page-list
]
-.br
-.B cancel
-[ \-a ] [ -h
-.I server
-] [ -u
-.I username
-] [
-.I id
-] [
-.I destination
-] [
-.I destination-id
-]
.SH DESCRIPTION
-\fBlp\fR submits files for printing or alters a pending job. Use
+\fIlp\fR submits files for printing or alters a pending job. Use
a filename of "-" to force printing from the standard input.
-.LP
-\fBcancel\fR cancels existing print jobs. The \fI-a\fR option will remove
-all jobs from the specified destination.
.SH OPTIONS
-The following options are recognized by \fBlp\fR:
+The following options are recognized by \fIlp\fR:
.TP 5
-\-E
+--
+.br
+Marks the end of options; use this to print a file whose name
+begins with a dash (-).
+.TP 5
+-E
.br
Forces encryption when connecting to the server.
.TP 5
-\-c
+-U username
+.br
+Specifies the username to use when connecting to the server.
+.TP 5
+-c
.br
This option is provided for backwards-compatibility only. On
systems that support it, this option forces the print file to be
files are always sent to the scheduler via IPP which has the
same effect.
.TP 5
-\-d \fIdestination\fR
+-d destination
.br
Prints files to the named printer.
.TP 5
-\-h \fIhostname\fR
+-h hostname[:port]
.br
-Specifies the print server hostname. The default is "localhost" or the value
-of the CUPS_SERVER environment variable.
+Chooses an alternate server.
.TP 5
-\-i \fIjob-id\fR
+-i job-id
.br
Specifies an existing job to modify.
.TP 5
-\-m
+-m
.br
-Send email when the job is completed (not supported CUPS 1.1.)
+Sends an email when the job is completed.
.TP 5
-\-n \fIcopies\fR
+-n copies
.br
Sets the number of copies to print from 1 to 100.
.TP 5
-\-o \fIoption\fR
+-o "name=value [name=value ...]"
.br
-Sets a job option.
+Sets one or more job options.
.TP 5
-\-q \fIpriority\fR
+-q priority
.br
Sets the job priority from 1 (lowest) to 100 (highest). The
default priority is 50.
.TP 5
-\-s
+-s
.br
Do not report the resulting job IDs (silent mode.)
.TP 5
-\-t \fIname\fR
+-t "name"
.br
Sets the job name.
.TP 5
-\-u \fIusername\fR
+-u username
.br
-Cancels jobs owned by \fIusername\fR.
+Submits jobs as \fIusername\fR.
+.TP 5
+-H hh:mm
+.TP 5
+-H hold
+.TP 5
+-H immediate
+.TP 5
+-H restart
.TP 5
-\-H \fIhandling\fR
+-H resume
.br
Specifies when the job should be printed. A value of
\fIimmediate\fR will print the file immediately, a value of
Use a value of \fIrestart\fR with the \fI-i\fR option to restart
a completed job.
.TP 5
-\-P \fIpage-list\fR
+-P page-list
+.br
+Specifies which pages to print in the document. The list can
+contain a list of numbers and ranges (#-#) separated by commas
+(e.g. 1,3-5,16).
+.SH COMMON JOB OPTIONS
+Aside from the printer-specific options reported by the
+\fIlpoptions(1)\fR command, the following generic options are
+available:
+.TP 5
+-o media=size
.br
-Specifies which pages to print in the document. The list can contain a
-list of numbers and ranges (#-#) separated by commas (e.g. 1,3-5,16).
-.SH COMPATIBILITY
-Unlike the System V printing system, CUPS allows printer names to contain
-any printable character except SPACE and TAB. Also, printer and class names are
-\fBnot\fR case-sensitive.
+Sets the page size to \fIsize\fR. Most printers support at least
+the size names "a4", "letter", and "legal".
+.TP 5
+-o landscape
+.TP 5
+-o orientation-requested=4
+.br
+Prints the job in landscape (rotated 90 degrees).
+.TP 5
+-o sides=one-sided
+.TP 5
+-o sides=two-sided-long-edge
+.TP 5
+-o sides=two-sided-short-edge
+.br
+Prints on one or two sides of the paper. The value
+"two-sided-long-edge" is normally used when printing portrait
+(unrotated) pages, while "two-sided-short-edge" is used for
+landscape pages.
+.TP 5
+-o fitplot
+.br
+Scales the print file to fit on the page.
+.TP 5
+-o scaling=number
+.br
+Scales image files to use up to \fInumber\fR percent of the page.
+Values greater than 100 cause the image file to be printed across
+multiple pages.
+.TP 5
+-o cpi=N
+.br
+Sets the number of characters per inch to use when printing a
+text file. The default is 10.
+.TP 5
+-o lpi=N
+.br
+Sets the number of lines per inch to use when printing a text
+file. The default is 6.
+.TP 5
+-o page-bottom=N
+.TP 5
+-o page-left=N
+.TP 5
+-o page-right=N
+.TP 5
+-o page-top=N
+.br
+Sets the page margins when printing text files. The values are in
+points - there are 72 points to the inch.
+.SH EXAMPLES
+Print a double-sided legal document to a printer called "foo":
+.nf
+ lp -d foo -o media=legal -o sides=two-sided-long-edge filename
+.fi
+.LP
+Print an image across 4 pages:
+.nf
+ lp -d bar -o scaling=200 filename
+.fi
.LP
-The "m" option is not functional in CUPS 1.1.
+Print a text file with 12 characters per inch, 8 lines per inch, and
+a 1 inch left margin:
+.nf
+ lp -d bar -o cpi=12 -o lpi=8 -o page-left=72 filename
+.fi
+.SH COMPATIBILITY
+Unlike the System V printing system, CUPS allows printer names to
+contain any printable character except SPACE, TAB, "/", or "#".
+Also, printer and class names are \fInot\fR case-sensitive.
.LP
The "q" option accepts a different range of values than the
-Solaris lp command, matching the IPP job priority values (1-100)
-instead of the Solaris values (0-39).
-.SH NOTES
-Administrators wishing to prevent unauthorized cancellation of
-jobs via the \fI-u\fR option should password-protect the /jobs
-location in \fIcupsd.conf(5)\fR.
+Solaris lp command, matching the IPP job priority values (1-100,
+100 is highest priority) instead of the Solaris values (0-39, 0
+is highest priority).
.SH SEE ALSO
-lpstat(1),
-CUPS Software Users Manual,
-http://localhost:631/documentation.html
+\fIcancel(1)\fR, \fIlpmove(8)\fR, \fIlpoptions(1)\fR, \fIlpstat(1)\fR,
+.br
+http://localhost:631/help
.SH COPYRIGHT
-Copyright 1993-2005 by Easy Software Products, All Rights Reserved.
+Copyright 1997-2006 by Easy Software Products, All Rights Reserved.
.\"
-.\" End of "$Id: lp.man 4493 2005-02-18 02:09:53Z mike $".
+.\" End of "$Id: lp.man 5099 2006-02-13 02:46:10Z mike $".
.\"