4 .\" lp man page for the Common UNIX Printing System (CUPS).
6 .\" Copyright 1997-2006 by Easy Software Products.
8 .\" These coded instructions, statements, and computer programs are the
9 .\" property of Easy Software Products and are protected by Federal
10 .\" copyright law. Distribution and use rights are outlined in the file
11 .\" "LICENSE.txt" which should have been included with this file. If this
12 .\" file is missing or damaged please contact Easy Software Products
15 .\" Attn: CUPS Licensing Information
16 .\" Easy Software Products
17 .\" 44141 Airport View Drive, Suite 204
18 .\" Hollywood, Maryland 20636 USA
20 .\" Voice: (301) 373-9600
21 .\" EMail: cups-info@cups.org
22 .\" WWW: http://www.cups.org
24 .TH lp 1 "Common UNIX Printing System" "23 March 2006" "Easy Software Products"
32 .I destination[/instance]
72 \fIlp\fR submits files for printing or alters a pending job. Use
73 a filename of "-" to force printing from the standard input.
75 The following options are recognized by \fIlp\fR:
79 Marks the end of options; use this to print a file whose name
80 begins with a dash (-).
84 Forces encryption when connecting to the server.
88 Specifies the username to use when connecting to the server.
92 This option is provided for backwards-compatibility only. On
93 systems that support it, this option forces the print file to be
94 copied to the spool directory before printing. In CUPS, print
95 files are always sent to the scheduler via IPP which has the
100 Prints files to the named printer.
104 Chooses an alternate server.
108 Specifies an existing job to modify.
112 Sends an email when the job is completed.
116 Sets the number of copies to print from 1 to 100.
118 -o "name=value [name=value ...]"
120 Sets one or more job options.
124 Sets the job priority from 1 (lowest) to 100 (highest). The
125 default priority is 50.
129 Do not report the resulting job IDs (silent mode.)
137 Submits jobs as \fIusername\fR.
149 Specifies when the job should be printed. A value of
150 \fIimmediate\fR will print the file immediately, a value of
151 \fIhold\fR will hold the job indefinitely, and a time value
152 (HH:MM) will hold the job until the specified time. Use a value
153 of \fIresume\fR with the \fI-i\fR option to resume a held job.
154 Use a value of \fIrestart\fR with the \fI-i\fR option to restart
159 Specifies which pages to print in the document. The list can
160 contain a list of numbers and ranges (#-#) separated by commas
162 .SH COMMON JOB OPTIONS
163 Aside from the printer-specific options reported by the
164 \fIlpoptions(1)\fR command, the following generic options are
169 Sets the page size to \fIsize\fR. Most printers support at least
170 the size names "a4", "letter", and "legal".
174 -o orientation-requested=4
176 Prints the job in landscape (rotated 90 degrees).
180 -o sides=two-sided-long-edge
182 -o sides=two-sided-short-edge
184 Prints on one or two sides of the paper. The value
185 "two-sided-long-edge" is normally used when printing portrait
186 (unrotated) pages, while "two-sided-short-edge" is used for
191 Scales the print file to fit on the page.
195 Scales image files to use up to \fInumber\fR percent of the page.
196 Values greater than 100 cause the image file to be printed across
201 Sets the number of characters per inch to use when printing a
202 text file. The default is 10.
206 Sets the number of lines per inch to use when printing a text
207 file. The default is 6.
217 Sets the page margins when printing text files. The values are in
218 points - there are 72 points to the inch.
220 Print a double-sided legal document to a printer called "foo":
222 lp -d foo -o media=legal -o sides=two-sided-long-edge filename
225 Print an image across 4 pages:
227 lp -d bar -o scaling=200 filename
230 Print a text file with 12 characters per inch, 8 lines per inch, and
231 a 1 inch left margin:
233 lp -d bar -o cpi=12 -o lpi=8 -o page-left=72 filename
236 Unlike the System V printing system, CUPS allows printer names to
237 contain any printable character except SPACE, TAB, "/", or "#".
238 Also, printer and class names are \fInot\fR case-sensitive.
240 The "q" option accepts a different range of values than the
241 Solaris lp command, matching the IPP job priority values (1-100,
242 100 is highest priority) instead of the Solaris values (0-39, 0
243 is highest priority).
245 \fIcancel(1)\fR, \fIlpmove(8)\fR, \fIlpoptions(1)\fR, \fIlpstat(1)\fR,
247 http://localhost:631/help
249 Copyright 1997-2006 by Easy Software Products, All Rights Reserved.