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