]> git.ipfire.org Git - thirdparty/cups.git/blob - man/lpr.man
267af1bd6aa1c48c1a7906e8bdfabef1cf39d8e9
[thirdparty/cups.git] / man / lpr.man
1 .\"
2 .\" "$Id$"
3 .\"
4 .\" lpr man page for the Common UNIX Printing System (CUPS).
5 .\"
6 .\" Copyright 1997-2006 by Easy Software Products.
7 .\"
8 .\" These coded instructions, statements, and computer programs are the
9 .\" property of Easy Software Products and are protected by Federal
10 .\" copyright law. Distribution and use rights are outlined in the file
11 .\" "LICENSE.txt" which should have been included with this file. If this
12 .\" file is missing or damaged please contact Easy Software Products
13 .\" at:
14 .\"
15 .\" Attn: CUPS Licensing Information
16 .\" Easy Software Products
17 .\" 44141 Airport View Drive, Suite 204
18 .\" Hollywood, Maryland 20636 USA
19 .\"
20 .\" Voice: (301) 373-9600
21 .\" EMail: cups-info@cups.org
22 .\" WWW: http://www.cups.org
23 .\"
24 .TH lpr 1 "Common UNIX Printing System" "12 February 2006" "Easy Software Products"
25 .SH NAME
26 lpr \- print files
27 .SH SYNOPSIS
28 .B lpr
29 [ -E ] [ -H
30 .I server[:port]
31 ] [ -U
32 .I username
33 ] [ -P
34 .I destination[/instance]
35 ] [ -#
36 .I num-copies
37 [ -h ] [ -l ] [ -m ] [ -o
38 .I option[=value]
39 ] [ -p] [ -q ] [ -r ] [ -C/J/T
40 .I title
41 ] [
42 .I file(s)
43 ]
44 .SH DESCRIPTION
45 \fIlpr\fR submits files for printing. Files named on the command
46 line are sent to the named printer (or the system default
47 destination if no destination is specified). If no files are
48 listed on the command-line, \fIlpr\fR reads the print file from
49 the standard input.
50 .SH OPTIONS
51 The following options are recognized by \fIlpr\fR:
52 .TP 5
53 -E
54 .br
55 Forces encryption when connecting to the server.
56 .TP 5
57 -H server[:port]
58 .br
59 Specifies an alternate server.
60 .TP 5
61 -C "name"
62 .TP 5
63 -J "name"
64 .TP 5
65 -T "name"
66 .br
67 Sets the job name.
68 .TP 5
69 -P destination[/instance]
70 .br
71 Prints files to the named printer.
72 .TP 5
73 -U username
74 .br
75 Specifies an alternate username.
76 .TP 5
77 -# \fIcopies\fR
78 .br
79 Sets the number of copies to print from 1 to 100.
80 .TP 5
81 -h
82 .br
83 Disables banner printing. This option is equivalent to "-o
84 job-sheets=none".
85 .TP 5
86 -l
87 .br
88 Specifies that the print file is already formatted for the
89 destination and should be sent without filtering. This option is
90 equivalent to "-o raw".
91 .TP 5
92 -m
93 .br
94 Send an email on job completion.
95 .TP 5
96 -o option[=value]
97 .br
98 Sets a job option.
99 .TP 5
100 -p
101 .br
102 Specifies that the print file should be formatted with a shaded
103 header with the date, time, job name, and page number. This
104 option is equivalent to "-o prettyprint" and is only useful when
105 printing text files.
106 .TP 5
107 -q
108 .br
109 Hold job for printing.
110 .TP 5
111 -r
112 .br
113 Specifies that the named print files should be deleted after
114 printing them.
115 .SH COMPATIBILITY
116 The "c", "d", "f", "g", "i", "n", "t", "v", and "w" options
117 are not supported by CUPS and produce a warning message if used.
118 .SH SEE ALSO
119 \fIcancel(1)\fR, \fIlp(1)\fR, \fIlpq(1)\fR, \fIlprm(1)\fR,
120 \fIlpstat(1)\fR,
121 .br
122 http://localhost:631/help
123 .SH COPYRIGHT
124 Copyright 1997-2006 by Easy Software Products, All Rights Reserved.
125 .\"
126 .\" End of "$Id$".
127 .\"