]>
Commit | Line | Data |
---|---|---|
c277f98c | 1 | <!DOCTYPE HTML> |
94436c5a MS |
2 | <html> |
3 | <!-- SECTION: Man Pages --> | |
4 | <head> | |
5 | <link rel="stylesheet" type="text/css" href="../cups-printable.css"> | |
6 | <title>lpr(1)</title> | |
7 | </head> | |
8 | <body> | |
9 | <h1 class="title">lpr(1)</h1> | |
10 | <h2 class="title"><a name="NAME">Name</a></h2> | |
11 | lpr - print files | |
12 | <h2 class="title"><a name="SYNOPSIS">Synopsis</a></h2> | |
c277f98c | 13 | <b>lpr</b> |
cfa19b58 MS |
14 | [ |
15 | <b>-E</b> | |
16 | ] [ | |
17 | <b>-H </b><i>server</i>[<b>:</b><i>port</i>] | |
18 | ] [ | |
19 | <b>-U</b> | |
c277f98c | 20 | <i>username</i> |
cfa19b58 MS |
21 | ] [ |
22 | <b>-P </b><i>destination</i>[<b>/</b><i>instance</i>] | |
23 | ] [ | |
24 | <b>-#</b> | |
c277f98c | 25 | <i>num-copies</i> |
cfa19b58 MS |
26 | [ |
27 | <b>-h</b> | |
28 | ] [ | |
29 | <b>-l</b> | |
30 | ] [ | |
31 | <b>-m</b> | |
32 | ] [ | |
33 | <b>-o </b><i>option</i>[<b>=</b><i>value</i>] | |
34 | ] [ | |
35 | <b>-p</b> | |
36 | ] [ | |
37 | <b>-q</b> | |
38 | ] [ | |
39 | <b>-r</b> | |
40 | ] [ | |
41 | <b>-C</b> | |
42 | <i>title</i> | |
43 | ] [ | |
44 | <b>-J</b> | |
45 | <i>title</i> | |
46 | ] [ | |
47 | <b>-T</b> | |
c277f98c MS |
48 | <i>title</i> |
49 | ] [ | |
50 | <i>file(s)</i> | |
51 | ] | |
94436c5a | 52 | <h2 class="title"><a name="DESCRIPTION">Description</a></h2> |
cfa19b58 MS |
53 | <b>lpr</b> submits files for printing. |
54 | Files named on the command line are sent to the named printer or the default destination if no destination is specified. | |
55 | If no files are listed on the command-line, <b>lpr</b> reads the print file from the standard input. | |
56 | <h3><a name="THE_DEFAULT_DESTINATION">The Default Destination</a></h3> | |
57 | CUPS provides many ways to set the default destination. The <b>LPDEST</b> and <b>PRINTER</b> environment variables are consulted first. | |
58 | If neither are set, the current default set using the | |
59 | <a href="man-lpoptions.html?TOPIC=Man+Pages"><b>lpoptions</b>(1)</a> | |
60 | command is used, followed by the default set using the | |
61 | <a href="man-lpadmin.html?TOPIC=Man+Pages"><b>lpadmin</b>(8)</a> | |
62 | command. | |
94436c5a MS |
63 | <h2 class="title"><a name="OPTIONS">Options</a></h2> |
64 | The following options are recognized by <i>lpr</i>: | |
2909c66c | 65 | <dl class="man"> |
cfa19b58 MS |
66 | <dt><b>-E</b> |
67 | <dd style="margin-left: 5.0em">Forces encryption when connecting to the server. | |
68 | <dt><b>-H </b><i>server</i>[<b>:</b><i>port</i>] | |
69 | <dd style="margin-left: 5.0em">Specifies an alternate server. | |
70 | <dt><b>-C "</b><i>name</i><b>"</b> | |
71 | <dd style="margin-left: 5.0em"><dt><b>-J "</b><i>name</i><b>"</b> | |
72 | <dd style="margin-left: 5.0em"><dt><b>-T "</b><i>name</i><b>"</b> | |
73 | <dd style="margin-left: 5.0em">Sets the job name/title. | |
74 | <dt><b>-P </b><i>destination</i>[<b>/</b><i>instance</i>] | |
75 | <dd style="margin-left: 5.0em">Prints files to the named printer. | |
76 | <dt><b>-U </b><i>username</i> | |
77 | <dd style="margin-left: 5.0em">Specifies an alternate username. | |
78 | <dt><b>-# </b><i>copies</i> | |
79 | <dd style="margin-left: 5.0em">Sets the number of copies to print. | |
80 | <dt><b>-h</b> | |
81 | <dd style="margin-left: 5.0em">Disables banner printing. This option is equivalent to <i>-o job-sheets=none</i>. | |
82 | <dt><b>-l</b> | |
83 | <dd style="margin-left: 5.0em">Specifies that the print file is already formatted for the destination and should be sent without filtering. | |
84 | This option is equivalent to <i>-o raw</i>. | |
85 | <dt><b>-m</b> | |
86 | <dd style="margin-left: 5.0em">Send an email on job completion. | |
87 | <dt><b>-o </b><i>option</i>[<b>=</b><i>value</i>] | |
88 | <dd style="margin-left: 5.0em">Sets a job option. | |
423e6ddb | 89 | See "COMMON JOB OPTIONS" below. |
cfa19b58 MS |
90 | <dt><b>-p</b> |
91 | <dd style="margin-left: 5.0em">Specifies that the print file should be formatted with a shaded header with the date, time, job name, and page number. | |
92 | This option is equivalent to <i>-o prettyprint</i> and is only useful when printing text files. | |
93 | <dt><b>-q</b> | |
94 | <dd style="margin-left: 5.0em">Hold job for printing. | |
95 | <dt><b>-r</b> | |
96 | <dd style="margin-left: 5.0em">Specifies that the named print files should be deleted after submitting them. | |
2909c66c | 97 | </dl> |
423e6ddb MS |
98 | <h3><a name="COMMON_JOB_OPTIONS">Common Job Options</a></h3> |
99 | Aside from the printer-specific options reported by the | |
100 | <a href="man-lpoptions.html?TOPIC=Man+Pages"><b>lpoptions</b>(1)</a> | |
101 | command, the following generic options are available: | |
102 | <dl class="man"> | |
103 | <dt><b>-o collate=true</b> | |
104 | <dd style="margin-left: 5.0em">Prints collated copies. | |
105 | <dt><b>-o fit-to-page</b> | |
106 | <dd style="margin-left: 5.0em">Scales the print file to fit on the page. | |
107 | <dt><b>-o job-hold-until=</b><i>when</i> | |
108 | <dd style="margin-left: 5.0em">Holds the job until the specified local time. | |
109 | "when" can be "indefinite" to hold the until released, "day-time" to print the job between 6am and 6pm local time, "night" to print the job between 6pm and 6am local time, "second-shift" to print the job between 4pm and 12am local time, "third-shift" to print the job between 12am and 8am local time, or "weekend" to print the job on Saturday or Sunday. | |
110 | <dt><b>-o job-hold-until=</b><i>hh:mm</i> | |
111 | <dd style="margin-left: 5.0em">Holds the job until the specified time in hours and minutes UTC. | |
112 | <dt><b>-o job-priority=</b><i>priority</i> | |
113 | <dd style="margin-left: 5.0em">Set the priority to a value from 1 (lowest) to 100 (highest), which influences when a job is scheduled for printing. | |
114 | The default priority is typically 50. | |
115 | <dt><b>-o job-sheets=</b><i>name</i> | |
116 | <dd style="margin-left: 5.0em">Prints a cover page (banner) with the document. | |
117 | The "name" can be "classified", "confidential", "secret", "standard", "topsecret", or "unclassified". | |
118 | <dt><b>-o job-sheets=</b><i>start-name,end-name</i> | |
119 | <dd style="margin-left: 5.0em">Prints cover pages (banners) with the document. | |
120 | <dt><b>-o media=</b><i>size</i> | |
121 | <dd style="margin-left: 5.0em">Sets the page size to <i>size</i>. Most printers support at least the size names "a4", "letter", and "legal". | |
122 | <dt><b>-o mirror</b> | |
123 | <dd style="margin-left: 5.0em">Mirrors each page. | |
124 | <dt><b>-o number-up=</b>{<i>2|4|6|9|16</i>} | |
125 | <dd style="margin-left: 5.0em">Prints 2, 4, 6, 9, or 16 document (input) pages on each output page. | |
126 | <dt><b>-o number-up-layout=</b><i>layout</i> | |
127 | <dd style="margin-left: 5.0em">Specifies the layout of pages with the "number-up" option. | |
128 | The "layout" string can be "btlr", "btrl", "lrbt", "lrtb", "rlbt", "rltb", "tblr", or "tbrl" - the first two letters determine the column order while the second two letters determine the row order. | |
129 | "bt" is bottom-to-top, "lr" is left-to-right, "rl" is right-to-left, and "tb" is top-to-bottom. | |
130 | <dt><b>-o orientation-requested=4</b> | |
131 | <dd style="margin-left: 5.0em">Prints the job in landscape (rotated 90 degrees counter-clockwise). | |
132 | <dt><b>-o orientation-requested=5</b> | |
133 | <dd style="margin-left: 5.0em">Prints the job in landscape (rotated 90 degrees clockwise). | |
134 | <dt><b>-o orientation-requested=6</b> | |
135 | <dd style="margin-left: 5.0em">Prints the job in reverse portrait (rotated 180 degrees). | |
136 | <dt><b>-o outputorder=reverse</b> | |
137 | <dd style="margin-left: 5.0em">Prints pages in reverse order. | |
138 | <dt><b>-o page-border=</b><i>border</i> | |
139 | <dd style="margin-left: 5.0em">Prints a border around each document page. | |
140 | "border" is "double", "double-thick", "single", or "single-thick". | |
141 | <dt><b>-o page-ranges=</b><i>page-list</i> | |
142 | <dd style="margin-left: 5.0em">Specifies which pages to print in the document. | |
143 | The list can contain a list of numbers and ranges (#-#) separated by commas, e.g., "1,3-5,16". | |
144 | The page numbers refer to the output pages and not the document's original pages - options like "number-up" can affect the numbering of the pages. | |
145 | <dt><b>-o sides=one-sided</b> | |
146 | <dd style="margin-left: 5.0em">Prints on one side of the paper. | |
147 | <dt><b>-o sides=two-sided-long-edge</b> | |
148 | <dd style="margin-left: 5.0em">Prints on both sides of the paper for portrait output. | |
149 | <dt><b>-o sides=two-sided-short-edge</b> | |
150 | <dd style="margin-left: 5.0em">Prints on both sides of the paper for landscape output. | |
151 | </dl> | |
cfa19b58 MS |
152 | <h2 class="title"><a name="NOTES">Notes</a></h2> |
153 | The <i>-c</i>, <i>-d</i>, <i>-f</i>, <i>-g</i>, <i>-i</i>, <i>-n</i>, <i>-t</i>, <i>-v</i>, and <i>-w</i> options are not supported by CUPS and produce a warning message if used. | |
154 | <h2 class="title"><a name="EXAMPLES">Examples</a></h2> | |
155 | Print two copies of a document to the default printer: | |
156 | <pre class="man"> | |
157 | ||
158 | lpr -# 2 filename | |
159 | ||
160 | </pre> | |
161 | Print a double-sided legal document to a printer called "foo": | |
162 | <pre class="man"> | |
163 | ||
164 | lpr -P foo -o media=legal -o sides=two-sided-long-edge filename | |
165 | ||
166 | </pre> | |
167 | Print a presentation document 2-up to a printer called "foo": | |
168 | <pre class="man"> | |
169 | ||
170 | lpr -P foo -o number-up=2 filename | |
171 | </pre> | |
94436c5a | 172 | <h2 class="title"><a name="SEE_ALSO">See Also</a></h2> |
cfa19b58 MS |
173 | <a href="man-cancel.html?TOPIC=Man+Pages"><b>cancel</b>(1),</a> |
174 | <a href="man-lp.html?TOPIC=Man+Pages"><b>lp</b>(1),</a> | |
175 | <a href="man-lpadmin.html?TOPIC=Man+Pages"><b>lpadmin</b>(8),</a> | |
176 | <a href="man-lpoptions.html?TOPIC=Man+Pages"><b>lpoptions</b>(1),</a> | |
177 | <a href="man-lpq.html?TOPIC=Man+Pages"><b>lpq</b>(1),</a> | |
178 | <a href="man-lprm.html?TOPIC=Man+Pages"><b>lprm</b>(1),</a> | |
179 | <a href="man-lpstat.html?TOPIC=Man+Pages"><b>lpstat</b>(1),</a> | |
180 | CUPS Online Help (<a href="http://localhost:631/help">http://localhost:631/help</a>) | |
94436c5a | 181 | <h2 class="title"><a name="COPYRIGHT">Copyright</a></h2> |
afad2da2 | 182 | Copyright © 2007-2018 by Apple Inc. |
94436c5a MS |
183 | |
184 | </body> | |
185 | </html> |