]>
Commit | Line | Data |
---|---|---|
1 | .\" | |
2 | .\" lp man page for CUPS. | |
3 | .\" | |
4 | .\" Copyright 2007-2014 by Apple Inc. | |
5 | .\" Copyright 1997-2006 by Easy Software Products. | |
6 | .\" | |
7 | .\" These coded instructions, statements, and computer programs are the | |
8 | .\" property of Apple Inc. and are protected by Federal copyright | |
9 | .\" law. Distribution and use rights are outlined in the file "LICENSE.txt" | |
10 | .\" which should have been included with this file. If this file is | |
11 | .\" file is missing or damaged, see the license at "http://www.cups.org/". | |
12 | .\" | |
13 | .TH lp 1 "CUPS" "11 June 2014" "Apple Inc." | |
14 | .SH NAME | |
15 | lp \- print files | |
16 | .SH SYNOPSIS | |
17 | .B lp | |
18 | [ | |
19 | .B \-E | |
20 | ] [ | |
21 | .B \-U | |
22 | .I username | |
23 | ] [ | |
24 | .B \-c | |
25 | ] [ | |
26 | \fB\-d \fIdestination\fR[\fB/\fIinstance\fR] | |
27 | ] [ | |
28 | \fB\-h \fIhostname\fR[\fB:\fIport\fR] | |
29 | ] [ | |
30 | .B \-m | |
31 | ] [ | |
32 | .B \-n | |
33 | .I num-copies | |
34 | ] [ | |
35 | \fB\-o \fIoption\fR[\fB=\fIvalue\fR] | |
36 | ] [ | |
37 | .B \-q | |
38 | .I priority | |
39 | ] [ | |
40 | .B \-s | |
41 | ] [ | |
42 | .B \-t | |
43 | .I title | |
44 | ] [ | |
45 | .B \-H | |
46 | .I handling | |
47 | ] [ | |
48 | .B \-P | |
49 | .I page-list | |
50 | ] [ | |
51 | .B \-\- | |
52 | ] [ | |
53 | .I file(s) | |
54 | ] | |
55 | .br | |
56 | .B lp | |
57 | [ | |
58 | .B \-E | |
59 | ] [ | |
60 | .B \-U | |
61 | .I username | |
62 | ] [ | |
63 | .B \-c | |
64 | ] [ | |
65 | \fB\-h \fIhostname\fR[\fB:\fIport\fR] | |
66 | ] [ | |
67 | .B \-i | |
68 | .I job-id | |
69 | ] [ | |
70 | .B \-n | |
71 | .I num-copies | |
72 | ] [ | |
73 | \fB\-o \fIoption\fR[\fB=\fIvalue\fR] | |
74 | ] [ | |
75 | .B \-q | |
76 | .I priority | |
77 | ] [ | |
78 | .B \-t | |
79 | .I title | |
80 | ] [ | |
81 | .B \-H | |
82 | .I handling | |
83 | ] [ | |
84 | .B \-P | |
85 | .I page-list | |
86 | ] | |
87 | .SH DESCRIPTION | |
88 | \fBlp\fR submits files for printing or alters a pending job. | |
89 | Use a filename of "-" to force printing from the standard input. | |
90 | .SS THE DEFAULT DESTINATION | |
91 | CUPS provides many ways to set the default destination. The \fBLPDEST\fR and \fBPRINTER\fR environment variables are consulted first. | |
92 | If neither are set, the current default set using the | |
93 | .BR lpoptions (1) | |
94 | command is used, followed by the default set using the | |
95 | .BR lpadmin (8) | |
96 | command. | |
97 | .SH OPTIONS | |
98 | The following options are recognized by \fIlp\fR: | |
99 | .TP 5 | |
100 | .B \-\- | |
101 | Marks the end of options; use this to print a file whose name begins with a dash (\-). | |
102 | .TP 5 | |
103 | .B \-E | |
104 | Forces encryption when connecting to the server. | |
105 | .TP 5 | |
106 | \fB\-U \fIusername\fR | |
107 | Specifies the username to use when connecting to the server. | |
108 | .TP 5 | |
109 | .B \-c | |
110 | This option is provided for backwards-compatibility only. On systems that support it, this option forces the print file to be copied to the spool directory before printing. | |
111 | In CUPS, print files are always sent to the scheduler via IPP which has the same effect. | |
112 | .TP 5 | |
113 | \fB\-d \fIdestination\fR | |
114 | Prints files to the named printer. | |
115 | .TP 5 | |
116 | \fB\-h \fIhostname\fR[\fB:\fIport\fR] | |
117 | Chooses an alternate server. | |
118 | .TP 5 | |
119 | \fB\-i \fIjob-id\fR | |
120 | Specifies an existing job to modify. | |
121 | .TP 5 | |
122 | .B \-m | |
123 | Sends an email when the job is completed. | |
124 | .TP 5 | |
125 | \fB\-n \fIcopies\fR | |
126 | Sets the number of copies to print. | |
127 | .TP 5 | |
128 | \fB\-o "\fIname\fB=\fIvalue \fR[ ... \fIname\fB=\fIvalue \fR]\fB"\fR | |
129 | Sets one or more job options. | |
130 | .TP 5 | |
131 | \fB\-q \fIpriority\fR | |
132 | Sets the job priority from 1 (lowest) to 100 (highest). | |
133 | The default priority is 50. | |
134 | .TP 5 | |
135 | .B \-s | |
136 | Do not report the resulting job IDs (silent mode.) | |
137 | .TP 5 | |
138 | \fB\-t "\fIname\fB"\fR | |
139 | Sets the job name. | |
140 | .TP 5 | |
141 | \fB\-H \fIhh:mm\fR | |
142 | .TP 5 | |
143 | \fB\-H hold\fR | |
144 | .TP 5 | |
145 | \fB-H immediate\fR | |
146 | .TP 5 | |
147 | \fB-H restart\fR | |
148 | .TP 5 | |
149 | \fB-H resume\fR | |
150 | Specifies when the job should be printed. | |
151 | A value of \fIimmediate\fR will print the file immediately, a value of \fIhold\fR will hold the job indefinitely, and a UTC time value (HH:MM) will hold the job until the specified UTC (not local) time. | |
152 | Use a value of \fIresume\fR with the \fI-i\fR option to resume a held job. | |
153 | Use a value of \fIrestart\fR with the \fI-i\fR option to restart a completed job. | |
154 | .TP 5 | |
155 | \fB\-P \fIpage-list\fR | |
156 | Specifies which pages to print in the document. | |
157 | The list can contain a list of numbers and ranges (#-#) separated by commas, e.g., "1,3-5,16". | |
158 | 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. | |
159 | .SS COMMON JOB OPTIONS | |
160 | Aside from the printer-specific options reported by the | |
161 | .BR lpoptions (1) | |
162 | command, the following generic options are available: | |
163 | .TP 5 | |
164 | \fB\-o media=\fIsize\fR | |
165 | Sets the page size to \fIsize\fR. Most printers support at least the size names "a4", "letter", and "legal". | |
166 | .TP 5 | |
167 | \fB\-o orientation\-requested=4\fR | |
168 | Prints the job in landscape (rotated 90 degrees). | |
169 | .TP 5 | |
170 | \fB\-o sides=one\-sided\fR | |
171 | Prints on one side of the paper. | |
172 | .TP 5 | |
173 | \fB\-o sides=two\-sided\-long\-edge\fR | |
174 | Prints on both sides of the paper for portrait output. | |
175 | .TP 5 | |
176 | \fB\-o sides=two\-sided\-short\-edge\fR | |
177 | Prints on both sides of the paper for landscape output. | |
178 | .TP 5 | |
179 | \fB\-o fit\-to\-page\fR | |
180 | Scales the print file to fit on the page. | |
181 | .TP 5 | |
182 | \fB\-o number\-up=\fR{\fI2|4|6|9|16\fR} | |
183 | Prints 2, 4, 6, 9, or 16 document (input) pages on each output page. | |
184 | .SH CONFORMING TO | |
185 | Unlike the System V printing system, CUPS allows printer names to contain any printable character except SPACE, TAB, "/", or "#". | |
186 | Also, printer and class names are \fInot\fR case-sensitive. | |
187 | .LP | |
188 | The \fI-q\fR option accepts a different range of values than the 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). | |
189 | .SH EXAMPLES | |
190 | Print two copies of a document to the default printer: | |
191 | .nf | |
192 | ||
193 | lp -n 2 filename | |
194 | ||
195 | .fi | |
196 | Print a double-sided legal document to a printer called "foo": | |
197 | .nf | |
198 | ||
199 | lp -d foo -o media=legal -o sides=two-sided-long-edge filename | |
200 | ||
201 | .fi | |
202 | Print a presentation document 2-up to a printer called "foo": | |
203 | .nf | |
204 | ||
205 | lp -d foo -o number-up=2 filename | |
206 | .fi | |
207 | .SH SEE ALSO | |
208 | .BR cancel (1), | |
209 | .BR lpadmin (8), | |
210 | .BR lpoptions (1), | |
211 | .BR lpq (1), | |
212 | .BR lpr (1), | |
213 | .BR lprm (1), | |
214 | .BR lpstat (1), | |
215 | CUPS Online Help (http://localhost:631/help) | |
216 | .SH COPYRIGHT | |
217 | Copyright \[co] 2007-2015 by Apple Inc. |