|
Packit |
2fc92b |
.\"
|
|
Packit |
2fc92b |
.\" lpr man page for CUPS.
|
|
Packit |
2fc92b |
.\"
|
|
Packit |
2fc92b |
.\" Copyright 2007-2016 by Apple Inc.
|
|
Packit |
2fc92b |
.\" Copyright 1997-2006 by Easy Software Products.
|
|
Packit |
2fc92b |
.\"
|
|
Packit |
2fc92b |
.\" These coded instructions, statements, and computer programs are the
|
|
Packit |
2fc92b |
.\" property of Apple Inc. and are protected by Federal copyright
|
|
Packit |
2fc92b |
.\" law. Distribution and use rights are outlined in the file "LICENSE.txt"
|
|
Packit |
2fc92b |
.\" which should have been included with this file. If this file is
|
|
Packit |
2fc92b |
.\" file is missing or damaged, see the license at "http://www.cups.org/".
|
|
Packit |
2fc92b |
.\"
|
|
Packit |
2fc92b |
.TH lpr 1 "CUPS" "2 May 2016" "Apple Inc."
|
|
Packit |
2fc92b |
.SH NAME
|
|
Packit |
2fc92b |
lpr \- print files
|
|
Packit |
2fc92b |
.SH SYNOPSIS
|
|
Packit |
2fc92b |
.B lpr
|
|
Packit |
2fc92b |
[
|
|
Packit |
2fc92b |
.B \-E
|
|
Packit |
2fc92b |
] [
|
|
Packit |
2fc92b |
\fB\-H \fIserver\fR[\fB:\fIport\fR]
|
|
Packit |
2fc92b |
] [
|
|
Packit |
2fc92b |
.B \-U
|
|
Packit |
2fc92b |
.I username
|
|
Packit |
2fc92b |
] [
|
|
Packit |
2fc92b |
\fB\-P \fIdestination\fR[\fB/\fIinstance\fR]
|
|
Packit |
2fc92b |
] [
|
|
Packit |
2fc92b |
.B \-#
|
|
Packit |
2fc92b |
.I num-copies
|
|
Packit |
2fc92b |
[
|
|
Packit |
2fc92b |
.B \-h
|
|
Packit |
2fc92b |
] [
|
|
Packit |
2fc92b |
.B \-l
|
|
Packit |
2fc92b |
] [
|
|
Packit |
2fc92b |
.B \-m
|
|
Packit |
2fc92b |
] [
|
|
Packit |
2fc92b |
\fB\-o \fIoption\fR[\fB=\fIvalue\fR]
|
|
Packit |
2fc92b |
] [
|
|
Packit |
2fc92b |
.B \-p
|
|
Packit |
2fc92b |
] [
|
|
Packit |
2fc92b |
.B \-q
|
|
Packit |
2fc92b |
] [
|
|
Packit |
2fc92b |
.B \-r
|
|
Packit |
2fc92b |
] [
|
|
Packit |
2fc92b |
.B \-C
|
|
Packit |
2fc92b |
.I title
|
|
Packit |
2fc92b |
] [
|
|
Packit |
2fc92b |
.B \-J
|
|
Packit |
2fc92b |
.I title
|
|
Packit |
2fc92b |
] [
|
|
Packit |
2fc92b |
.B \-T
|
|
Packit |
2fc92b |
.I title
|
|
Packit |
2fc92b |
] [
|
|
Packit |
2fc92b |
.I file(s)
|
|
Packit |
2fc92b |
]
|
|
Packit |
2fc92b |
.SH DESCRIPTION
|
|
Packit |
2fc92b |
\fBlpr\fR submits files for printing.
|
|
Packit |
2fc92b |
Files named on the command line are sent to the named printer or the default destination if no destination is specified.
|
|
Packit |
2fc92b |
If no files are listed on the command-line, \fBlpr\fR reads the print file from the standard input.
|
|
Packit |
2fc92b |
.SS THE DEFAULT DESTINATION
|
|
Packit |
2fc92b |
CUPS provides many ways to set the default destination. The \fBLPDEST\fR and \fBPRINTER\fR environment variables are consulted first.
|
|
Packit |
2fc92b |
If neither are set, the current default set using the
|
|
Packit |
2fc92b |
.BR lpoptions (1)
|
|
Packit |
2fc92b |
command is used, followed by the default set using the
|
|
Packit |
2fc92b |
.BR lpadmin (8)
|
|
Packit |
2fc92b |
command.
|
|
Packit |
2fc92b |
.SH OPTIONS
|
|
Packit |
2fc92b |
The following options are recognized by \fIlpr\fR:
|
|
Packit |
2fc92b |
.TP 5
|
|
Packit |
2fc92b |
.B \-E
|
|
Packit |
2fc92b |
Forces encryption when connecting to the server.
|
|
Packit |
2fc92b |
.TP 5
|
|
Packit |
2fc92b |
\fB\-H \fIserver\fR[\fB:\fIport\fR]
|
|
Packit |
2fc92b |
Specifies an alternate server.
|
|
Packit |
2fc92b |
.TP 5
|
|
Packit |
2fc92b |
\fB\-C "\fIname\fB"\fR
|
|
Packit |
2fc92b |
.TP 5
|
|
Packit |
2fc92b |
\fB\-J "\fIname\fB"\fR
|
|
Packit |
2fc92b |
.TP 5
|
|
Packit |
2fc92b |
\fB\-T "\fIname\fB"\fR
|
|
Packit |
2fc92b |
Sets the job name/title.
|
|
Packit |
2fc92b |
.TP 5
|
|
Packit |
2fc92b |
\fB\-P \fIdestination\fR[\fB/\fIinstance\fR]
|
|
Packit |
2fc92b |
Prints files to the named printer.
|
|
Packit |
2fc92b |
.TP 5
|
|
Packit |
2fc92b |
\fB\-U \fIusername\fR
|
|
Packit |
2fc92b |
Specifies an alternate username.
|
|
Packit |
2fc92b |
.TP 5
|
|
Packit |
2fc92b |
\fB\-# \fIcopies\fR
|
|
Packit |
2fc92b |
Sets the number of copies to print.
|
|
Packit |
2fc92b |
.TP 5
|
|
Packit |
2fc92b |
.B \-h
|
|
Packit |
2fc92b |
Disables banner printing. This option is equivalent to \fI-o job\-sheets=none\fR.
|
|
Packit |
2fc92b |
.TP 5
|
|
Packit |
2fc92b |
.B \-l
|
|
Packit |
2fc92b |
Specifies that the print file is already formatted for the destination and should be sent without filtering.
|
|
Packit |
2fc92b |
This option is equivalent to \fI-o raw\fR.
|
|
Packit |
2fc92b |
.TP 5
|
|
Packit |
2fc92b |
.B \-m
|
|
Packit |
2fc92b |
Send an email on job completion.
|
|
Packit |
2fc92b |
.TP 5
|
|
Packit |
2fc92b |
\fB\-o \fIoption\fR[\fB=\fIvalue\fR]
|
|
Packit |
2fc92b |
Sets a job option.
|
|
Packit |
2fc92b |
See "COMMON JOB OPTIONS" below.
|
|
Packit |
2fc92b |
.TP 5
|
|
Packit |
2fc92b |
.B \-p
|
|
Packit |
2fc92b |
Specifies that the print file should be formatted with a shaded header with the date, time, job name, and page number.
|
|
Packit |
2fc92b |
This option is equivalent to \fI\-o prettyprint\fR and is only useful when printing text files.
|
|
Packit |
2fc92b |
.TP 5
|
|
Packit |
2fc92b |
.B \-q
|
|
Packit |
2fc92b |
Hold job for printing.
|
|
Packit |
2fc92b |
.TP 5
|
|
Packit |
2fc92b |
.B \-r
|
|
Packit |
2fc92b |
Specifies that the named print files should be deleted after submitting them.
|
|
Packit |
2fc92b |
.SS COMMON JOB OPTIONS
|
|
Packit |
2fc92b |
Aside from the printer-specific options reported by the
|
|
Packit |
2fc92b |
.BR lpoptions (1)
|
|
Packit |
2fc92b |
command, the following generic options are available:
|
|
Packit |
2fc92b |
.TP 5
|
|
Packit |
2fc92b |
\fB\-o collate=true\fR
|
|
Packit |
2fc92b |
Prints collated copies.
|
|
Packit |
2fc92b |
.TP 5
|
|
Packit |
2fc92b |
\fB\-o fit\-to\-page\fR
|
|
Packit |
2fc92b |
Scales the print file to fit on the page.
|
|
Packit |
2fc92b |
.TP 5
|
|
Packit |
2fc92b |
\fB\-o job-hold-until=\fIwhen\fR
|
|
Packit |
2fc92b |
Holds the job until the specified local time.
|
|
Packit |
2fc92b |
"when" can be "indefinite" to hold the until released, "day-time" to print the job between 6am and 6pm local time, "night" to print the job between 6pm and 6am local time, "second-shift" to print the job between 4pm and 12am local time, "third-shift" to print the job between 12am and 8am local time, or "weekend" to print the job on Saturday or Sunday.
|
|
Packit |
2fc92b |
.TP 5
|
|
Packit |
2fc92b |
\fB\-o job-hold-until=\fIhh:mm\fR
|
|
Packit |
2fc92b |
Holds the job until the specified time in hours and minutes UTC.
|
|
Packit |
2fc92b |
.TP 5
|
|
Packit |
2fc92b |
\fB\-o job-priority=\fIpriority\fR
|
|
Packit |
2fc92b |
Set the priority to a value from 1 (lowest) to 100 (highest), which influences when a job is scheduled for printing.
|
|
Packit |
2fc92b |
The default priority is typically 50.
|
|
Packit |
2fc92b |
.TP 5
|
|
Packit |
2fc92b |
\fB\-o job-sheets=\fIname\fR\fR
|
|
Packit |
2fc92b |
Prints a cover page (banner) with the document.
|
|
Packit |
2fc92b |
The "name" can be "classified", "confidential", "secret", "standard", "topsecret", or "unclassified".
|
|
Packit |
2fc92b |
.TP 5
|
|
Packit |
2fc92b |
\fB\-o job-sheets=\fIstart-name,end-name\fR\fR
|
|
Packit |
2fc92b |
Prints cover pages (banners) with the document.
|
|
Packit |
2fc92b |
.TP 5
|
|
Packit |
2fc92b |
\fB\-o media=\fIsize\fR
|
|
Packit |
2fc92b |
Sets the page size to \fIsize\fR. Most printers support at least the size names "a4", "letter", and "legal".
|
|
Packit |
2fc92b |
.TP 5
|
|
Packit |
2fc92b |
\fB\-o mirror\fR
|
|
Packit |
2fc92b |
Mirrors each page.
|
|
Packit |
2fc92b |
.TP 5
|
|
Packit |
2fc92b |
\fB\-o number\-up=\fR{\fI2|4|6|9|16\fR}
|
|
Packit |
2fc92b |
Prints 2, 4, 6, 9, or 16 document (input) pages on each output page.
|
|
Packit |
2fc92b |
.TP 5
|
|
Packit |
2fc92b |
\fB\-o number\-up\-layout=\fIlayout\fR
|
|
Packit |
2fc92b |
Specifies the layout of pages with the "number-up" option.
|
|
Packit |
2fc92b |
The "layout" string can be "btlr", "btrl", "lrbt", "lrtb", "rlbt", "rltb", "tblr", or "tbrl" - the first two letters determine the column order while the second two letters determine the row order.
|
|
Packit |
2fc92b |
"bt" is bottom-to-top, "lr" is left-to-right, "rl" is right-to-left, and "tb" is top-to-bottom.
|
|
Packit |
2fc92b |
.TP 5
|
|
Packit |
2fc92b |
\fB\-o orientation\-requested=4\fR
|
|
Packit |
2fc92b |
Prints the job in landscape (rotated 90 degrees counter-clockwise).
|
|
Packit |
2fc92b |
.TP 5
|
|
Packit |
2fc92b |
\fB\-o orientation\-requested=5\fR
|
|
Packit |
2fc92b |
Prints the job in landscape (rotated 90 degrees clockwise).
|
|
Packit |
2fc92b |
.TP 5
|
|
Packit |
2fc92b |
\fB\-o orientation\-requested=6\fR
|
|
Packit |
2fc92b |
Prints the job in reverse portrait (rotated 180 degrees).
|
|
Packit |
2fc92b |
.TP 5
|
|
Packit |
2fc92b |
\fB\-o outputorder=reverse\fR
|
|
Packit |
2fc92b |
Prints pages in reverse order.
|
|
Packit |
2fc92b |
.TP 5
|
|
Packit |
2fc92b |
\fB\-o page\-border=\fIborder\fR
|
|
Packit |
2fc92b |
Prints a border around each document page.
|
|
Packit |
2fc92b |
"border" is "double", "double\-thick", "single", or "single\-thick".
|
|
Packit |
2fc92b |
.TP 5
|
|
Packit |
2fc92b |
\fB\-o page\-ranges=\fIpage-list\fR
|
|
Packit |
2fc92b |
Specifies which pages to print in the document.
|
|
Packit |
2fc92b |
The list can contain a list of numbers and ranges (#-#) separated by commas, e.g., "1,3-5,16".
|
|
Packit |
2fc92b |
The page numbers refer to the output pages and not the document's original pages - options like "number-up" can affect the numbering of the pages.
|
|
Packit |
2fc92b |
.TP 5
|
|
Packit |
2fc92b |
\fB\-o sides=one\-sided\fR
|
|
Packit |
2fc92b |
Prints on one side of the paper.
|
|
Packit |
2fc92b |
.TP 5
|
|
Packit |
2fc92b |
\fB\-o sides=two\-sided\-long\-edge\fR
|
|
Packit |
2fc92b |
Prints on both sides of the paper for portrait output.
|
|
Packit |
2fc92b |
.TP 5
|
|
Packit |
2fc92b |
\fB\-o sides=two\-sided\-short\-edge\fR
|
|
Packit |
2fc92b |
Prints on both sides of the paper for landscape output.
|
|
Packit |
2fc92b |
.SH NOTES
|
|
Packit |
2fc92b |
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.
|
|
Packit |
2fc92b |
.SH EXAMPLES
|
|
Packit |
2fc92b |
Print two copies of a document to the default printer:
|
|
Packit |
2fc92b |
.nf
|
|
Packit |
2fc92b |
|
|
Packit |
2fc92b |
lpr -# 2 filename
|
|
Packit |
2fc92b |
|
|
Packit |
2fc92b |
.fi
|
|
Packit |
2fc92b |
Print a double-sided legal document to a printer called "foo":
|
|
Packit |
2fc92b |
.nf
|
|
Packit |
2fc92b |
|
|
Packit |
2fc92b |
lpr -P foo -o media=legal -o sides=two-sided-long-edge filename
|
|
Packit |
2fc92b |
|
|
Packit |
2fc92b |
.fi
|
|
Packit |
2fc92b |
Print a presentation document 2-up to a printer called "foo":
|
|
Packit |
2fc92b |
.nf
|
|
Packit |
2fc92b |
|
|
Packit |
2fc92b |
lpr -P foo -o number-up=2 filename
|
|
Packit |
2fc92b |
.fi
|
|
Packit |
2fc92b |
.SH SEE ALSO
|
|
Packit |
2fc92b |
.BR cancel (1),
|
|
Packit |
2fc92b |
.BR lp (1),
|
|
Packit |
2fc92b |
.BR lpadmin (8),
|
|
Packit |
2fc92b |
.BR lpoptions (1),
|
|
Packit |
2fc92b |
.BR lpq (1),
|
|
Packit |
2fc92b |
.BR lprm (1),
|
|
Packit |
2fc92b |
.BR lpstat (1),
|
|
Packit |
2fc92b |
CUPS Online Help (http://localhost:631/help)
|
|
Packit |
2fc92b |
.SH COPYRIGHT
|
|
Packit |
2fc92b |
Copyright \[co] 2007-2017 by Apple Inc.
|