diff options
Diffstat (limited to 'upstream/archlinux/man1/lpr.1')
| -rw-r--r-- | upstream/archlinux/man1/lpr.1 | 183 |
1 files changed, 183 insertions, 0 deletions
diff --git a/upstream/archlinux/man1/lpr.1 b/upstream/archlinux/man1/lpr.1 new file mode 100644 index 00000000..2ad6907d --- /dev/null +++ b/upstream/archlinux/man1/lpr.1 @@ -0,0 +1,183 @@ +.\" +.\" lpr man page for CUPS. +.\" +.\" Copyright © 2021-2023 by OpenPrinting. +.\" Copyright © 2007-2019 by Apple Inc. +.\" Copyright © 1997-2006 by Easy Software Products. +.\" +.\" Licensed under Apache License v2.0. See the file "LICENSE" for more +.\" information. +.\" +.TH lpr 1 "CUPS" "2022-05-02" "OpenPrinting" +.SH NAME +lpr \- print files +.SH SYNOPSIS +.B lpr +[ +\fB\-H \fIserver\fR[\fB:\fIport\fR] +] [ +.B \-E +] [ +.B \-U +.I username +] [ +\fB\-P \fIdestination\fR[\fB/\fIinstance\fR] +] [ +.B \-# +.I num-copies +[ +.B \-h +] [ +.B \-l +] [ +.B \-m +] [ +\fB\-o \fIoption\fR[\fB=\fIvalue\fR] +] [ +.B \-p +] [ +.B \-q +] [ +.B \-r +] [ +.B \-C +.I title +] [ +.B \-J +.I title +] [ +.B \-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 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. +.SS THE DEFAULT DESTINATION +CUPS provides many ways to set the default destination. The \fBLPDEST\fR and \fBPRINTER\fR environment variables are consulted first. +If neither are set, the current default set using the +.BR lpoptions (1) +command is used, followed by the default set using the +.BR lpadmin (8) +command. +.SH OPTIONS +The following options are recognized by \fIlpr\fR: +.TP 5 +.B \-E +Forces encryption when connecting to the server. +.TP 5 +\fB\-H \fIserver\fR[\fB:\fIport\fR] +Specifies an alternate server. +Note: This option must occur before all others. +.TP 5 +\fB\-C "\fIname\fB"\fR +.TP 5 +\fB\-J "\fIname\fB"\fR +.TP 5 +\fB\-T "\fIname\fB"\fR +Sets the job name/title. +.TP 5 +\fB\-P \fIdestination\fR[\fB/\fIinstance\fR] +Prints files to the named printer. +.TP 5 +\fB\-U \fIusername\fR +Specifies an alternate username. +.TP 5 +\fB\-# \fIcopies\fR +Sets the number of copies to print. +.TP 5 +.B \-h +Disables banner printing. This option is equivalent to \fI-o job\-sheets=none\fR. +.TP 5 +.B \-l +Specifies that the print file is already formatted for the destination and should be sent without filtering. +This option is equivalent to \fI-o raw\fR. +.TP 5 +.B \-m +Send an email on job completion. +.TP 5 +\fB\-o \fIoption\fR[\fB=\fIvalue\fR] +Sets a job option. +See "COMMON JOB OPTIONS" below. +.TP 5 +.B \-p +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 \fI\-o prettyprint\fR and is only useful when printing text files. +.TP 5 +.B \-q +Hold job for printing. +.TP 5 +.B \-r +Specifies that the named print files should be deleted after submitting them. +.SS COMMON JOB OPTIONS +Aside from the printer-specific options reported by the +.BR lpoptions (1) +command, the following generic options are available: +.TP 5 +\fB\-o job-sheets=\fIname\fR\fR +Prints a cover page (banner) with the document. +The "name" can be "classified", "confidential", "secret", "standard", "topsecret", or "unclassified". +.TP 5 +\fB\-o media=\fIsize\fR +Sets the page size to \fIsize\fR. Most printers support at least the size names "a4", "letter", and "legal". +.TP 5 +\fB\-o number\-up=\fR{\fI2|4|6|9|16\fR} +Prints 2, 4, 6, 9, or 16 document (input) pages on each output page. +.TP 5 +\fB\-o orientation\-requested=4\fR +Prints the job in landscape (rotated 90 degrees counter-clockwise). +.TP 5 +\fB\-o orientation\-requested=5\fR +Prints the job in landscape (rotated 90 degrees clockwise). +.TP 5 +\fB\-o orientation\-requested=6\fR +Prints the job in reverse portrait (rotated 180 degrees). +.TP 5 +\fB\-o print\-quality=3\fR +.TP 5 +\fB\-o print\-quality=4\fR +.TP 5 +\fB\-o print\-quality=5\fR +Specifies the output quality - draft (3), normal (4), or best (5). +.TP 5 +\fB\-o sides=one\-sided\fR +Prints on one side of the paper. +.TP 5 +\fB\-o sides=two\-sided\-long\-edge\fR +Prints on both sides of the paper for portrait output. +.TP 5 +\fB\-o sides=two\-sided\-short\-edge\fR +Prints on both sides of the paper for landscape output. +.SH NOTES +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. +.SH EXAMPLES +Print two copies of a document to the default printer: +.nf + + lpr -# 2 filename + +.fi +Print a double-sided legal document to a printer called "foo": +.nf + + lpr -P foo -o media=legal -o sides=two-sided-long-edge filename + +.fi +Print a presentation document 2-up to a printer called "foo": +.nf + + lpr -P foo -o number-up=2 filename +.fi +.SH SEE ALSO +.BR cancel (1), +.BR lp (1), +.BR lpadmin (8), +.BR lpoptions (1), +.BR lpq (1), +.BR lprm (1), +.BR lpstat (1), +CUPS Online Help (http://localhost:631/help) +.SH COPYRIGHT +Copyright \[co] 2021-2023 by OpenPrinting. |