204 lines
7.3 KiB
HTML
204 lines
7.3 KiB
HTML
<!DOCTYPE HTML>
|
|
<html>
|
|
<!-- SECTION: Man Pages -->
|
|
<head>
|
|
<link rel="stylesheet" type="text/css" href="../cups-printable.css">
|
|
<title>lp(1)</title>
|
|
</head>
|
|
<body>
|
|
<h1 class="title">lp(1)</h1>
|
|
<h2 class="title"><a name="NAME">Name</a></h2>
|
|
lp - print files
|
|
<h2 class="title"><a name="SYNOPSIS">Synopsis</a></h2>
|
|
<b>lp</b>
|
|
[
|
|
<b>-E</b>
|
|
] [
|
|
<b>-U</b>
|
|
<i>username</i>
|
|
] [
|
|
<b>-c</b>
|
|
] [
|
|
<b>-d </b><i>destination</i>[<b>/</b><i>instance</i>]
|
|
] [
|
|
<b>-h </b><i>hostname</i>[<b>:</b><i>port</i>]
|
|
] [
|
|
<b>-m</b>
|
|
] [
|
|
<b>-n</b>
|
|
<i>num-copies</i>
|
|
] [
|
|
<b>-o </b><i>option</i>[<b>=</b><i>value</i>]
|
|
] [
|
|
<b>-q</b>
|
|
<i>priority</i>
|
|
] [
|
|
<b>-s</b>
|
|
] [
|
|
<b>-t</b>
|
|
<i>title</i>
|
|
] [
|
|
<b>-H</b>
|
|
<i>handling</i>
|
|
] [
|
|
<b>-P</b>
|
|
<i>page-list</i>
|
|
] [
|
|
<b>--</b>
|
|
] [
|
|
<i>file(s)</i>
|
|
]
|
|
<br>
|
|
<b>lp</b>
|
|
[
|
|
<b>-E</b>
|
|
] [
|
|
<b>-U</b>
|
|
<i>username</i>
|
|
] [
|
|
<b>-c</b>
|
|
] [
|
|
<b>-h </b><i>hostname</i>[<b>:</b><i>port</i>]
|
|
] [
|
|
<b>-i</b>
|
|
<i>job-id</i>
|
|
] [
|
|
<b>-n</b>
|
|
<i>num-copies</i>
|
|
] [
|
|
<b>-o </b><i>option</i>[<b>=</b><i>value</i>]
|
|
] [
|
|
<b>-q</b>
|
|
<i>priority</i>
|
|
] [
|
|
<b>-t</b>
|
|
<i>title</i>
|
|
] [
|
|
<b>-H</b>
|
|
<i>handling</i>
|
|
] [
|
|
<b>-P</b>
|
|
<i>page-list</i>
|
|
]
|
|
<h2 class="title"><a name="DESCRIPTION">Description</a></h2>
|
|
<b>lp</b> submits files for printing or alters a pending job.
|
|
Use a filename of "-" to force printing from the standard input.
|
|
<h3><a name="THE_DEFAULT_DESTINATION">The Default Destination</a></h3>
|
|
CUPS provides many ways to set the default destination. The <b>LPDEST</b> and <b>PRINTER</b> environment variables are consulted first.
|
|
If neither are set, the current default set using the
|
|
<b>lpoptions</b>(1)
|
|
command is used, followed by the default set using the
|
|
<b>lpadmin</b>(8)
|
|
command.
|
|
<h2 class="title"><a name="OPTIONS">Options</a></h2>
|
|
The following options are recognized by <i>lp</i>:
|
|
<dl class="man">
|
|
<dt><b>--</b>
|
|
<dd style="margin-left: 5.0em">Marks the end of options; use this to print a file whose name begins with a dash (-).
|
|
<dt><b>-E</b>
|
|
<dd style="margin-left: 5.0em">Forces encryption when connecting to the server.
|
|
<dt><b>-U </b><i>username</i>
|
|
<dd style="margin-left: 5.0em">Specifies the username to use when connecting to the server.
|
|
<dt><b>-c</b>
|
|
<dd style="margin-left: 5.0em">This option is provided for backwards-compatibility only. On systems that support it, this option forces the print file to be copied to the spool directory before printing.
|
|
In CUPS, print files are always sent to the scheduler via IPP which has the same effect.
|
|
<dt><b>-d </b><i>destination</i>
|
|
<dd style="margin-left: 5.0em">Prints files to the named printer.
|
|
<dt><b>-h </b><i>hostname</i>[<b>:</b><i>port</i>]
|
|
<dd style="margin-left: 5.0em">Chooses an alternate server.
|
|
<dt><b>-i </b><i>job-id</i>
|
|
<dd style="margin-left: 5.0em">Specifies an existing job to modify.
|
|
<dt><b>-m</b>
|
|
<dd style="margin-left: 5.0em">Sends an email when the job is completed.
|
|
<dt><b>-n </b><i>copies</i>
|
|
<dd style="margin-left: 5.0em">Sets the number of copies to print.
|
|
<dt><b>-o "</b><i>name</i><b>=</b><i>value </i>[ ... <i>name</i><b>=</b><i>value </i>]<b>"</b>
|
|
<dd style="margin-left: 5.0em">Sets one or more job options.
|
|
See "COMMON JOB OPTIONS" below.
|
|
<dt><b>-q </b><i>priority</i>
|
|
<dd style="margin-left: 5.0em">Sets the job priority from 1 (lowest) to 100 (highest).
|
|
The default priority is 50.
|
|
<dt><b>-s</b>
|
|
<dd style="margin-left: 5.0em">Do not report the resulting job IDs (silent mode.)
|
|
<dt><b>-t "</b><i>name</i><b>"</b>
|
|
<dd style="margin-left: 5.0em">Sets the job name.
|
|
<dt><b>-H </b><i>hh:mm</i>
|
|
<dd style="margin-left: 5.0em"><dt><b>-H hold</b>
|
|
<dd style="margin-left: 5.0em"><dt><b>-H immediate</b>
|
|
<dd style="margin-left: 5.0em"><dt><b>-H restart</b>
|
|
<dd style="margin-left: 5.0em"><dt><b>-H resume</b>
|
|
<dd style="margin-left: 5.0em">Specifies when the job should be printed.
|
|
A value of <i>immediate</i> will print the file immediately, a value of <i>hold</i> will hold the job indefinitely, and a UTC time value (HH:MM) will hold the job until the specified UTC (not local) time.
|
|
Use a value of <i>resume</i> with the <i>-i</i> option to resume a held job.
|
|
Use a value of <i>restart</i> with the <i>-i</i> option to restart a completed job.
|
|
<dt><b>-P </b><i>page-list</i>
|
|
<dd style="margin-left: 5.0em">Specifies which pages to print in the document.
|
|
The list can contain a list of numbers and ranges (#-#) separated by commas, e.g., "1,3-5,16".
|
|
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.
|
|
</dl>
|
|
<h3><a name="COMMON_JOB_OPTIONS">Common Job Options</a></h3>
|
|
Aside from the printer-specific options reported by the
|
|
<b>lpoptions</b>(1)
|
|
command, the following generic options are available:
|
|
<dl class="man">
|
|
<dt><b>-o job-sheets=</b><i>name</i>
|
|
<dd style="margin-left: 5.0em">Prints a cover page (banner) with the document.
|
|
The "name" can be "classified", "confidential", "secret", "standard", "topsecret", or "unclassified".
|
|
<dt><b>-o media=</b><i>size</i>
|
|
<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".
|
|
<dt><b>-o number-up=</b>{<i>2|4|6|9|16</i>}
|
|
<dd style="margin-left: 5.0em">Prints 2, 4, 6, 9, or 16 document (input) pages on each output page.
|
|
<dt><b>-o orientation-requested=4</b>
|
|
<dd style="margin-left: 5.0em">Prints the job in landscape (rotated 90 degrees counter-clockwise).
|
|
<dt><b>-o orientation-requested=5</b>
|
|
<dd style="margin-left: 5.0em">Prints the job in landscape (rotated 90 degrees clockwise).
|
|
<dt><b>-o orientation-requested=6</b>
|
|
<dd style="margin-left: 5.0em">Prints the job in reverse portrait (rotated 180 degrees).
|
|
<dt><b>-o print-quality=3</b>
|
|
<dd style="margin-left: 5.0em"><dt><b>-o print-quality=4</b>
|
|
<dd style="margin-left: 5.0em"><dt><b>-o print-quality=5</b>
|
|
<dd style="margin-left: 5.0em">Specifies the output quality - draft (3), normal (4), or best (5).
|
|
<dt><b>-o sides=one-sided</b>
|
|
<dd style="margin-left: 5.0em">Prints on one side of the paper.
|
|
<dt><b>-o sides=two-sided-long-edge</b>
|
|
<dd style="margin-left: 5.0em">Prints on both sides of the paper for portrait output.
|
|
<dt><b>-o sides=two-sided-short-edge</b>
|
|
<dd style="margin-left: 5.0em">Prints on both sides of the paper for landscape output.
|
|
</dl>
|
|
<h2 class="title"><a name="CONFORMING_TO">Conforming To</a></h2>
|
|
Unlike the System V printing system, CUPS allows printer names to contain any printable character except SPACE, TAB, "/", or "#".
|
|
Also, printer and class names are <i>not</i> case-sensitive.
|
|
<p>The <i>-q</i> option accepts a different range of values than the Solaris lp command, matching the IPP job priority values (1-100, 100 is highest priority) instead of the Solaris values (0-39, 0 is highest priority).
|
|
<h2 class="title"><a name="EXAMPLES">Examples</a></h2>
|
|
Print two copies of a document to the default printer:
|
|
<pre class="man">
|
|
|
|
lp -n 2 filename
|
|
|
|
</pre>
|
|
Print a double-sided legal document to a printer called "foo":
|
|
<pre class="man">
|
|
|
|
lp -d foo -o media=legal -o sides=two-sided-long-edge filename
|
|
|
|
</pre>
|
|
Print a presentation document 2-up to a printer called "bar":
|
|
<pre class="man">
|
|
|
|
lp -d bar -o number-up=2 filename
|
|
</pre>
|
|
<h2 class="title"><a name="SEE_ALSO">See Also</a></h2>
|
|
<b>cancel</b>(1),
|
|
<b>lpadmin</b>(8),
|
|
<b>lpoptions</b>(1),
|
|
<b>lpq</b>(1),
|
|
<b>lpr</b>(1),
|
|
<b>lprm</b>(1),
|
|
<b>lpstat</b>(1),
|
|
CUPS Online Help (<a href="http://localhost:631/help">http://localhost:631/help</a>)
|
|
<h2 class="title"><a name="COPYRIGHT">Copyright</a></h2>
|
|
Copyright © 2007-2019 by Apple Inc.
|
|
|
|
</body>
|
|
</html>
|