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

.\"
.\" "$Id: lpr.man,v 1.5 2002/01/02 17:59:07 mike Exp $"
.\"
.\"   lpr man page for the Common UNIX Printing System (CUPS).
.\"
.\"   Copyright 1997-2002 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-3111 USA
.\"
.\"       Voice: (301) 373-9603
.\"       EMail: cups-info@cups.org
.\"         WWW: http://www.cups.org
.\"
.TH lpr 1 "Common UNIX Printing System" "23 January 2001" "Easy Software Products"
.SH NAME
lpr \- print files
.SH SYNOPSIS
.B lpr
[ -E ] [ \-P
.I destination
] [ \-#
.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
\-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-2002 by Easy Software Products, All Rights Reserved.
.\"
.\" End of "$Id: lpr.man,v 1.5 2002/01/02 17:59:07 mike Exp $".
.\"
Commit	Line	Data
771e5703	1	.\"
efb2f309	2	.\" "$Id: lpr.man,v 1.5 2002/01/02 17:59:07 mike Exp $"
771e5703	3	.\"
	4	.\" lpr man page for the Common UNIX Printing System (CUPS).
	5	.\"
efb2f309	6	.\" Copyright 1997-2002 by Easy Software Products.
771e5703	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-3111 USA
	19	.\"
	20	.\" Voice: (301) 373-9603
	21	.\" EMail: cups-info@cups.org
	22	.\" WWW: http://www.cups.org
	23	.\"
1c9e0181	24	.TH lpr 1 "Common UNIX Printing System" "23 January 2001" "Easy Software Products"
771e5703	25	.SH NAME
	26	lpr \- print files
	27	.SH SYNOPSIS
	28	.B lpr
1c9e0181	29	[ -E ] [ \-P
771e5703	30	.I destination
	31	] [ \-#
	32	.I num-copies
	33	[ \-l ] [ \-o
	34	.I option
	35	] [ \-p] [ \-r ] [ \-C/J/T
	36	.I title
	37	] [
	38	.I file(s)
	39	]
	40	.SH DESCRIPTION
	41	\fBlpr\fR submits files for printing. Files named on the command line are sent
	42	to the named printer (or the system default destination if no destination is
	43	specified). If no files are listed on the command-line \fBlpr\fR reads the
	44	print file from the standard input.
	45	.SH OPTIONS
	46	The following options are recognized by \fBlpr\fR:
	47	.TP 5
1c9e0181	48	\-E
	49	.br
	50	Forces encryption when connecting to the server.
	51	.TP 5
771e5703	52	\-P \fIdestination\fR
	53	.br
	54	Prints files to the named printer.
	55	.TP 5
	56	\-# \fIcopies\fR
	57	.br
	58	Sets the number of copies to print from 1 to 100.
	59	.TP 5
	60	\-C \fIname\fR
	61	.br
	62	Sets the job name.
	63	.TP 5
	64	\-J \fIname\fR
	65	.br
	66	Sets the job name.
	67	.TP 5
	68	\-T \fIname\fR
	69	.br
	70	Sets the job name.
	71	.TP 5
	72	\-l
	73	.br
	74	Specifies that the print file is already formatted for the destination and
	75	should be sent without filtering. This option is equivalent to "-oraw".
	76	.TP 5
	77	\-o \fIoption\fR
	78	.br
	79	Sets a job option.
	80	.TP 5
	81	\-p
	82	.br
	83	Specifies that the print file should be formatted with a shaded header with
	84	the date, time, job name, and page number. This option is equivalent to
	85	"-oprettyprint" and is only useful when printing text files.
	86	.TP 5
	87	\-r
	88	.br
	89	Specifies that the named print files should be deleted after printing them.
	90	.SH COMPATIBILITY
	91	The "c", "d", "f", "g", "i", "m", "n", "t", "v", and "w" options are not
	92	supported by CUPS and will produce a warning message if used.
	93	.SH SEE ALSO
	94	cancel(1), lp(1), lpstat(1),
85e7af89	95	CUPS Software Users Manual,
85e7af89	96	http://localhost:631/documentation.html
771e5703	97	.SH COPYRIGHT
efb2f309	98	Copyright 1993-2002 by Easy Software Products, All Rights Reserved.
771e5703	99	.\"
efb2f309	100	.\" End of "$Id: lpr.man,v 1.5 2002/01/02 17:59:07 mike Exp $".
771e5703	101	.\"