Lines Matching +full:- +full:lp
2 <!-- SECTION: Getting Started -->
4 <TITLE>Command-Line Printing and Options</TITLE>
5 <LINK REL="STYLESHEET" TYPE="text/css" HREF="../cups-printable.css">
9 <H1 CLASS="title">Command-Line Printing and Options</H1>
12 HREF="man-lp.html">lp(1)</A>) and Berkeley (<A
13 HREF="man-lpr.html">lpr(1)</A>) printing commands for printing
15 printer-specific options that allow you to control how and where
23 to print from inside your applications or at the command-line,
29 lp filename
38 the <A HREF="man-lpstat.html">lpstat(1)</A> command to see a list
42 lpstat -p -d
45 <P>The <CODE>-p</CODE> option specifies that you want to see a
46 list of printers, and the <CODE>-d</CODE> option reports the
49 <P>Use the <CODE>-d</CODE> option with the <B>lp</B> command to
53 lp -d printer filename
56 <P>or the <CODE>-P</CODE> option with the <B>lpr</B> command:</P>
59 lpr -P printer filename
66 HREF="man-lpoptions.html">lpoptions(1)</A> command:</P>
69 lpoptions -d printer
74 <P>Both the <B>lp</B> and <B>lpr</B> commands support printing
78 program | lp
79 program | lp -d printer
81 program | lpr -P printer
94 <P>The <B>lp</B> and <B>lpr</B> commands allow you to pass
95 printer options using the <CODE>-o</CODE> option:</P>
98 lp -o landscape -o fit-to-page -o media=A4 filename.jpg
99 lpr -o landscape -o fit-to-page -o media=A4 filename.jpg
105 below. Printer-specific options are also available and can be
109 lpoptions -p printer -l
120 lpoptions -p printer/instance -o name=value ...
123 <P>The <CODE>-p printer/instance</CODE> option provides the name of
131 lpoptions -p LaserJet/duplex -o sides=two-sided-long-edge
139 <P>Both the <B>lp</B> and <B>lpr</B> commands have options for
143 lp -n <EM>num-copies</EM> filename
144 lpr -#<EM>num-copies</EM> filename
148 <CODE>-o collate=true</CODE> option to get collated copies:</P>
151 lp -n <EM>num-copies</EM> -o collate=true filename
152 lpr -#<EM>num-copies</EM> -o collate=true filename
158 <P>The <A HREF="man-cancel.html">cancel(1)</A> and <A
159 HREF="man-lprm.html">lprm(1)</A> commands cancel a print job:</P>
162 cancel <EM>job-id</EM>
163 lprm <EM>job-id</EM>
166 <P>The <EM>job-id</EM> is the number that was reported to you by
167 the <B>lp</B> command. You can also get the job ID using the <A
168 HREF="man-lpq.html">lpq(1)</A> or <A
169 HREF="man-lpstat.html">lpstat</A> commands:</P>
179 <P>The <A HREF="man-lpmove.html">lpmove(8)</A> command moves a print
183 lpmove <EM>job-id</EM> <i>destination</i>
186 <P>The <EM>job-id</EM> is the number that was reported to you by
187 the <B>lp</B> or <B>lpstat</B> commands. <i>Destination</i> is the
198 /usr/sbin/lpmove foo-123 bar
211 <P>The <CODE>-o media=xyz</CODE> option sets the media size,
215 lp -o media=Letter filename
216 lp -o media=Letter,MultiPurpose filename
217 lpr -o media=Letter,Transparency filename
218 lpr -o media=Letter,MultiPurpose,Transparency filename
227 <LI><CODE>Letter</CODE> - US Letter (8.5x11 inches, or 216x279mm)
229 <LI><CODE>Legal</CODE> - US Legal (8.5x14 inches, or 216x356mm)
231 <LI><CODE>A4</CODE> - ISO A4 (8.27x11.69 inches, or 210x297mm)
233 <LI><CODE>COM10</CODE> - US #10 Envelope (9.5x4.125 inches, or
236 <LI><CODE>DL</CODE> - ISO DL Envelope (8.66x4.33 inches, or 220x110mm)
238 <LI><CODE>Transparency</CODE> - Transparency media type or source
240 <LI><CODE>Upper</CODE> - Upper paper tray
242 <LI><CODE>Lower</CODE> - Lower paper tray
244 <LI><CODE>MultiPurpose</CODE> - Multi-purpose paper tray
246 <LI><CODE>LargeCapacity</CODE> - Large capacity paper tray
256 lpoptions -p printer -l
262 lp -o media=Custom.<EM>WIDTH</EM>x<EM>LENGTH</EM> filename
263 lp -o media=Custom.<EM>WIDTH</EM>x<EM>LENGTH</EM>in filename
264 lp -o media=Custom.<EM>WIDTH</EM>x<EM>LENGTH</EM>cm filename
265 lp -o media=Custom.<EM>WIDTH</EM>x<EM>LENGTH</EM>mm filename
273 <P>The <CODE>-o landscape</CODE> option will rotate the page 90
277 lp -o landscape filename
278 lpr -o landscape filename
281 <P>The <CODE>-o orientation-requested=N</CODE> option rotates the
286 <LI><CODE>-o orientation-requested=3</CODE> - portrait
289 <LI><CODE>-o orientation-requested=4</CODE> - landscape
292 <LI><CODE>-o orientation-requested=5</CODE> - reverse
295 <LI><CODE>-o orientation-requested=6</CODE> - reverse
296 portrait or upside-down orientation (180 degrees)</LI>
303 <P>The <CODE>-o sides=two-sided-short-edge</CODE> and <CODE>-o
304 sides=two-sided-long-edge</CODE> options will enable two-sided
305 printing on the printer if the printer supports it. The <CODE>-o
306 sides=two-sided-short-edge</CODE> option is suitable for
307 landscape pages, while the <CODE>-o
308 sides=two-sided-long-edge</CODE> option is suitable for portrait
312 lp -o sides=two-sided-short-edge filename
313 lp -o sides=two-sided-long-edge filename
314 lpr -o sides=two-sided-long-edge filename
317 <P>The default is to print single-sided:</P>
320 lp -o sides=one-sided filename
321 lpr -o sides=one-sided filename
327 <P>The <CODE>-o job-sheets=start,end</CODE> option sets the banner
331 lp -o job-sheets=none filename
332 lp -o job-sheets=standard filename
333 lpr -o job-sheets=classified,classified filename
345 <LI><CODE>none</CODE> - Do not produce a banner page.
347 <LI><CODE>classified</CODE> - A banner page with a "classified"
350 <LI><CODE>confidential</CODE> - A banner page with a
353 <LI><CODE>secret</CODE> - A banner page with a "secret" label
356 <LI><CODE>standard</CODE> - A banner page with no label at the
359 <LI><CODE>topsecret</CODE> - A banner page with a "top secret"
362 <LI><CODE>unclassified</CODE> - A banner page with an
370 <P>The <CODE>-o job-hold-until=when</CODE> option tells CUPS to
376 <LI><CODE>-o job-hold-until=indefinite</CODE>; print only
379 <LI><CODE>-o job-hold-until=day-time</CODE>; print from
382 <LI><CODE>-o job-hold-until=night</CODE>; print from
385 <LI><CODE>-o job-hold-until=second-shift</CODE>; print from
388 <LI><CODE>-o job-hold-until=third-shift</CODE>; print from
391 <LI><CODE>-o job-hold-until=weekend</CODE>; print on Saturday
394 <LI><CODE>-o job-hold-until=HH:MM</CODE>; print at the specified
401 <P>Aside from the web interface, you can use the <B>lp</B> command
405 lp -i <em>job-id</em> -H resume
408 <P>where "job-id" is the job ID reported by the <B>lpstat</B>
414 <P>The <CODE>-o job-priority=NNN</CODE> option tells CUPS to
424 <P>The <CODE>-o outputorder=normal</CODE> and <CODE>-o outputorder=reverse</CODE> options specify t…
429 <P>The <CODE>-o page-ranges=pages</CODE> option selects a range
433 lp -o page-ranges=1 filename
434 lp -o page-ranges=1-4 filename
435 lp -o page-ranges=1-4,7,9-12 filename
436 lpr -o page-ranges=1-4,7,9-12 filename
442 of the order of the pages in the <CODE>page-ranges</CODE> option.
448 <p>The page numbers used by <code>page-ranges</code> refer to the output
449 pages and not the document's page numbers. Options like <code>number-up</code>
455 <H3><A NAME="NUMBERUP">N-Up Printing</A></H3>
457 <P>The <CODE>-o number-up=value</CODE> option selects N-Up
458 printing. N-Up printing places multiple document pages on a
459 single printed page. CUPS supports 1, 2, 4, 6, 9, and 16-Up
460 formats; the default format is 1-Up:</P>
463 lp -o number-up=1 filename
464 lp -o number-up=2 filename
465 lp -o number-up=4 filename
466 lpr -o number-up=16 filename
469 <P>The <CODE>-o page-border=value</CODE> option chooses the
473 <LI><CODE>-o page-border=double</CODE>; draw two hairline borders around each page</LI>
474 <LI><CODE>-o page-border=double-thick</CODE>; draw two 1pt borders around each page</LI>
475 <LI><CODE>-o page-border=none</CODE>; do not draw a border (default)</LI>
476 <LI><CODE>-o page-border=single</CODE>; draw one hairline border around each page</LI>
477 <LI><CODE>-o page-border=single-thick</CODE>; draw one 1pt border around each page</LI>
480 <P>The <CODE>-o number-up-layout=value</CODE> option chooses the
484 <LI><CODE>-o number-up-layout=btlr</CODE>; Bottom to top, left to right</LI>
485 <LI><CODE>-o number-up-layout=btrl</CODE>; Bottom to top, right to left</LI>
486 <LI><CODE>-o number-up-layout=lrbt</CODE>; Left to right, bottom to top</LI>
487 <LI><CODE>-o number-up-layout=lrtb</CODE>; Left to right, top to bottom (default)</LI>
488 <LI><CODE>-o number-up-layout=rlbt</CODE>; Right to left, bottom to top</LI>
489 <LI><CODE>-o number-up-layout=rltb</CODE>; Right to left, top to bottom</LI>
490 <LI><CODE>-o number-up-layout=tblr</CODE>; Top to bottom, left to right</LI>
491 <LI><CODE>-o number-up-layout=tbrl</CODE>; Top to bottom, right to left</LI>
496 <P>The <CODE>-o fit-to-page</CODE> option specifies that the document
500 lp -o fit-to-page filename
501 lpr -o fit-to-page filename
516 <P>The <CODE>-o outputorder=reverse</CODE> option will print the
520 lp -o outputorder=reverse filename
521 lpr -o outputorder=reverse filename
524 <P>Similarly, the <CODE>-o outputorder=normal</CODE> option will
528 lp -o outputorder=normal filename
529 lpr -o outputorder=normal filename
532 <P>The default is <CODE>-o outputorder=normal</CODE> for
533 printers that print face down and <CODE>-o outputorder=reverse</CODE>
538 <P>The <CODE>-o mirror</CODE> option flips each page along the
542 lp -o mirror filename
543 lpr -o mirror filename
546 <P>This is typically used when printing on T-shirt transfer