]>
Commit | Line | Data |
---|---|---|
ef416fc2 | 1 | .\" |
b19ccc9e | 2 | .\" "$Id: lpr.man 7889 2008-08-29 22:03:35Z mike $" |
ef416fc2 | 3 | .\" |
4 | .\" lpr man page for the Common UNIX Printing System (CUPS). | |
5 | .\" | |
c168a833 | 6 | .\" Copyright 2007-2009 by Apple Inc. |
fa73b229 | 7 | .\" Copyright 1997-2006 by Easy Software Products. |
ef416fc2 | 8 | .\" |
9 | .\" These coded instructions, statements, and computer programs are the | |
bc44d920 | 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 | .\" |
9aff70cc | 15 | .TH lpr 1 "CUPS" "29 August 2008" "Apple Inc." |
ef416fc2 | 16 | .SH NAME |
17 | lpr \- print files | |
18 | .SH SYNOPSIS | |
19 | .B lpr | |
fa73b229 | 20 | [ -E ] [ -H |
bd7854cb | 21 | .I server[:port] |
22 | ] [ -U | |
ef416fc2 | 23 | .I username |
bd7854cb | 24 | ] [ -P |
25 | .I destination[/instance] | |
26 | ] [ -# | |
ef416fc2 | 27 | .I num-copies |
bd7854cb | 28 | [ -h ] [ -l ] [ -m ] [ -o |
29 | .I option[=value] | |
30 | ] [ -p] [ -q ] [ -r ] [ -C/J/T | |
ef416fc2 | 31 | .I title |
32 | ] [ | |
33 | .I file(s) | |
34 | ] | |
35 | .SH DESCRIPTION | |
bd7854cb | 36 | \fIlpr\fR submits files for printing. Files named on the command |
c5571a1d MS |
37 | line are sent to the named printer (or the default destination if no |
38 | destination is specified). If no files are listed on the command-line, | |
39 | \fIlpr\fR reads the print file from the standard input. | |
40 | .SH THE DEFAULT DESTINATION | |
41 | CUPS provides many ways to set the default destination. The "LPDEST" and | |
42 | "PRINTER" environment variables are consulted first. If neither are set, | |
43 | the current default set using the \fIlpoptions(1)\fR command is used, | |
44 | followed by the default set using the \fIlpadmin(8)\fR command. | |
ef416fc2 | 45 | .SH OPTIONS |
bd7854cb | 46 | The following options are recognized by \fIlpr\fR: |
ef416fc2 | 47 | .TP 5 |
bd7854cb | 48 | -E |
ef416fc2 | 49 | .br |
50 | Forces encryption when connecting to the server. | |
51 | .TP 5 | |
bd7854cb | 52 | -H server[:port] |
ef416fc2 | 53 | .br |
bd7854cb | 54 | Specifies an alternate server. |
ef416fc2 | 55 | .TP 5 |
bd7854cb | 56 | -C "name" |
57 | .TP 5 | |
58 | -J "name" | |
ef416fc2 | 59 | .TP 5 |
bd7854cb | 60 | -T "name" |
ef416fc2 | 61 | .br |
62 | Sets the job name. | |
63 | .TP 5 | |
bd7854cb | 64 | -P destination[/instance] |
ef416fc2 | 65 | .br |
bd7854cb | 66 | Prints files to the named printer. |
ef416fc2 | 67 | .TP 5 |
bd7854cb | 68 | -U username |
ef416fc2 | 69 | .br |
bd7854cb | 70 | Specifies an alternate username. |
ef416fc2 | 71 | .TP 5 |
bd7854cb | 72 | -# \fIcopies\fR |
ef416fc2 | 73 | .br |
bd7854cb | 74 | Sets the number of copies to print from 1 to 100. |
75 | .TP 5 | |
76 | -h | |
77 | .br | |
78 | Disables banner printing. This option is equivalent to "-o | |
79 | job-sheets=none". | |
ef416fc2 | 80 | .TP 5 |
bd7854cb | 81 | -l |
ef416fc2 | 82 | .br |
bd7854cb | 83 | Specifies that the print file is already formatted for the |
84 | destination and should be sent without filtering. This option is | |
85 | equivalent to "-o raw". | |
ef416fc2 | 86 | .TP 5 |
bd7854cb | 87 | -m |
88 | .br | |
89 | Send an email on job completion. | |
90 | .TP 5 | |
91 | -o option[=value] | |
ef416fc2 | 92 | .br |
93 | Sets a job option. | |
94 | .TP 5 | |
bd7854cb | 95 | -p |
96 | .br | |
97 | Specifies that the print file should be formatted with a shaded | |
98 | header with the date, time, job name, and page number. This | |
99 | option is equivalent to "-o prettyprint" and is only useful when | |
100 | printing text files. | |
101 | .TP 5 | |
102 | -q | |
ef416fc2 | 103 | .br |
bd7854cb | 104 | Hold job for printing. |
ef416fc2 | 105 | .TP 5 |
bd7854cb | 106 | -r |
ef416fc2 | 107 | .br |
bd7854cb | 108 | Specifies that the named print files should be deleted after |
109 | printing them. | |
ef416fc2 | 110 | .SH COMPATIBILITY |
bd7854cb | 111 | The "c", "d", "f", "g", "i", "n", "t", "v", and "w" options |
112 | are not supported by CUPS and produce a warning message if used. | |
ef416fc2 | 113 | .SH SEE ALSO |
c5571a1d MS |
114 | \fIcancel(1)\fR, \fIlp(1)\fR, \fIlpadmin(8)\fR, \fIlpoptions(1)\fR, |
115 | \fIlpq(1)\fR, \fIlprm(1)\fR, \fIlpstat(1)\fR, | |
fa73b229 | 116 | .br |
117 | http://localhost:631/help | |
ef416fc2 | 118 | .SH COPYRIGHT |
c168a833 | 119 | Copyright 2007-2009 by Apple Inc. |
ef416fc2 | 120 | .\" |
b19ccc9e | 121 | .\" End of "$Id: lpr.man 7889 2008-08-29 22:03:35Z mike $". |
ef416fc2 | 122 | .\" |