--- /dev/null
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<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>[ -E ] [ -U
+<i>username
+</i>] [ -c ] [ -d
+<i>destination[/instance]
+</i>] [ -h
+<i>hostname[:port]
+</i>] [ -m ] [ -n
+<i>num-copies
+</i>] [ -o
+<i>option[=value]
+</i>] [ -q
+<i>priority
+</i>] [ -s ] [ -t
+<i>title
+</i>] [ -H
+<i>handling
+</i>] [ -P
+<i>page-list
+</i>] [ -- ] [
+<i>file(s)
+</i>]
+<br>
+<b>lp
+</b>[ -E ] [ -U
+<i>username
+</i>] [ -c ] [ -h
+<i>hostname[:port]
+</i>] [ -i
+<i>job-id
+</i>] [ -n
+<i>num-copies
+</i>] [ -o
+<i>option[=value]
+</i>] [ -q
+<i>priority
+</i>] [ -t
+<i>title
+</i>] [ -H
+<i>handling
+</i>] [ -P
+<i>page-list
+</i>]
+<h2 class="title"><a name="DESCRIPTION">Description</a></h2>
+<i>lp</i> submits files for printing or alters a pending job. Use
+a filename of "-" to force printing from the standard input.
+<h2 class="title"><a name="THE_DEFAULT_DESTINATION">The Default Destination</a></h2>
+CUPS provides many ways to set the default destination. The "LPDEST" and
+"PRINTER" environment variables are consulted first. If neither are set,
+the current default set using the <a href='man-lpoptions.html?TOPIC=Man+Pages'>lpoptions(1)</a> command is used,
+followed by the default set using the <a href='man-lpadmin.html?TOPIC=Man+Pages'>lpadmin(8)</a> command.
+<h2 class="title"><a name="OPTIONS">Options</a></h2>
+The following options are recognized by <i>lp</i>:
+<dl>
+<dt>--
+</dt>
+<dd></dd>
+<dd>Marks the end of options; use this to print a file whose name
+begins with a dash (-).
+</dd>
+<dt>-E
+</dt>
+<dd></dd>
+<dd>Forces encryption when connecting to the server.
+</dd>
+<dt>-U username
+</dt>
+<dd></dd>
+<dd>Specifies the username to use when connecting to the server.
+</dd>
+<dt>-c
+</dt>
+<dd></dd>
+<dd>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.
+</dd>
+<dt>-d destination
+</dt>
+<dd></dd>
+<dd>Prints files to the named printer.
+</dd>
+<dt>-h hostname[:port]
+</dt>
+<dd></dd>
+<dd>Chooses an alternate server.
+</dd>
+<dt>-i job-id
+</dt>
+<dd></dd>
+<dd>Specifies an existing job to modify.
+</dd>
+<dt>-m
+</dt>
+<dd></dd>
+<dd>Sends an email when the job is completed.
+</dd>
+<dt>-n copies
+</dt>
+<dd></dd>
+<dd>Sets the number of copies to print from 1 to 100.
+</dd>
+<dt>-o "name=value [name=value ...]"
+</dt>
+<dd></dd>
+<dd>Sets one or more job options.
+</dd>
+<dt>-q priority
+</dt>
+<dd></dd>
+<dd>Sets the job priority from 1 (lowest) to 100 (highest). The
+default priority is 50.
+</dd>
+<dt>-s
+</dt>
+<dd></dd>
+<dd>Do not report the resulting job IDs (silent mode.)
+</dd>
+<dt>-t "name"
+</dt>
+<dd></dd>
+<dd>Sets the job name.
+</dd>
+<dt>-H hh:mm
+</dt>
+<dd></dd>
+<dt>-H hold
+</dt>
+<dd></dd>
+<dt>-H immediate
+</dt>
+<dd></dd>
+<dt>-H restart
+</dt>
+<dd></dd>
+<dt>-H resume
+</dt>
+<dd></dd>
+<dd>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.
+</dd>
+<dt>-P page-list
+</dt>
+<dd></dd>
+<dd>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.
+</dd>
+</dl>
+<h2 class="title"><a name="COMMON_JOB_OPTIONS">Common Job Options</a></h2>
+Aside from the printer-specific options reported by the
+<a href='man-lpoptions.html?TOPIC=Man+Pages'>lpoptions(1)</a> command, the following generic options are
+available:
+<dl>
+<dt>-o media=size
+</dt>
+<dd></dd>
+<dd>Sets the page size to <i>size</i>. Most printers support at least
+the size names "a4", "letter", and "legal".
+</dd>
+<dt>-o landscape
+</dt>
+<dd></dd>
+<dt>-o orientation-requested=4
+</dt>
+<dd></dd>
+<dd>Prints the job in landscape (rotated 90 degrees).
+</dd>
+<dt>-o sides=one-sided
+</dt>
+<dd></dd>
+<dt>-o sides=two-sided-long-edge
+</dt>
+<dd></dd>
+<dt>-o sides=two-sided-short-edge
+</dt>
+<dd></dd>
+<dd>Prints on one or two sides of the paper. The value
+"two-sided-long-edge" is normally used when printing portrait
+(unrotated) pages, while "two-sided-short-edge" is used for
+landscape pages.
+</dd>
+<dt>-o fit-to-page
+</dt>
+<dd></dd>
+<dd>Scales the print file to fit on the page.
+</dd>
+<dt>-o number-up=2
+</dt>
+<dd></dd>
+<dt>-o number-up=4
+</dt>
+<dd></dd>
+<dt>-o number-up=6
+</dt>
+<dd></dd>
+<dt>-o number-up=9
+</dt>
+<dd></dd>
+<dt>-o number-up=16
+</dt>
+<dd></dd>
+<dd>Prints multiple document pages on each output page.
+</dd>
+<dt>-o cpi=N
+</dt>
+<dd></dd>
+<dd>Sets the number of characters per inch to use when printing a
+text file. The default is 10.
+</dd>
+<dt>-o lpi=N
+</dt>
+<dd></dd>
+<dd>Sets the number of lines per inch to use when printing a text
+file. The default is 6.
+</dd>
+<dt>-o page-bottom=N
+</dt>
+<dd></dd>
+<dt>-o page-left=N
+</dt>
+<dd></dd>
+<dt>-o page-right=N
+</dt>
+<dd></dd>
+<dt>-o page-top=N
+</dt>
+<dd></dd>
+<dd>Sets the page margins when printing text files. The values are in
+points - there are 72 points to the inch.
+</dd>
+</dl>
+<h2 class="title"><a name="EXAMPLES">Examples</a></h2>
+Print a double-sided legal document to a printer called "foo":
+<pre>
+ lp -d foo -o media=legal -o sides=two-sided-long-edge filename
+</pre>
+<p>Print an image across 4 pages:
+<pre>
+ lp -d bar -o scaling=200 filename
+</pre>
+<p>Print a text file with 12 characters per inch, 8 lines per inch, and
+a 1 inch left margin:
+<pre>
+ lp -d bar -o cpi=12 -o lpi=8 -o page-left=72 filename
+</pre>
+<h2 class="title"><a name="COMPATIBILITY">Compatibility</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 "q" 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="SEE_ALSO">See Also</a></h2>
+<a href='man-cancel.html?TOPIC=Man+Pages'>cancel(1)</a>, <a href='man-lpadmin.html?TOPIC=Man+Pages'>lpadmin(8)</a>, <a href='man-lpmove.html?TOPIC=Man+Pages'>lpmove(8)</a>, <a href='man-lpoptions.html?TOPIC=Man+Pages'>lpoptions(1)</a>,
+<a href='man-lpstat.html?TOPIC=Man+Pages'>lpstat(1)</a>,
+<br>
+<a href='http://localhost:631/help'>http://localhost:631/help</a>
+<h2 class="title"><a name="COPYRIGHT">Copyright</a></h2>
+Copyright 2007-2013 by Apple Inc.
+
+</body>
+</html>
projects / thirdparty / cups.git / blobdiff