1*5e7646d2SAndroid Build Coastguard Worker<!DOCTYPE HTML> 2*5e7646d2SAndroid Build Coastguard Worker<html> 3*5e7646d2SAndroid Build Coastguard Worker<!-- SECTION: Man Pages --> 4*5e7646d2SAndroid Build Coastguard Worker<head> 5*5e7646d2SAndroid Build Coastguard Worker <link rel="stylesheet" type="text/css" href="../cups-printable.css"> 6*5e7646d2SAndroid Build Coastguard Worker <title>lpr(1)</title> 7*5e7646d2SAndroid Build Coastguard Worker</head> 8*5e7646d2SAndroid Build Coastguard Worker<body> 9*5e7646d2SAndroid Build Coastguard Worker<h1 class="title">lpr(1)</h1> 10*5e7646d2SAndroid Build Coastguard Worker<h2 class="title"><a name="NAME">Name</a></h2> 11*5e7646d2SAndroid Build Coastguard Workerlpr - print files 12*5e7646d2SAndroid Build Coastguard Worker<h2 class="title"><a name="SYNOPSIS">Synopsis</a></h2> 13*5e7646d2SAndroid Build Coastguard Worker<b>lpr</b> 14*5e7646d2SAndroid Build Coastguard Worker[ 15*5e7646d2SAndroid Build Coastguard Worker<b>-E</b> 16*5e7646d2SAndroid Build Coastguard Worker] [ 17*5e7646d2SAndroid Build Coastguard Worker<b>-H </b><i>server</i>[<b>:</b><i>port</i>] 18*5e7646d2SAndroid Build Coastguard Worker] [ 19*5e7646d2SAndroid Build Coastguard Worker<b>-U</b> 20*5e7646d2SAndroid Build Coastguard Worker<i>username</i> 21*5e7646d2SAndroid Build Coastguard Worker] [ 22*5e7646d2SAndroid Build Coastguard Worker<b>-P </b><i>destination</i>[<b>/</b><i>instance</i>] 23*5e7646d2SAndroid Build Coastguard Worker] [ 24*5e7646d2SAndroid Build Coastguard Worker<b>-#</b> 25*5e7646d2SAndroid Build Coastguard Worker<i>num-copies</i> 26*5e7646d2SAndroid Build Coastguard Worker[ 27*5e7646d2SAndroid Build Coastguard Worker<b>-h</b> 28*5e7646d2SAndroid Build Coastguard Worker] [ 29*5e7646d2SAndroid Build Coastguard Worker<b>-l</b> 30*5e7646d2SAndroid Build Coastguard Worker] [ 31*5e7646d2SAndroid Build Coastguard Worker<b>-m</b> 32*5e7646d2SAndroid Build Coastguard Worker] [ 33*5e7646d2SAndroid Build Coastguard Worker<b>-o </b><i>option</i>[<b>=</b><i>value</i>] 34*5e7646d2SAndroid Build Coastguard Worker] [ 35*5e7646d2SAndroid Build Coastguard Worker<b>-p</b> 36*5e7646d2SAndroid Build Coastguard Worker] [ 37*5e7646d2SAndroid Build Coastguard Worker<b>-q</b> 38*5e7646d2SAndroid Build Coastguard Worker] [ 39*5e7646d2SAndroid Build Coastguard Worker<b>-r</b> 40*5e7646d2SAndroid Build Coastguard Worker] [ 41*5e7646d2SAndroid Build Coastguard Worker<b>-C</b> 42*5e7646d2SAndroid Build Coastguard Worker<i>title</i> 43*5e7646d2SAndroid Build Coastguard Worker] [ 44*5e7646d2SAndroid Build Coastguard Worker<b>-J</b> 45*5e7646d2SAndroid Build Coastguard Worker<i>title</i> 46*5e7646d2SAndroid Build Coastguard Worker] [ 47*5e7646d2SAndroid Build Coastguard Worker<b>-T</b> 48*5e7646d2SAndroid Build Coastguard Worker<i>title</i> 49*5e7646d2SAndroid Build Coastguard Worker] [ 50*5e7646d2SAndroid Build Coastguard Worker<i>file(s)</i> 51*5e7646d2SAndroid Build Coastguard Worker] 52*5e7646d2SAndroid Build Coastguard Worker<h2 class="title"><a name="DESCRIPTION">Description</a></h2> 53*5e7646d2SAndroid Build Coastguard Worker<b>lpr</b> submits files for printing. 54*5e7646d2SAndroid Build Coastguard WorkerFiles named on the command line are sent to the named printer or the default destination if no destination is specified. 55*5e7646d2SAndroid Build Coastguard WorkerIf no files are listed on the command-line, <b>lpr</b> reads the print file from the standard input. 56*5e7646d2SAndroid Build Coastguard Worker<h3><a name="THE_DEFAULT_DESTINATION">The Default Destination</a></h3> 57*5e7646d2SAndroid Build Coastguard WorkerCUPS provides many ways to set the default destination. The <b>LPDEST</b> and <b>PRINTER</b> environment variables are consulted first. 58*5e7646d2SAndroid Build Coastguard WorkerIf neither are set, the current default set using the 59*5e7646d2SAndroid Build Coastguard Worker<b>lpoptions</b>(1) 60*5e7646d2SAndroid Build Coastguard Workercommand is used, followed by the default set using the 61*5e7646d2SAndroid Build Coastguard Worker<b>lpadmin</b>(8) 62*5e7646d2SAndroid Build Coastguard Workercommand. 63*5e7646d2SAndroid Build Coastguard Worker<h2 class="title"><a name="OPTIONS">Options</a></h2> 64*5e7646d2SAndroid Build Coastguard WorkerThe following options are recognized by <i>lpr</i>: 65*5e7646d2SAndroid Build Coastguard Worker<dl class="man"> 66*5e7646d2SAndroid Build Coastguard Worker<dt><b>-E</b> 67*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em">Forces encryption when connecting to the server. 68*5e7646d2SAndroid Build Coastguard Worker<dt><b>-H </b><i>server</i>[<b>:</b><i>port</i>] 69*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em">Specifies an alternate server. 70*5e7646d2SAndroid Build Coastguard Worker<dt><b>-C "</b><i>name</i><b>"</b> 71*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em"><dt><b>-J "</b><i>name</i><b>"</b> 72*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em"><dt><b>-T "</b><i>name</i><b>"</b> 73*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em">Sets the job name/title. 74*5e7646d2SAndroid Build Coastguard Worker<dt><b>-P </b><i>destination</i>[<b>/</b><i>instance</i>] 75*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em">Prints files to the named printer. 76*5e7646d2SAndroid Build Coastguard Worker<dt><b>-U </b><i>username</i> 77*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em">Specifies an alternate username. 78*5e7646d2SAndroid Build Coastguard Worker<dt><b>-# </b><i>copies</i> 79*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em">Sets the number of copies to print. 80*5e7646d2SAndroid Build Coastguard Worker<dt><b>-h</b> 81*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em">Disables banner printing. This option is equivalent to <i>-o job-sheets=none</i>. 82*5e7646d2SAndroid Build Coastguard Worker<dt><b>-l</b> 83*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em">Specifies that the print file is already formatted for the destination and should be sent without filtering. 84*5e7646d2SAndroid Build Coastguard WorkerThis option is equivalent to <i>-o raw</i>. 85*5e7646d2SAndroid Build Coastguard Worker<dt><b>-m</b> 86*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em">Send an email on job completion. 87*5e7646d2SAndroid Build Coastguard Worker<dt><b>-o </b><i>option</i>[<b>=</b><i>value</i>] 88*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em">Sets a job option. 89*5e7646d2SAndroid Build Coastguard WorkerSee "COMMON JOB OPTIONS" below. 90*5e7646d2SAndroid Build Coastguard Worker<dt><b>-p</b> 91*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em">Specifies that the print file should be formatted with a shaded header with the date, time, job name, and page number. 92*5e7646d2SAndroid Build Coastguard WorkerThis option is equivalent to <i>-o prettyprint</i> and is only useful when printing text files. 93*5e7646d2SAndroid Build Coastguard Worker<dt><b>-q</b> 94*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em">Hold job for printing. 95*5e7646d2SAndroid Build Coastguard Worker<dt><b>-r</b> 96*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em">Specifies that the named print files should be deleted after submitting them. 97*5e7646d2SAndroid Build Coastguard Worker</dl> 98*5e7646d2SAndroid Build Coastguard Worker<h3><a name="COMMON_JOB_OPTIONS">Common Job Options</a></h3> 99*5e7646d2SAndroid Build Coastguard WorkerAside from the printer-specific options reported by the 100*5e7646d2SAndroid Build Coastguard Worker<b>lpoptions</b>(1) 101*5e7646d2SAndroid Build Coastguard Workercommand, the following generic options are available: 102*5e7646d2SAndroid Build Coastguard Worker<dl class="man"> 103*5e7646d2SAndroid Build Coastguard Worker<dt><b>-o job-sheets=</b><i>name</i> 104*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em">Prints a cover page (banner) with the document. 105*5e7646d2SAndroid Build Coastguard WorkerThe "name" can be "classified", "confidential", "secret", "standard", "topsecret", or "unclassified". 106*5e7646d2SAndroid Build Coastguard Worker<dt><b>-o media=</b><i>size</i> 107*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em">Sets the page size to <i>size</i>. Most printers support at least the size names "a4", "letter", and "legal". 108*5e7646d2SAndroid Build Coastguard Worker<dt><b>-o number-up=</b>{<i>2|4|6|9|16</i>} 109*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em">Prints 2, 4, 6, 9, or 16 document (input) pages on each output page. 110*5e7646d2SAndroid Build Coastguard Worker<dt><b>-o orientation-requested=4</b> 111*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em">Prints the job in landscape (rotated 90 degrees counter-clockwise). 112*5e7646d2SAndroid Build Coastguard Worker<dt><b>-o orientation-requested=5</b> 113*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em">Prints the job in landscape (rotated 90 degrees clockwise). 114*5e7646d2SAndroid Build Coastguard Worker<dt><b>-o orientation-requested=6</b> 115*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em">Prints the job in reverse portrait (rotated 180 degrees). 116*5e7646d2SAndroid Build Coastguard Worker<dt><b>-o print-quality=3</b> 117*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em"><dt><b>-o print-quality=4</b> 118*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em"><dt><b>-o print-quality=5</b> 119*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em">Specifies the output quality - draft (3), normal (4), or best (5). 120*5e7646d2SAndroid Build Coastguard Worker<dt><b>-o sides=one-sided</b> 121*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em">Prints on one side of the paper. 122*5e7646d2SAndroid Build Coastguard Worker<dt><b>-o sides=two-sided-long-edge</b> 123*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em">Prints on both sides of the paper for portrait output. 124*5e7646d2SAndroid Build Coastguard Worker<dt><b>-o sides=two-sided-short-edge</b> 125*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em">Prints on both sides of the paper for landscape output. 126*5e7646d2SAndroid Build Coastguard Worker</dl> 127*5e7646d2SAndroid Build Coastguard Worker<h2 class="title"><a name="NOTES">Notes</a></h2> 128*5e7646d2SAndroid Build Coastguard WorkerThe <i>-c</i>, <i>-d</i>, <i>-f</i>, <i>-g</i>, <i>-i</i>, <i>-n</i>, <i>-t</i>, <i>-v</i>, and <i>-w</i> options are not supported by CUPS and produce a warning message if used. 129*5e7646d2SAndroid Build Coastguard Worker<h2 class="title"><a name="EXAMPLES">Examples</a></h2> 130*5e7646d2SAndroid Build Coastguard WorkerPrint two copies of a document to the default printer: 131*5e7646d2SAndroid Build Coastguard Worker<pre class="man"> 132*5e7646d2SAndroid Build Coastguard Worker 133*5e7646d2SAndroid Build Coastguard Worker lpr -# 2 filename 134*5e7646d2SAndroid Build Coastguard Worker 135*5e7646d2SAndroid Build Coastguard Worker</pre> 136*5e7646d2SAndroid Build Coastguard WorkerPrint a double-sided legal document to a printer called "foo": 137*5e7646d2SAndroid Build Coastguard Worker<pre class="man"> 138*5e7646d2SAndroid Build Coastguard Worker 139*5e7646d2SAndroid Build Coastguard Worker lpr -P foo -o media=legal -o sides=two-sided-long-edge filename 140*5e7646d2SAndroid Build Coastguard Worker 141*5e7646d2SAndroid Build Coastguard Worker</pre> 142*5e7646d2SAndroid Build Coastguard WorkerPrint a presentation document 2-up to a printer called "foo": 143*5e7646d2SAndroid Build Coastguard Worker<pre class="man"> 144*5e7646d2SAndroid Build Coastguard Worker 145*5e7646d2SAndroid Build Coastguard Worker lpr -P foo -o number-up=2 filename 146*5e7646d2SAndroid Build Coastguard Worker</pre> 147*5e7646d2SAndroid Build Coastguard Worker<h2 class="title"><a name="SEE_ALSO">See Also</a></h2> 148*5e7646d2SAndroid Build Coastguard Worker<b>cancel</b>(1), 149*5e7646d2SAndroid Build Coastguard Worker<b>lp</b>(1), 150*5e7646d2SAndroid Build Coastguard Worker<b>lpadmin</b>(8), 151*5e7646d2SAndroid Build Coastguard Worker<b>lpoptions</b>(1), 152*5e7646d2SAndroid Build Coastguard Worker<b>lpq</b>(1), 153*5e7646d2SAndroid Build Coastguard Worker<b>lprm</b>(1), 154*5e7646d2SAndroid Build Coastguard Worker<b>lpstat</b>(1), 155*5e7646d2SAndroid Build Coastguard WorkerCUPS Online Help (<a href="http://localhost:631/help">http://localhost:631/help</a>) 156*5e7646d2SAndroid Build Coastguard Worker<h2 class="title"><a name="COPYRIGHT">Copyright</a></h2> 157*5e7646d2SAndroid Build Coastguard WorkerCopyright © 2007-2019 by Apple Inc. 158*5e7646d2SAndroid Build Coastguard Worker 159*5e7646d2SAndroid Build Coastguard Worker</body> 160*5e7646d2SAndroid Build Coastguard Worker</html> 161