xref: /aosp_15_r20/external/libcups/doc/help/options.html (revision 5e7646d21f1134fb0638875d812ef646c12ab91e)
1*5e7646d2SAndroid Build Coastguard Worker<HTML>
2*5e7646d2SAndroid Build Coastguard Worker<!-- SECTION: Getting Started -->
3*5e7646d2SAndroid Build Coastguard Worker<HEAD>
4*5e7646d2SAndroid Build Coastguard Worker	<TITLE>Command-Line Printing and Options</TITLE>
5*5e7646d2SAndroid Build Coastguard Worker	<LINK REL="STYLESHEET" TYPE="text/css" HREF="../cups-printable.css">
6*5e7646d2SAndroid Build Coastguard Worker</HEAD>
7*5e7646d2SAndroid Build Coastguard Worker<BODY>
8*5e7646d2SAndroid Build Coastguard Worker
9*5e7646d2SAndroid Build Coastguard Worker<H1 CLASS="title">Command-Line Printing and Options</H1>
10*5e7646d2SAndroid Build Coastguard Worker
11*5e7646d2SAndroid Build Coastguard Worker<P>CUPS provides both the System V (<A
12*5e7646d2SAndroid Build Coastguard WorkerHREF="man-lp.html">lp(1)</A>) and Berkeley (<A
13*5e7646d2SAndroid Build Coastguard WorkerHREF="man-lpr.html">lpr(1)</A>) printing commands for printing
14*5e7646d2SAndroid Build Coastguard Workerfiles. In addition, it supported a large number of standard and
15*5e7646d2SAndroid Build Coastguard Workerprinter-specific options that allow you to control how and where
16*5e7646d2SAndroid Build Coastguard Workerfiles are printed.</P>
17*5e7646d2SAndroid Build Coastguard Worker
18*5e7646d2SAndroid Build Coastguard Worker
19*5e7646d2SAndroid Build Coastguard Worker<H2 CLASS="title"><A NAME="BASICS">Printing Files</A></H2>
20*5e7646d2SAndroid Build Coastguard Worker
21*5e7646d2SAndroid Build Coastguard Worker<P>CUPS understands many different types of files directly,
22*5e7646d2SAndroid Build Coastguard Workerincluding text, PostScript, PDF, and image files. This allows you
23*5e7646d2SAndroid Build Coastguard Workerto print from inside your applications or at the command-line,
24*5e7646d2SAndroid Build Coastguard Workerwhichever is most convenient! Type either of the following
25*5e7646d2SAndroid Build Coastguard Workercommands to print a file to the default (or only) printer on the
26*5e7646d2SAndroid Build Coastguard Workersystem:</P>
27*5e7646d2SAndroid Build Coastguard Worker
28*5e7646d2SAndroid Build Coastguard Worker<PRE CLASS="command">
29*5e7646d2SAndroid Build Coastguard Workerlp filename
30*5e7646d2SAndroid Build Coastguard Workerlpr filename
31*5e7646d2SAndroid Build Coastguard Worker</PRE>
32*5e7646d2SAndroid Build Coastguard Worker
33*5e7646d2SAndroid Build Coastguard Worker<H3><A NAME="PRINTER">Choosing a Printer</A></H3>
34*5e7646d2SAndroid Build Coastguard Worker
35*5e7646d2SAndroid Build Coastguard Worker<P>Many systems will have more than one printer available to the
36*5e7646d2SAndroid Build Coastguard Workeruser. These printers can be attached to the local system via a
37*5e7646d2SAndroid Build Coastguard Workerparallel, serial, or USB port, or available over the network. Use
38*5e7646d2SAndroid Build Coastguard Workerthe <A HREF="man-lpstat.html">lpstat(1)</A> command to see a list
39*5e7646d2SAndroid Build Coastguard Workerof available printers:</P>
40*5e7646d2SAndroid Build Coastguard Worker
41*5e7646d2SAndroid Build Coastguard Worker<PRE CLASS="command">
42*5e7646d2SAndroid Build Coastguard Workerlpstat -p -d
43*5e7646d2SAndroid Build Coastguard Worker</PRE>
44*5e7646d2SAndroid Build Coastguard Worker
45*5e7646d2SAndroid Build Coastguard Worker<P>The <CODE>-p</CODE> option specifies that you want to see a
46*5e7646d2SAndroid Build Coastguard Workerlist of printers, and the <CODE>-d</CODE> option reports the
47*5e7646d2SAndroid Build Coastguard Workercurrent default printer or class.</P>
48*5e7646d2SAndroid Build Coastguard Worker
49*5e7646d2SAndroid Build Coastguard Worker<P>Use the <CODE>-d</CODE> option with the <B>lp</B> command to
50*5e7646d2SAndroid Build Coastguard Workerprint to a specific printer:</P>
51*5e7646d2SAndroid Build Coastguard Worker
52*5e7646d2SAndroid Build Coastguard Worker<PRE CLASS="command">
53*5e7646d2SAndroid Build Coastguard Workerlp -d printer filename
54*5e7646d2SAndroid Build Coastguard Worker</PRE>
55*5e7646d2SAndroid Build Coastguard Worker
56*5e7646d2SAndroid Build Coastguard Worker<P>or the <CODE>-P</CODE> option with the <B>lpr</B> command:</P>
57*5e7646d2SAndroid Build Coastguard Worker
58*5e7646d2SAndroid Build Coastguard Worker<PRE CLASS="command">
59*5e7646d2SAndroid Build Coastguard Workerlpr -P printer filename
60*5e7646d2SAndroid Build Coastguard Worker</PRE>
61*5e7646d2SAndroid Build Coastguard Worker
62*5e7646d2SAndroid Build Coastguard Worker<H3><A NAME="DEFAULT">Setting the Default Printer</A></H3>
63*5e7646d2SAndroid Build Coastguard Worker
64*5e7646d2SAndroid Build Coastguard Worker<P>If you normally use a particular printer, you can tell CUPS to
65*5e7646d2SAndroid Build Coastguard Workeruse it by default using the <A
66*5e7646d2SAndroid Build Coastguard WorkerHREF="man-lpoptions.html">lpoptions(1)</A> command:</P>
67*5e7646d2SAndroid Build Coastguard Worker
68*5e7646d2SAndroid Build Coastguard Worker<PRE CLASS="command">
69*5e7646d2SAndroid Build Coastguard Workerlpoptions -d printer
70*5e7646d2SAndroid Build Coastguard Worker</PRE>
71*5e7646d2SAndroid Build Coastguard Worker
72*5e7646d2SAndroid Build Coastguard Worker<H3><A NAME="PIPE">Printing the Output of a Program</A></H3>
73*5e7646d2SAndroid Build Coastguard Worker
74*5e7646d2SAndroid Build Coastguard Worker<P>Both the <B>lp</B> and <B>lpr</B> commands support printing
75*5e7646d2SAndroid Build Coastguard Workerfrom the standard input:</P>
76*5e7646d2SAndroid Build Coastguard Worker
77*5e7646d2SAndroid Build Coastguard Worker<PRE CLASS="command">
78*5e7646d2SAndroid Build Coastguard Workerprogram | lp
79*5e7646d2SAndroid Build Coastguard Workerprogram | lp -d printer
80*5e7646d2SAndroid Build Coastguard Workerprogram | lpr
81*5e7646d2SAndroid Build Coastguard Workerprogram | lpr -P printer
82*5e7646d2SAndroid Build Coastguard Worker</PRE>
83*5e7646d2SAndroid Build Coastguard Worker
84*5e7646d2SAndroid Build Coastguard Worker<P>If the program does not provide any output, then nothing will
85*5e7646d2SAndroid Build Coastguard Workerbe queued for printing.</P>
86*5e7646d2SAndroid Build Coastguard Worker
87*5e7646d2SAndroid Build Coastguard Worker<H3><A NAME="WITHOPTIONS">Specifying Printer Options</A></H3>
88*5e7646d2SAndroid Build Coastguard Worker
89*5e7646d2SAndroid Build Coastguard Worker<P>For many types of files, the default printer options may be
90*5e7646d2SAndroid Build Coastguard Workersufficient for your needs. However, there may be times when you
91*5e7646d2SAndroid Build Coastguard Workerneed to change the options for a particular file you are
92*5e7646d2SAndroid Build Coastguard Workerprinting.</P>
93*5e7646d2SAndroid Build Coastguard Worker
94*5e7646d2SAndroid Build Coastguard Worker<P>The <B>lp</B> and <B>lpr</B> commands allow you to pass
95*5e7646d2SAndroid Build Coastguard Workerprinter options using the <CODE>-o</CODE> option:</P>
96*5e7646d2SAndroid Build Coastguard Worker
97*5e7646d2SAndroid Build Coastguard Worker<PRE CLASS="command">
98*5e7646d2SAndroid Build Coastguard Workerlp -o landscape -o fit-to-page -o media=A4 filename.jpg
99*5e7646d2SAndroid Build Coastguard Workerlpr -o landscape -o fit-to-page -o media=A4 filename.jpg
100*5e7646d2SAndroid Build Coastguard Worker</PRE>
101*5e7646d2SAndroid Build Coastguard Worker
102*5e7646d2SAndroid Build Coastguard Worker<P>The available printer options vary depending on the printer.
103*5e7646d2SAndroid Build Coastguard WorkerThe standard options are described in the "<A
104*5e7646d2SAndroid Build Coastguard WorkerHREF="#OPTIONS">Standard Printing Options</A>" section
105*5e7646d2SAndroid Build Coastguard Workerbelow. Printer-specific options are also available and can be
106*5e7646d2SAndroid Build Coastguard Workerlisted using the <B>lpoptions</B> command:</P>
107*5e7646d2SAndroid Build Coastguard Worker
108*5e7646d2SAndroid Build Coastguard Worker<PRE CLASS="command">
109*5e7646d2SAndroid Build Coastguard Workerlpoptions -p printer -l
110*5e7646d2SAndroid Build Coastguard Worker</PRE>
111*5e7646d2SAndroid Build Coastguard Worker
112*5e7646d2SAndroid Build Coastguard Worker<H3><A NAME="INSTANCES">Creating Saved Options</A></H3>
113*5e7646d2SAndroid Build Coastguard Worker
114*5e7646d2SAndroid Build Coastguard Worker<P>Saved options are supported in CUPS through <em>printer
115*5e7646d2SAndroid Build Coastguard Workerinstances</em>. Printer instances are, as their name implies, copies
116*5e7646d2SAndroid Build Coastguard Workerof a printer that have certain options associated with them. Use the
117*5e7646d2SAndroid Build Coastguard Worker<B>lpoptions</B> command to create a printer instance:</P>
118*5e7646d2SAndroid Build Coastguard Worker
119*5e7646d2SAndroid Build Coastguard Worker<PRE CLASS="command">
120*5e7646d2SAndroid Build Coastguard Workerlpoptions -p printer/instance -o name=value ...
121*5e7646d2SAndroid Build Coastguard Worker</PRE>
122*5e7646d2SAndroid Build Coastguard Worker
123*5e7646d2SAndroid Build Coastguard Worker<P>The <CODE>-p printer/instance</CODE> option provides the name of
124*5e7646d2SAndroid Build Coastguard Workerthe instance, which is always the printer name, a slash, and the
125*5e7646d2SAndroid Build Coastguard Workerinstance name which can contain any printable characters except
126*5e7646d2SAndroid Build Coastguard Workerspace and slash. The remaining options are then associated with the
127*5e7646d2SAndroid Build Coastguard Workerinstance instead of the main queue. For example, the following
128*5e7646d2SAndroid Build Coastguard Workercommand creates a duplex instance of the LaserJet queue:</P>
129*5e7646d2SAndroid Build Coastguard Worker
130*5e7646d2SAndroid Build Coastguard Worker<PRE CLASS="command">
131*5e7646d2SAndroid Build Coastguard Workerlpoptions -p LaserJet/duplex -o sides=two-sided-long-edge
132*5e7646d2SAndroid Build Coastguard Worker</PRE>
133*5e7646d2SAndroid Build Coastguard Worker
134*5e7646d2SAndroid Build Coastguard Worker<P>Instances <em>do not</em> inherit lpoptions from the main
135*5e7646d2SAndroid Build Coastguard Workerqueue.</P>
136*5e7646d2SAndroid Build Coastguard Worker
137*5e7646d2SAndroid Build Coastguard Worker<H3><A NAME="COPIES">Printing Multiple Copies</A></H3>
138*5e7646d2SAndroid Build Coastguard Worker
139*5e7646d2SAndroid Build Coastguard Worker<P>Both the <B>lp</B> and <B>lpr</B> commands have options for
140*5e7646d2SAndroid Build Coastguard Workerprinting more than one copy of a file:</P>
141*5e7646d2SAndroid Build Coastguard Worker
142*5e7646d2SAndroid Build Coastguard Worker<PRE CLASS="command">
143*5e7646d2SAndroid Build Coastguard Workerlp -n <EM>num-copies</EM> filename
144*5e7646d2SAndroid Build Coastguard Workerlpr -#<EM>num-copies</EM> filename
145*5e7646d2SAndroid Build Coastguard Worker</PRE>
146*5e7646d2SAndroid Build Coastguard Worker
147*5e7646d2SAndroid Build Coastguard Worker<P>Copies are normally <EM>not</EM> collated for you. Use the
148*5e7646d2SAndroid Build Coastguard Worker<CODE>-o collate=true</CODE> option to get collated copies:</P>
149*5e7646d2SAndroid Build Coastguard Worker
150*5e7646d2SAndroid Build Coastguard Worker<PRE CLASS="command">
151*5e7646d2SAndroid Build Coastguard Workerlp -n <EM>num-copies</EM> -o collate=true filename
152*5e7646d2SAndroid Build Coastguard Workerlpr -#<EM>num-copies</EM> -o collate=true filename
153*5e7646d2SAndroid Build Coastguard Worker</PRE>
154*5e7646d2SAndroid Build Coastguard Worker
155*5e7646d2SAndroid Build Coastguard Worker
156*5e7646d2SAndroid Build Coastguard Worker<H2 CLASS="title"><A NAME="CANCEL">Canceling a Print Job</A></H2>
157*5e7646d2SAndroid Build Coastguard Worker
158*5e7646d2SAndroid Build Coastguard Worker<P>The <A HREF="man-cancel.html">cancel(1)</A> and <A
159*5e7646d2SAndroid Build Coastguard WorkerHREF="man-lprm.html">lprm(1)</A> commands cancel a print job:</P>
160*5e7646d2SAndroid Build Coastguard Worker
161*5e7646d2SAndroid Build Coastguard Worker<PRE CLASS="command">
162*5e7646d2SAndroid Build Coastguard Workercancel <EM>job-id</EM>
163*5e7646d2SAndroid Build Coastguard Workerlprm <EM>job-id</EM>
164*5e7646d2SAndroid Build Coastguard Worker</PRE>
165*5e7646d2SAndroid Build Coastguard Worker
166*5e7646d2SAndroid Build Coastguard Worker<P>The <EM>job-id</EM> is the number that was reported to you by
167*5e7646d2SAndroid Build Coastguard Workerthe <B>lp</B> command. You can also get the job ID using the <A
168*5e7646d2SAndroid Build Coastguard WorkerHREF="man-lpq.html">lpq(1)</A> or <A
169*5e7646d2SAndroid Build Coastguard WorkerHREF="man-lpstat.html">lpstat</A> commands:</P>
170*5e7646d2SAndroid Build Coastguard Worker
171*5e7646d2SAndroid Build Coastguard Worker<PRE CLASS="command">
172*5e7646d2SAndroid Build Coastguard Workerlpq
173*5e7646d2SAndroid Build Coastguard Workerlpstat
174*5e7646d2SAndroid Build Coastguard Worker</PRE>
175*5e7646d2SAndroid Build Coastguard Worker
176*5e7646d2SAndroid Build Coastguard Worker
177*5e7646d2SAndroid Build Coastguard Worker<H2 CLASS="title"><A NAME="LPMOVE">Moving a Print Job</A></H2>
178*5e7646d2SAndroid Build Coastguard Worker
179*5e7646d2SAndroid Build Coastguard Worker<P>The <A HREF="man-lpmove.html">lpmove(8)</A> command moves a print
180*5e7646d2SAndroid Build Coastguard Workerjob to a new printer or class:</P>
181*5e7646d2SAndroid Build Coastguard Worker
182*5e7646d2SAndroid Build Coastguard Worker<PRE CLASS="command">
183*5e7646d2SAndroid Build Coastguard Workerlpmove <EM>job-id</EM> <i>destination</i>
184*5e7646d2SAndroid Build Coastguard Worker</PRE>
185*5e7646d2SAndroid Build Coastguard Worker
186*5e7646d2SAndroid Build Coastguard Worker<P>The <EM>job-id</EM> is the number that was reported to you by
187*5e7646d2SAndroid Build Coastguard Workerthe <B>lp</B> or <B>lpstat</B> commands. <i>Destination</i> is the
188*5e7646d2SAndroid Build Coastguard Workername of a printer or class that you want to actually print the job.
189*5e7646d2SAndroid Build Coastguard Worker
190*5e7646d2SAndroid Build Coastguard Worker<BLOCKQUOTE><B>Note:</B>
191*5e7646d2SAndroid Build Coastguard Worker
192*5e7646d2SAndroid Build Coastguard Worker<P>The <B>lpmove</B> command is located in the system command
193*5e7646d2SAndroid Build Coastguard Workerdirectory (typically <VAR>/usr/sbin</VAR> or <VAR>/usr/local/sbin</VAR>),
194*5e7646d2SAndroid Build Coastguard Workerand so may not be in your command path. Specify the full path to the
195*5e7646d2SAndroid Build Coastguard Workercommand if you get a "command not found" error, for example:
196*5e7646d2SAndroid Build Coastguard Worker
197*5e7646d2SAndroid Build Coastguard Worker<PRE CLASS="command">
198*5e7646d2SAndroid Build Coastguard Worker/usr/sbin/lpmove foo-123 bar
199*5e7646d2SAndroid Build Coastguard Worker</PRE>
200*5e7646d2SAndroid Build Coastguard Worker
201*5e7646d2SAndroid Build Coastguard Worker</BLOCKQUOTE>
202*5e7646d2SAndroid Build Coastguard Worker
203*5e7646d2SAndroid Build Coastguard Worker
204*5e7646d2SAndroid Build Coastguard Worker<H2 CLASS="title"><A NAME="OPTIONS">Standard Printing Options</A></H2>
205*5e7646d2SAndroid Build Coastguard Worker
206*5e7646d2SAndroid Build Coastguard Worker<P>The following options apply when printing all types of
207*5e7646d2SAndroid Build Coastguard Workerfiles.</P>
208*5e7646d2SAndroid Build Coastguard Worker
209*5e7646d2SAndroid Build Coastguard Worker<H3><A NAME="MEDIA">Selecting the Media Size, Type, and Source</A></H3>
210*5e7646d2SAndroid Build Coastguard Worker
211*5e7646d2SAndroid Build Coastguard Worker<P>The <CODE>-o media=xyz</CODE> option sets the media size,
212*5e7646d2SAndroid Build Coastguard Workertype, and/or source:</P>
213*5e7646d2SAndroid Build Coastguard Worker
214*5e7646d2SAndroid Build Coastguard Worker<PRE CLASS="command">
215*5e7646d2SAndroid Build Coastguard Workerlp -o media=Letter filename
216*5e7646d2SAndroid Build Coastguard Workerlp -o media=Letter,MultiPurpose filename
217*5e7646d2SAndroid Build Coastguard Workerlpr -o media=Letter,Transparency filename
218*5e7646d2SAndroid Build Coastguard Workerlpr -o media=Letter,MultiPurpose,Transparency filename
219*5e7646d2SAndroid Build Coastguard Worker</PRE>
220*5e7646d2SAndroid Build Coastguard Worker
221*5e7646d2SAndroid Build Coastguard Worker<P>The available media sizes, types, and sources depend on the
222*5e7646d2SAndroid Build Coastguard Workerprinter, but most support the following options (case is not
223*5e7646d2SAndroid Build Coastguard Workersignificant):</P>
224*5e7646d2SAndroid Build Coastguard Worker
225*5e7646d2SAndroid Build Coastguard Worker<UL>
226*5e7646d2SAndroid Build Coastguard Worker
227*5e7646d2SAndroid Build Coastguard Worker	<LI><CODE>Letter</CODE> - US Letter (8.5x11 inches, or 216x279mm)
228*5e7646d2SAndroid Build Coastguard Worker
229*5e7646d2SAndroid Build Coastguard Worker	<LI><CODE>Legal</CODE> - US Legal (8.5x14 inches, or 216x356mm)
230*5e7646d2SAndroid Build Coastguard Worker
231*5e7646d2SAndroid Build Coastguard Worker	<LI><CODE>A4</CODE> - ISO A4 (8.27x11.69 inches, or 210x297mm)
232*5e7646d2SAndroid Build Coastguard Worker
233*5e7646d2SAndroid Build Coastguard Worker	<LI><CODE>COM10</CODE> - US #10 Envelope (9.5x4.125 inches, or
234*5e7646d2SAndroid Build Coastguard Worker	241x105mm)
235*5e7646d2SAndroid Build Coastguard Worker
236*5e7646d2SAndroid Build Coastguard Worker	<LI><CODE>DL</CODE> - ISO DL Envelope (8.66x4.33 inches, or 220x110mm)
237*5e7646d2SAndroid Build Coastguard Worker
238*5e7646d2SAndroid Build Coastguard Worker	<LI><CODE>Transparency</CODE> - Transparency media type or source
239*5e7646d2SAndroid Build Coastguard Worker
240*5e7646d2SAndroid Build Coastguard Worker	<LI><CODE>Upper</CODE> - Upper paper tray
241*5e7646d2SAndroid Build Coastguard Worker
242*5e7646d2SAndroid Build Coastguard Worker	<LI><CODE>Lower</CODE> - Lower paper tray
243*5e7646d2SAndroid Build Coastguard Worker
244*5e7646d2SAndroid Build Coastguard Worker	<LI><CODE>MultiPurpose</CODE> - Multi-purpose paper tray
245*5e7646d2SAndroid Build Coastguard Worker
246*5e7646d2SAndroid Build Coastguard Worker	<LI><CODE>LargeCapacity</CODE> - Large capacity paper tray
247*5e7646d2SAndroid Build Coastguard Worker
248*5e7646d2SAndroid Build Coastguard Worker</UL>
249*5e7646d2SAndroid Build Coastguard Worker
250*5e7646d2SAndroid Build Coastguard Worker<P>The actual options supported are defined in the printer's PPD
251*5e7646d2SAndroid Build Coastguard Workerfile in the <CODE>PageSize</CODE>, <CODE>InputSlot</CODE>, and
252*5e7646d2SAndroid Build Coastguard Worker<CODE>MediaType</CODE> options. You can list them using the
253*5e7646d2SAndroid Build Coastguard Worker<B>lpoptions(1)</B> command:</P>
254*5e7646d2SAndroid Build Coastguard Worker
255*5e7646d2SAndroid Build Coastguard Worker<PRE CLASS="command">
256*5e7646d2SAndroid Build Coastguard Workerlpoptions -p printer -l
257*5e7646d2SAndroid Build Coastguard Worker</PRE>
258*5e7646d2SAndroid Build Coastguard Worker
259*5e7646d2SAndroid Build Coastguard Worker<P>When <CODE>Custom</CODE> is listed for the <CODE>PageSize</CODE> option, you can specify custom media sizes using one of the following forms:</P>
260*5e7646d2SAndroid Build Coastguard Worker
261*5e7646d2SAndroid Build Coastguard Worker<PRE CLASS="command">
262*5e7646d2SAndroid Build Coastguard Workerlp -o media=Custom.<EM>WIDTH</EM>x<EM>LENGTH</EM> filename
263*5e7646d2SAndroid Build Coastguard Workerlp -o media=Custom.<EM>WIDTH</EM>x<EM>LENGTH</EM>in filename
264*5e7646d2SAndroid Build Coastguard Workerlp -o media=Custom.<EM>WIDTH</EM>x<EM>LENGTH</EM>cm filename
265*5e7646d2SAndroid Build Coastguard Workerlp -o media=Custom.<EM>WIDTH</EM>x<EM>LENGTH</EM>mm filename
266*5e7646d2SAndroid Build Coastguard Worker</PRE>
267*5e7646d2SAndroid Build Coastguard Worker
268*5e7646d2SAndroid Build Coastguard Worker<P>where "WIDTH" and "LENGTH" are the width and length of the media in points, inches, centimeters, or millimeters, respectively.</P>
269*5e7646d2SAndroid Build Coastguard Worker
270*5e7646d2SAndroid Build Coastguard Worker
271*5e7646d2SAndroid Build Coastguard Worker<H3><A NAME="ORIENTATION">Setting the Orientation</A></H3>
272*5e7646d2SAndroid Build Coastguard Worker
273*5e7646d2SAndroid Build Coastguard Worker<P>The <CODE>-o landscape</CODE> option will rotate the page 90
274*5e7646d2SAndroid Build Coastguard Workerdegrees to print in landscape orientation:</P>
275*5e7646d2SAndroid Build Coastguard Worker
276*5e7646d2SAndroid Build Coastguard Worker<PRE CLASS="command">
277*5e7646d2SAndroid Build Coastguard Workerlp -o landscape filename
278*5e7646d2SAndroid Build Coastguard Workerlpr -o landscape filename
279*5e7646d2SAndroid Build Coastguard Worker</PRE>
280*5e7646d2SAndroid Build Coastguard Worker
281*5e7646d2SAndroid Build Coastguard Worker<P>The <CODE>-o orientation-requested=N</CODE> option rotates the
282*5e7646d2SAndroid Build Coastguard Workerpage depending on the value of N:</P>
283*5e7646d2SAndroid Build Coastguard Worker
284*5e7646d2SAndroid Build Coastguard Worker<UL>
285*5e7646d2SAndroid Build Coastguard Worker
286*5e7646d2SAndroid Build Coastguard Worker	<LI><CODE>-o orientation-requested=3</CODE> - portrait
287*5e7646d2SAndroid Build Coastguard Worker	orientation (no rotation)</LI>
288*5e7646d2SAndroid Build Coastguard Worker
289*5e7646d2SAndroid Build Coastguard Worker	<LI><CODE>-o orientation-requested=4</CODE> - landscape
290*5e7646d2SAndroid Build Coastguard Worker	orientation (90 degrees)</LI>
291*5e7646d2SAndroid Build Coastguard Worker
292*5e7646d2SAndroid Build Coastguard Worker	<LI><CODE>-o orientation-requested=5</CODE> - reverse
293*5e7646d2SAndroid Build Coastguard Worker	landscape or seascape orientation (270 degrees)</LI>
294*5e7646d2SAndroid Build Coastguard Worker
295*5e7646d2SAndroid Build Coastguard Worker	<LI><CODE>-o orientation-requested=6</CODE> - reverse
296*5e7646d2SAndroid Build Coastguard Worker	portrait or upside-down orientation (180 degrees)</LI>
297*5e7646d2SAndroid Build Coastguard Worker
298*5e7646d2SAndroid Build Coastguard Worker</UL>
299*5e7646d2SAndroid Build Coastguard Worker
300*5e7646d2SAndroid Build Coastguard Worker
301*5e7646d2SAndroid Build Coastguard Worker<H3><A NAME="SIDES">Printing On Both Sides of the Paper</A></H3>
302*5e7646d2SAndroid Build Coastguard Worker
303*5e7646d2SAndroid Build Coastguard Worker<P>The <CODE>-o sides=two-sided-short-edge</CODE> and <CODE>-o
304*5e7646d2SAndroid Build Coastguard Workersides=two-sided-long-edge</CODE> options will enable two-sided
305*5e7646d2SAndroid Build Coastguard Workerprinting on the printer if the printer supports it. The <CODE>-o
306*5e7646d2SAndroid Build Coastguard Workersides=two-sided-short-edge</CODE> option is suitable for
307*5e7646d2SAndroid Build Coastguard Workerlandscape pages, while the <CODE>-o
308*5e7646d2SAndroid Build Coastguard Workersides=two-sided-long-edge</CODE> option is suitable for portrait
309*5e7646d2SAndroid Build Coastguard Workerpages:</P>
310*5e7646d2SAndroid Build Coastguard Worker
311*5e7646d2SAndroid Build Coastguard Worker<PRE CLASS="command">
312*5e7646d2SAndroid Build Coastguard Workerlp -o sides=two-sided-short-edge filename
313*5e7646d2SAndroid Build Coastguard Workerlp -o sides=two-sided-long-edge filename
314*5e7646d2SAndroid Build Coastguard Workerlpr -o sides=two-sided-long-edge filename
315*5e7646d2SAndroid Build Coastguard Worker</PRE>
316*5e7646d2SAndroid Build Coastguard Worker
317*5e7646d2SAndroid Build Coastguard Worker<P>The default is to print single-sided:</P>
318*5e7646d2SAndroid Build Coastguard Worker
319*5e7646d2SAndroid Build Coastguard Worker<PRE CLASS="command">
320*5e7646d2SAndroid Build Coastguard Workerlp -o sides=one-sided filename
321*5e7646d2SAndroid Build Coastguard Workerlpr -o sides=one-sided filename
322*5e7646d2SAndroid Build Coastguard Worker</PRE>
323*5e7646d2SAndroid Build Coastguard Worker
324*5e7646d2SAndroid Build Coastguard Worker
325*5e7646d2SAndroid Build Coastguard Worker<H3><A NAME="JOBSHEETS">Selecting the Banner Page(s)</A></H3>
326*5e7646d2SAndroid Build Coastguard Worker
327*5e7646d2SAndroid Build Coastguard Worker<P>The <CODE>-o job-sheets=start,end</CODE> option sets the banner
328*5e7646d2SAndroid Build Coastguard Workerpage(s) to use for a job:</P>
329*5e7646d2SAndroid Build Coastguard Worker
330*5e7646d2SAndroid Build Coastguard Worker<PRE CLASS="command">
331*5e7646d2SAndroid Build Coastguard Workerlp -o job-sheets=none filename
332*5e7646d2SAndroid Build Coastguard Workerlp -o job-sheets=standard filename
333*5e7646d2SAndroid Build Coastguard Workerlpr -o job-sheets=classified,classified filename
334*5e7646d2SAndroid Build Coastguard Worker</PRE>
335*5e7646d2SAndroid Build Coastguard Worker
336*5e7646d2SAndroid Build Coastguard Worker<P>If only one banner file is specified, it will be printed
337*5e7646d2SAndroid Build Coastguard Workerbefore the files in the job. If a second banner file is
338*5e7646d2SAndroid Build Coastguard Workerspecified, it is printed after the files in the job.</P>
339*5e7646d2SAndroid Build Coastguard Worker
340*5e7646d2SAndroid Build Coastguard Worker<P>The available banner pages depend on the local system
341*5e7646d2SAndroid Build Coastguard Workerconfiguration; CUPS includes the following banner files:</P>
342*5e7646d2SAndroid Build Coastguard Worker
343*5e7646d2SAndroid Build Coastguard Worker<UL>
344*5e7646d2SAndroid Build Coastguard Worker
345*5e7646d2SAndroid Build Coastguard Worker	<LI><CODE>none</CODE> - Do not produce a banner page.
346*5e7646d2SAndroid Build Coastguard Worker
347*5e7646d2SAndroid Build Coastguard Worker	<LI><CODE>classified</CODE> - A banner page with a "classified"
348*5e7646d2SAndroid Build Coastguard Worker	label at the top and bottom.
349*5e7646d2SAndroid Build Coastguard Worker
350*5e7646d2SAndroid Build Coastguard Worker	<LI><CODE>confidential</CODE> - A banner page with a
351*5e7646d2SAndroid Build Coastguard Worker	"confidential" label at the top and bottom.
352*5e7646d2SAndroid Build Coastguard Worker
353*5e7646d2SAndroid Build Coastguard Worker	<LI><CODE>secret</CODE> - A banner page with a "secret" label
354*5e7646d2SAndroid Build Coastguard Worker	at the top and bottom.
355*5e7646d2SAndroid Build Coastguard Worker
356*5e7646d2SAndroid Build Coastguard Worker	<LI><CODE>standard</CODE> - A banner page with no label at the
357*5e7646d2SAndroid Build Coastguard Worker	top and bottom.
358*5e7646d2SAndroid Build Coastguard Worker
359*5e7646d2SAndroid Build Coastguard Worker	<LI><CODE>topsecret</CODE> - A banner page with a "top secret"
360*5e7646d2SAndroid Build Coastguard Worker	label at the top and bottom.
361*5e7646d2SAndroid Build Coastguard Worker
362*5e7646d2SAndroid Build Coastguard Worker	<LI><CODE>unclassified</CODE> - A banner page with an
363*5e7646d2SAndroid Build Coastguard Worker	"unclassified" label at the top and bottom.
364*5e7646d2SAndroid Build Coastguard Worker
365*5e7646d2SAndroid Build Coastguard Worker</UL>
366*5e7646d2SAndroid Build Coastguard Worker
367*5e7646d2SAndroid Build Coastguard Worker
368*5e7646d2SAndroid Build Coastguard Worker<H3><A NAME="JOBHOLDUNTIL">Holding Jobs for Later Printing</A></H3>
369*5e7646d2SAndroid Build Coastguard Worker
370*5e7646d2SAndroid Build Coastguard Worker<P>The <CODE>-o job-hold-until=when</CODE> option tells CUPS to
371*5e7646d2SAndroid Build Coastguard Workerdelay printing until the "when" time, which can be one of the
372*5e7646d2SAndroid Build Coastguard Workerfollowing:</P>
373*5e7646d2SAndroid Build Coastguard Worker
374*5e7646d2SAndroid Build Coastguard Worker<UL>
375*5e7646d2SAndroid Build Coastguard Worker
376*5e7646d2SAndroid Build Coastguard Worker	<LI><CODE>-o job-hold-until=indefinite</CODE>; print only
377*5e7646d2SAndroid Build Coastguard Worker	after released by the user or an administrator</LI>
378*5e7646d2SAndroid Build Coastguard Worker
379*5e7646d2SAndroid Build Coastguard Worker	<LI><CODE>-o job-hold-until=day-time</CODE>; print from
380*5e7646d2SAndroid Build Coastguard Worker	6am to 6pm local time</LI>
381*5e7646d2SAndroid Build Coastguard Worker
382*5e7646d2SAndroid Build Coastguard Worker	<LI><CODE>-o job-hold-until=night</CODE>; print from
383*5e7646d2SAndroid Build Coastguard Worker	6pm to 6am local time</LI>
384*5e7646d2SAndroid Build Coastguard Worker
385*5e7646d2SAndroid Build Coastguard Worker	<LI><CODE>-o job-hold-until=second-shift</CODE>; print from
386*5e7646d2SAndroid Build Coastguard Worker	4pm to 12am local time</LI>
387*5e7646d2SAndroid Build Coastguard Worker
388*5e7646d2SAndroid Build Coastguard Worker	<LI><CODE>-o job-hold-until=third-shift</CODE>; print from
389*5e7646d2SAndroid Build Coastguard Worker	12am to 8am local time</LI>
390*5e7646d2SAndroid Build Coastguard Worker
391*5e7646d2SAndroid Build Coastguard Worker	<LI><CODE>-o job-hold-until=weekend</CODE>; print on Saturday
392*5e7646d2SAndroid Build Coastguard Worker	or Sunday</LI>
393*5e7646d2SAndroid Build Coastguard Worker
394*5e7646d2SAndroid Build Coastguard Worker	<LI><CODE>-o job-hold-until=HH:MM</CODE>; print at the specified
395*5e7646d2SAndroid Build Coastguard Worker	UTC time</LI>
396*5e7646d2SAndroid Build Coastguard Worker
397*5e7646d2SAndroid Build Coastguard Worker</UL>
398*5e7646d2SAndroid Build Coastguard Worker
399*5e7646d2SAndroid Build Coastguard Worker<H3><A NAME="RELEASEJOB">Releasing Held Jobs</A></H3>
400*5e7646d2SAndroid Build Coastguard Worker
401*5e7646d2SAndroid Build Coastguard Worker<P>Aside from the web interface, you can use the <B>lp</B> command
402*5e7646d2SAndroid Build Coastguard Workerto release a held job:</P>
403*5e7646d2SAndroid Build Coastguard Worker
404*5e7646d2SAndroid Build Coastguard Worker<PRE CLASS="command">
405*5e7646d2SAndroid Build Coastguard Workerlp -i <em>job-id</em> -H resume
406*5e7646d2SAndroid Build Coastguard Worker</PRE>
407*5e7646d2SAndroid Build Coastguard Worker
408*5e7646d2SAndroid Build Coastguard Worker<P>where "job-id" is the job ID reported by the <B>lpstat</B>
409*5e7646d2SAndroid Build Coastguard Workercommand.</P>
410*5e7646d2SAndroid Build Coastguard Worker
411*5e7646d2SAndroid Build Coastguard Worker
412*5e7646d2SAndroid Build Coastguard Worker<H3><A NAME="JOBPRIORITY">Setting the Job Priority</A></H3>
413*5e7646d2SAndroid Build Coastguard Worker
414*5e7646d2SAndroid Build Coastguard Worker<P>The <CODE>-o job-priority=NNN</CODE> option tells CUPS to
415*5e7646d2SAndroid Build Coastguard Workerassign a priority to your job from 1 (lowest) to 100 (highest),
416*5e7646d2SAndroid Build Coastguard Workerwhich influences where the job appears in the print queue. Higher
417*5e7646d2SAndroid Build Coastguard Workerpriority jobs are printed before lower priority jobs, however
418*5e7646d2SAndroid Build Coastguard Workersubmitting a new job with a high priority will not interrupt an
419*5e7646d2SAndroid Build Coastguard Workeralready printing job.</P>
420*5e7646d2SAndroid Build Coastguard Worker
421*5e7646d2SAndroid Build Coastguard Worker
422*5e7646d2SAndroid Build Coastguard Worker<H3><A NAME="OUTPUTORDER">Specifying the Output Order</A></H3>
423*5e7646d2SAndroid Build Coastguard Worker
424*5e7646d2SAndroid Build Coastguard Worker<P>The <CODE>-o outputorder=normal</CODE> and <CODE>-o outputorder=reverse</CODE> options specify the order of the pages. Normal order prints page 1 first, page 2 second, and so forth. Reverse order prints page 1 last.</P>
425*5e7646d2SAndroid Build Coastguard Worker
426*5e7646d2SAndroid Build Coastguard Worker
427*5e7646d2SAndroid Build Coastguard Worker<H3><A NAME="PAGERANGES">Selecting a Range of Pages</A></H3>
428*5e7646d2SAndroid Build Coastguard Worker
429*5e7646d2SAndroid Build Coastguard Worker<P>The <CODE>-o page-ranges=pages</CODE> option selects a range
430*5e7646d2SAndroid Build Coastguard Workerof pages for printing:</P>
431*5e7646d2SAndroid Build Coastguard Worker
432*5e7646d2SAndroid Build Coastguard Worker<PRE CLASS="command">
433*5e7646d2SAndroid Build Coastguard Workerlp -o page-ranges=1 filename
434*5e7646d2SAndroid Build Coastguard Workerlp -o page-ranges=1-4 filename
435*5e7646d2SAndroid Build Coastguard Workerlp -o page-ranges=1-4,7,9-12 filename
436*5e7646d2SAndroid Build Coastguard Workerlpr -o page-ranges=1-4,7,9-12 filename
437*5e7646d2SAndroid Build Coastguard Worker</PRE>
438*5e7646d2SAndroid Build Coastguard Worker
439*5e7646d2SAndroid Build Coastguard Worker<P>As shown above, the <CODE>pages</CODE> value can be a single page, a
440*5e7646d2SAndroid Build Coastguard Workerrange of pages, or a collection of page numbers and ranges separated by
441*5e7646d2SAndroid Build Coastguard Workercommas. The pages will always be printed in ascending order, regardless
442*5e7646d2SAndroid Build Coastguard Workerof the order of the pages in the <CODE>page-ranges</CODE> option.
443*5e7646d2SAndroid Build Coastguard Worker
444*5e7646d2SAndroid Build Coastguard Worker<P>The default is to print all pages.
445*5e7646d2SAndroid Build Coastguard Worker
446*5e7646d2SAndroid Build Coastguard Worker<blockquote><b>Note:</b>
447*5e7646d2SAndroid Build Coastguard Worker
448*5e7646d2SAndroid Build Coastguard Worker<p>The page numbers used by <code>page-ranges</code> refer to the output
449*5e7646d2SAndroid Build Coastguard Workerpages and not the document's page numbers. Options like <code>number-up</code>
450*5e7646d2SAndroid Build Coastguard Workercan make the output page numbering not match the document page numbers.</p>
451*5e7646d2SAndroid Build Coastguard Worker
452*5e7646d2SAndroid Build Coastguard Worker</blockquote>
453*5e7646d2SAndroid Build Coastguard Worker
454*5e7646d2SAndroid Build Coastguard Worker
455*5e7646d2SAndroid Build Coastguard Worker<H3><A NAME="NUMBERUP">N-Up Printing</A></H3>
456*5e7646d2SAndroid Build Coastguard Worker
457*5e7646d2SAndroid Build Coastguard Worker<P>The <CODE>-o number-up=value</CODE> option selects N-Up
458*5e7646d2SAndroid Build Coastguard Workerprinting. N-Up printing places multiple document pages on a
459*5e7646d2SAndroid Build Coastguard Workersingle printed page. CUPS supports 1, 2, 4, 6, 9, and 16-Up
460*5e7646d2SAndroid Build Coastguard Workerformats; the default format is 1-Up:</P>
461*5e7646d2SAndroid Build Coastguard Worker
462*5e7646d2SAndroid Build Coastguard Worker<PRE CLASS="command">
463*5e7646d2SAndroid Build Coastguard Workerlp -o number-up=1 filename
464*5e7646d2SAndroid Build Coastguard Workerlp -o number-up=2 filename
465*5e7646d2SAndroid Build Coastguard Workerlp -o number-up=4 filename
466*5e7646d2SAndroid Build Coastguard Workerlpr -o number-up=16 filename
467*5e7646d2SAndroid Build Coastguard Worker</PRE>
468*5e7646d2SAndroid Build Coastguard Worker
469*5e7646d2SAndroid Build Coastguard Worker<P>The <CODE>-o page-border=value</CODE> option chooses the
470*5e7646d2SAndroid Build Coastguard Workerborder to draw around each page:</P>
471*5e7646d2SAndroid Build Coastguard Worker
472*5e7646d2SAndroid Build Coastguard Worker<UL>
473*5e7646d2SAndroid Build Coastguard Worker	<LI><CODE>-o page-border=double</CODE>; draw two hairline borders around each page</LI>
474*5e7646d2SAndroid Build Coastguard Worker	<LI><CODE>-o page-border=double-thick</CODE>; draw two 1pt borders around each page</LI>
475*5e7646d2SAndroid Build Coastguard Worker	<LI><CODE>-o page-border=none</CODE>; do not draw a border (default)</LI>
476*5e7646d2SAndroid Build Coastguard Worker	<LI><CODE>-o page-border=single</CODE>; draw one hairline border around each page</LI>
477*5e7646d2SAndroid Build Coastguard Worker	<LI><CODE>-o page-border=single-thick</CODE>; draw one 1pt border around each page</LI>
478*5e7646d2SAndroid Build Coastguard Worker</UL>
479*5e7646d2SAndroid Build Coastguard Worker
480*5e7646d2SAndroid Build Coastguard Worker<P>The <CODE>-o number-up-layout=value</CODE> option chooses the
481*5e7646d2SAndroid Build Coastguard Workerlayout of the pages on each output page:</P>
482*5e7646d2SAndroid Build Coastguard Worker
483*5e7646d2SAndroid Build Coastguard Worker<UL>
484*5e7646d2SAndroid Build Coastguard Worker	<LI><CODE>-o number-up-layout=btlr</CODE>; Bottom to top, left to right</LI>
485*5e7646d2SAndroid Build Coastguard Worker	<LI><CODE>-o number-up-layout=btrl</CODE>; Bottom to top, right to left</LI>
486*5e7646d2SAndroid Build Coastguard Worker	<LI><CODE>-o number-up-layout=lrbt</CODE>; Left to right, bottom to top</LI>
487*5e7646d2SAndroid Build Coastguard Worker	<LI><CODE>-o number-up-layout=lrtb</CODE>; Left to right, top to bottom (default)</LI>
488*5e7646d2SAndroid Build Coastguard Worker	<LI><CODE>-o number-up-layout=rlbt</CODE>; Right to left, bottom to top</LI>
489*5e7646d2SAndroid Build Coastguard Worker	<LI><CODE>-o number-up-layout=rltb</CODE>; Right to left, top to bottom</LI>
490*5e7646d2SAndroid Build Coastguard Worker	<LI><CODE>-o number-up-layout=tblr</CODE>; Top to bottom, left to right</LI>
491*5e7646d2SAndroid Build Coastguard Worker	<LI><CODE>-o number-up-layout=tbrl</CODE>; Top to bottom, right to left</LI>
492*5e7646d2SAndroid Build Coastguard Worker</UL>
493*5e7646d2SAndroid Build Coastguard Worker
494*5e7646d2SAndroid Build Coastguard Worker<H3><A NAME="FIT_TO_PAGE">Scaling to Fit</A></H3>
495*5e7646d2SAndroid Build Coastguard Worker
496*5e7646d2SAndroid Build Coastguard Worker<P>The <CODE>-o fit-to-page</CODE> option specifies that the document
497*5e7646d2SAndroid Build Coastguard Workershould be scaled to fit on the page:</P>
498*5e7646d2SAndroid Build Coastguard Worker
499*5e7646d2SAndroid Build Coastguard Worker<PRE CLASS="command">
500*5e7646d2SAndroid Build Coastguard Workerlp -o fit-to-page filename
501*5e7646d2SAndroid Build Coastguard Workerlpr -o fit-to-page filename
502*5e7646d2SAndroid Build Coastguard Worker</PRE>
503*5e7646d2SAndroid Build Coastguard Worker
504*5e7646d2SAndroid Build Coastguard Worker<P>The default is to use the size specified in the file.</P>
505*5e7646d2SAndroid Build Coastguard Worker
506*5e7646d2SAndroid Build Coastguard Worker<BLOCKQUOTE><B>Note:</B>
507*5e7646d2SAndroid Build Coastguard Worker
508*5e7646d2SAndroid Build Coastguard Worker<P>This feature depends upon an accurate size in
509*5e7646d2SAndroid Build Coastguard Workerthe print file. If no size is given in the file, the page may be
510*5e7646d2SAndroid Build Coastguard Workerscaled incorrectly!
511*5e7646d2SAndroid Build Coastguard Worker
512*5e7646d2SAndroid Build Coastguard Worker</BLOCKQUOTE>
513*5e7646d2SAndroid Build Coastguard Worker
514*5e7646d2SAndroid Build Coastguard Worker<H3><A NAME="OUTPUTORDER">Printing in Reverse Order</A></H3>
515*5e7646d2SAndroid Build Coastguard Worker
516*5e7646d2SAndroid Build Coastguard Worker<P>The <CODE>-o outputorder=reverse</CODE> option will print the
517*5e7646d2SAndroid Build Coastguard Workerpages in reverse order:</P>
518*5e7646d2SAndroid Build Coastguard Worker
519*5e7646d2SAndroid Build Coastguard Worker<PRE CLASS="command">
520*5e7646d2SAndroid Build Coastguard Workerlp -o outputorder=reverse filename
521*5e7646d2SAndroid Build Coastguard Workerlpr -o outputorder=reverse filename
522*5e7646d2SAndroid Build Coastguard Worker</PRE>
523*5e7646d2SAndroid Build Coastguard Worker
524*5e7646d2SAndroid Build Coastguard Worker<P>Similarly, the <CODE>-o outputorder=normal</CODE> option will
525*5e7646d2SAndroid Build Coastguard Workerprint starting with page 1:</P>
526*5e7646d2SAndroid Build Coastguard Worker
527*5e7646d2SAndroid Build Coastguard Worker<PRE CLASS="command">
528*5e7646d2SAndroid Build Coastguard Workerlp -o outputorder=normal filename
529*5e7646d2SAndroid Build Coastguard Workerlpr -o outputorder=normal filename
530*5e7646d2SAndroid Build Coastguard Worker</PRE>
531*5e7646d2SAndroid Build Coastguard Worker
532*5e7646d2SAndroid Build Coastguard Worker<P>The default is <CODE>-o outputorder=normal</CODE> for
533*5e7646d2SAndroid Build Coastguard Workerprinters that print face down and <CODE>-o outputorder=reverse</CODE>
534*5e7646d2SAndroid Build Coastguard Workerfor printers that print face up.
535*5e7646d2SAndroid Build Coastguard Worker
536*5e7646d2SAndroid Build Coastguard Worker<H3><A NAME="MIRROR">Printing Mirrored Pages</A></H3>
537*5e7646d2SAndroid Build Coastguard Worker
538*5e7646d2SAndroid Build Coastguard Worker<P>The <CODE>-o mirror</CODE> option flips each page along the
539*5e7646d2SAndroid Build Coastguard Workervertical axis to produce a mirrored image:</P>
540*5e7646d2SAndroid Build Coastguard Worker
541*5e7646d2SAndroid Build Coastguard Worker<PRE CLASS="command">
542*5e7646d2SAndroid Build Coastguard Workerlp -o mirror filename
543*5e7646d2SAndroid Build Coastguard Workerlpr -o mirror filename
544*5e7646d2SAndroid Build Coastguard Worker</PRE>
545*5e7646d2SAndroid Build Coastguard Worker
546*5e7646d2SAndroid Build Coastguard Worker<P>This is typically used when printing on T-shirt transfer
547*5e7646d2SAndroid Build Coastguard Workermedia or sometimes on transparencies.</P>
548*5e7646d2SAndroid Build Coastguard Worker
549*5e7646d2SAndroid Build Coastguard Worker</BODY>
550*5e7646d2SAndroid Build Coastguard Worker</HTML>
551