]>
Commit | Line | Data |
---|---|---|
ef416fc2 | 1 | .\" |
cfa19b58 | 2 | .\" lpr man page for CUPS. |
ef416fc2 | 3 | .\" |
cfa19b58 MS |
4 | .\" Copyright 2007-2013 by Apple Inc. |
5 | .\" Copyright 1997-2006 by Easy Software Products. | |
ef416fc2 | 6 | .\" |
cfa19b58 MS |
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/". | |
ef416fc2 | 12 | .\" |
cfa19b58 | 13 | .TH lpr 1 "CUPS" "11 June 2014" "Apple Inc." |
ef416fc2 | 14 | .SH NAME |
15 | lpr \- print files | |
16 | .SH SYNOPSIS | |
17 | .B lpr | |
cfa19b58 MS |
18 | [ |
19 | .B \-E | |
20 | ] [ | |
21 | \fB\-H \fIserver\fR[\fB:\fIport\fR] | |
22 | ] [ | |
23 | .B \-U | |
ef416fc2 | 24 | .I username |
cfa19b58 MS |
25 | ] [ |
26 | \fB\-P \fIdestination\fR[\fB/\fIinstance\fR] | |
27 | ] [ | |
28 | .B \-# | |
ef416fc2 | 29 | .I num-copies |
cfa19b58 MS |
30 | [ |
31 | .B \-h | |
32 | ] [ | |
33 | .B \-l | |
34 | ] [ | |
35 | .B \-m | |
36 | ] [ | |
37 | \fB\-o \fIoption\fR[\fB=\fIvalue\fR] | |
38 | ] [ | |
39 | .B \-p | |
40 | ] [ | |
41 | .B \-q | |
42 | ] [ | |
43 | .B \-r | |
44 | ] [ | |
45 | .B \-C | |
46 | .I title | |
47 | ] [ | |
48 | .B \-J | |
49 | .I title | |
50 | ] [ | |
51 | .B \-T | |
ef416fc2 | 52 | .I title |
53 | ] [ | |
54 | .I file(s) | |
55 | ] | |
56 | .SH DESCRIPTION | |
cfa19b58 MS |
57 | \fBlpr\fR submits files for printing. |
58 | Files named on the command line are sent to the named printer or the default destination if no destination is specified. | |
59 | If no files are listed on the command-line, \fBlpr\fR reads the print file from the standard input. | |
60 | .SS THE DEFAULT DESTINATION | |
61 | CUPS provides many ways to set the default destination. The \fBLPDEST\fR and \fBPRINTER\fR environment variables are consulted first. | |
62 | If neither are set, the current default set using the | |
63 | .BR lpoptions (1) | |
64 | command is used, followed by the default set using the | |
65 | .BR lpadmin (8) | |
66 | command. | |
ef416fc2 | 67 | .SH OPTIONS |
bd7854cb | 68 | The following options are recognized by \fIlpr\fR: |
ef416fc2 | 69 | .TP 5 |
cfa19b58 | 70 | .B \-E |
ef416fc2 | 71 | Forces encryption when connecting to the server. |
72 | .TP 5 | |
cfa19b58 | 73 | \fB\-H \fIserver\fR[\fB:\fIport\fR] |
bd7854cb | 74 | Specifies an alternate server. |
ef416fc2 | 75 | .TP 5 |
cfa19b58 | 76 | \fB\-C "\fIname\fB"\fR |
bd7854cb | 77 | .TP 5 |
cfa19b58 | 78 | \fB\-J "\fIname\fB"\fR |
ef416fc2 | 79 | .TP 5 |
cfa19b58 MS |
80 | \fB\-T "\fIname\fB"\fR |
81 | Sets the job name/title. | |
ef416fc2 | 82 | .TP 5 |
cfa19b58 | 83 | \fB\-P \fIdestination\fR[\fB/\fIinstance\fR] |
bd7854cb | 84 | Prints files to the named printer. |
ef416fc2 | 85 | .TP 5 |
cfa19b58 | 86 | \fB\-U \fIusername\fR |
bd7854cb | 87 | Specifies an alternate username. |
ef416fc2 | 88 | .TP 5 |
cfa19b58 MS |
89 | \fB\-# \fIcopies\fR |
90 | Sets the number of copies to print. | |
bd7854cb | 91 | .TP 5 |
cfa19b58 MS |
92 | .B \-h |
93 | Disables banner printing. This option is equivalent to \fI-o job\-sheets=none\fR. | |
ef416fc2 | 94 | .TP 5 |
cfa19b58 MS |
95 | .B \-l |
96 | Specifies that the print file is already formatted for the destination and should be sent without filtering. | |
97 | This option is equivalent to \fI-o raw\fR. | |
ef416fc2 | 98 | .TP 5 |
cfa19b58 | 99 | .B \-m |
bd7854cb | 100 | Send an email on job completion. |
101 | .TP 5 | |
cfa19b58 | 102 | \fB\-o \fIoption\fR[\fB=\fIvalue\fR] |
ef416fc2 | 103 | Sets a job option. |
104 | .TP 5 | |
cfa19b58 MS |
105 | .B \-p |
106 | Specifies that the print file should be formatted with a shaded header with the date, time, job name, and page number. | |
107 | This option is equivalent to \fI\-o prettyprint\fR and is only useful when printing text files. | |
bd7854cb | 108 | .TP 5 |
cfa19b58 | 109 | .B \-q |
bd7854cb | 110 | Hold job for printing. |
ef416fc2 | 111 | .TP 5 |
cfa19b58 MS |
112 | .B \-r |
113 | Specifies that the named print files should be deleted after submitting them. | |
114 | .SH NOTES | |
115 | The \fI\-c\fR, \fI\-d\fR, \fI\-f\fR, \fI\-g\fR, \fI\-i\fR, \fI\-n\fR, \fI\-t\fR, \fI\-v\fR, and \fI\-w\fR options are not supported by CUPS and produce a warning message if used. | |
116 | .SH EXAMPLES | |
117 | Print two copies of a document to the default printer: | |
118 | .nf | |
119 | ||
120 | lpr -# 2 filename | |
121 | ||
122 | .fi | |
123 | Print a double-sided legal document to a printer called "foo": | |
124 | .nf | |
125 | ||
126 | lpr -P foo -o media=legal -o sides=two-sided-long-edge filename | |
127 | ||
128 | .fi | |
129 | Print a presentation document 2-up to a printer called "foo": | |
130 | .nf | |
131 | ||
132 | lpr -P foo -o number-up=2 filename | |
133 | .fi | |
ef416fc2 | 134 | .SH SEE ALSO |
cfa19b58 MS |
135 | .BR cancel (1), |
136 | .BR lp (1), | |
137 | .BR lpadmin (8), | |
138 | .BR lpoptions (1), | |
139 | .BR lpq (1), | |
140 | .BR lprm (1), | |
141 | .BR lpstat (1), | |
142 | CUPS Online Help (http://localhost:631/help) | |
ef416fc2 | 143 | .SH COPYRIGHT |
fbfee7a8 | 144 | Copyright \[co] 2007-2015 by Apple Inc. |