[thirdparty/cups.git] / man / lpr.man

.\"
.\" "$Id: lpr.man 4493 2005-02-18 02:09:53Z mike $"
.\"
.\"   lpr man page for the Common UNIX Printing System (CUPS).
.\"
.\"   Copyright 1997-2005 by Easy Software Products.
.\"
.\"   These coded instructions, statements, and computer programs are the
.\"   property of Easy Software Products and are protected by Federal
.\"   copyright law.  Distribution and use rights are outlined in the file
.\"   "LICENSE.txt" which should have been included with this file.  If this
.\"   file is missing or damaged please contact Easy Software Products
.\"   at:
.\"
.\"       Attn: CUPS Licensing Information
.\"       Easy Software Products
.\"       44141 Airport View Drive, Suite 204
.\"       Hollywood, Maryland 20636 USA
.\"
.\"       Voice: (301) 373-9600
.\"       EMail: cups-info@cups.org
.\"         WWW: http://www.cups.org
.\"
.TH lpr 1 "Common UNIX Printing System" "16 December 2004" "Easy Software Products"
.SH NAME
lpr \- print files
.SH SYNOPSIS
.B lpr
[ -E ] [ \-P
.I destination
] [ \-U
.I username
] [ \-#
.I num-copies
[ \-l ] [ \-o
.I option
] [ \-p] [ \-r ] [ \-C/J/T
.I title
] [
.I file(s)
]
.SH DESCRIPTION
\fBlpr\fR submits files for printing. Files named on the command line are sent
to the named printer (or the system default destination if no destination is
specified). If no files are listed on the command-line \fBlpr\fR reads the
print file from the standard input.
.SH OPTIONS
The following options are recognized by \fBlpr\fR:
.TP 5
\-E
.br
Forces encryption when connecting to the server.
.TP 5
\-P \fIdestination\fR
.br
Prints files to the named printer.
.TP 5
\-# \fIcopies\fR
.br
Sets the number of copies to print from 1 to 100.
.TP 5
\-C \fIname\fR
.br
Sets the job name.
.TP 5
\-J \fIname\fR
.br
Sets the job name.
.TP 5
\-T \fIname\fR
.br
Sets the job name.
.TP 5
\-U \fIusername\fR
.br
Sets the user name.
.TP 5
\-l
.br
Specifies that the print file is already formatted for the destination and
should be sent without filtering. This option is equivalent to "-oraw".
.TP 5
\-o \fIoption\fR
.br
Sets a job option.
.TP 5
\-p
.br
Specifies that the print file should be formatted with a shaded header with
the date, time, job name, and page number. This option is equivalent to
"-oprettyprint" and is only useful when printing text files.
.TP 5
\-r
.br
Specifies that the named print files should be deleted after printing them.
.SH COMPATIBILITY
The "c", "d", "f", "g", "i", "m", "n", "t", "v", and "w" options are not
supported by CUPS and will produce a warning message if used.
.SH SEE ALSO
cancel(1), lp(1), lpstat(1),
CUPS Software Users Manual,
http://localhost:631/documentation.html
.SH COPYRIGHT
Copyright 1993-2005 by Easy Software Products, All Rights Reserved.
.\"
.\" End of "$Id: lpr.man 4493 2005-02-18 02:09:53Z mike $".
.\"
Commit	Line	Data
ef416fc2	1	.\"
	2	.\" "$Id: lpr.man 4493 2005-02-18 02:09:53Z mike $"
	3	.\"
	4	.\" lpr man page for the Common UNIX Printing System (CUPS).
	5	.\"
	6	.\" Copyright 1997-2005 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" "16 December 2004" "Easy Software Products"
	25	.SH NAME
	26	lpr \- print files
	27	.SH SYNOPSIS
	28	.B lpr
	29	[ -E ] [ \-P
	30	.I destination
	31	] [ \-U
	32	.I username
	33	] [ \-#
	34	.I num-copies
	35	[ \-l ] [ \-o
	36	.I option
	37	] [ \-p] [ \-r ] [ \-C/J/T
	38	.I title
	39	] [
	40	.I file(s)
	41	]
	42	.SH DESCRIPTION
	43	\fBlpr\fR submits files for printing. Files named on the command line are sent
	44	to the named printer (or the system default destination if no destination is
	45	specified). If no files are listed on the command-line \fBlpr\fR reads the
	46	print file from the standard input.
	47	.SH OPTIONS
	48	The following options are recognized by \fBlpr\fR:
	49	.TP 5
	50	\-E
	51	.br
	52	Forces encryption when connecting to the server.
	53	.TP 5
	54	\-P \fIdestination\fR
	55	.br
	56	Prints files to the named printer.
	57	.TP 5
	58	\-# \fIcopies\fR
	59	.br
	60	Sets the number of copies to print from 1 to 100.
	61	.TP 5
	62	\-C \fIname\fR
	63	.br
	64	Sets the job name.
65	.TP 5
66	\-J \fIname\fR
67	.br
68	Sets the job name.
69	.TP 5
70	\-T \fIname\fR
71	.br
72	Sets the job name.
73	.TP 5
74	\-U \fIusername\fR
75	.br
76	Sets the user name.
77	.TP 5
78	\-l
79	.br
80	Specifies that the print file is already formatted for the destination and
81	should be sent without filtering. This option is equivalent to "-oraw".
82	.TP 5
83	\-o \fIoption\fR
84	.br
85	Sets a job option.
86	.TP 5
87	\-p
88	.br
89	Specifies that the print file should be formatted with a shaded header with
90	the date, time, job name, and page number. This option is equivalent to
91	"-oprettyprint" and is only useful when printing text files.
92	.TP 5
93	\-r
94	.br
95	Specifies that the named print files should be deleted after printing them.
96	.SH COMPATIBILITY
97	The "c", "d", "f", "g", "i", "m", "n", "t", "v", and "w" options are not
98	supported by CUPS and will produce a warning message if used.
99	.SH SEE ALSO
100	cancel(1), lp(1), lpstat(1),
101	CUPS Software Users Manual,
102	http://localhost:631/documentation.html
103	.SH COPYRIGHT
104	Copyright 1993-2005 by Easy Software Products, All Rights Reserved.
105	.\"
106	.\" End of "$Id: lpr.man 4493 2005-02-18 02:09:53Z mike $".
107	.\"