Unix/Linux Go Back    


CentOS 7.0 - man page for lp-cups (centos section 1)

Linux & Unix Commands - Search Man Pages
Man Page or Keyword Search:   man
Select Man Page Set:       apropos Keyword Search (sections above)


lp(1)					    Apple Inc.					    lp(1)

NAME
       lp - print files

SYNOPSIS
       lp [ -E ] [ -U username ] [ -c ] [ -d destination[/instance] ] [ -h hostname[:port] ] [ -m
       ] [ -n num-copies ] [ -o option[=value] ] [ -q priority ] [ -s ] [ -t title ]  [  -H  han-
       dling ] [ -P page-list ] [ -- ] [ file(s) ]
       lp  [ -E ] [ -U username ] [ -c ] [ -h hostname[:port] ] [ -i job-id ] [ -n num-copies ] [
       -o option[=value] ] [ -q priority ] [ -t title ] [ -H handling ] [ -P page-list ]

DESCRIPTION
       lp submits files for printing or alters a pending job. Use a  filename  of  "-"	to  force
       printing from the standard input.

THE DEFAULT DESTINATION
       CUPS  provides  many ways to set the default destination. The "LPDEST" and "PRINTER" envi-
       ronment variables are consulted first. If neither are set, the current default  set  using
       the  lpoptions(1)  command  is used, followed by the default set using the lpadmin(8) com-
       mand.

OPTIONS
       The following options are recognized by lp:

       --
	    Marks the end of options; use this to print a file whose name begins with a dash (-).

       -E
	    Forces encryption when connecting to the server.

       -U username
	    Specifies the username to use when connecting to the server.

       -c
	    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 print-
	    ing. In CUPS, print files are always sent to the scheduler via IPP which has the same
	    effect.

       -d destination
	    Prints files to the named printer.

       -h hostname[:port]
	    Chooses an alternate server.

       -i job-id
	    Specifies an existing job to modify.

       -m
	    Sends an email when the job is completed.

       -n copies
	    Sets the number of copies to print from 1 to 100.

       -o "name=value [name=value ...]"
	    Sets one or more job options.

       -q priority
	    Sets the job priority from 1 (lowest) to 100 (highest). The default priority is 50.

       -s
	    Do not report the resulting job IDs (silent mode.)

       -t "name"
	    Sets the job name.

       -H hh:mm

       -H hold

       -H immediate

       -H restart

       -H resume
	    Specifies  when  the  job should be printed. A value of immediate will print the file
	    immediately, a value of hold 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
	    resume with the -i option to resume a held job.  Use a value of restart with  the  -i
	    option to restart a completed job.

       -P page-list
	    Specifies  which  pages to print in the document. The list can contain a list of num-
	    bers 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.

COMMON JOB OPTIONS
       Aside from the printer-specific options reported by the lpoptions(1) command, the  follow-
       ing generic options are available:

       -o media=size
	    Sets the page size to size. Most printers support at least the size names "a4", "let-
	    ter", and "legal".

       -o landscape

       -o orientation-requested=4
	    Prints the job in landscape (rotated 90 degrees).

       -o sides=one-sided

       -o sides=two-sided-long-edge

       -o sides=two-sided-short-edge
	    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.

       -o fit-to-page
	    Scales the print file to fit on the page.

       -o number-up=2

       -o number-up=4

       -o number-up=6

       -o number-up=9

       -o number-up=16
	    Prints multiple document pages on each output page.

       -o cpi=N
	    Sets the number of characters per inch to use when printing a text file. The  default
	    is 10.

       -o lpi=N
	    Sets the number of lines per inch to use when printing a text file. The default is 6.

       -o page-bottom=N

       -o page-left=N

       -o page-right=N

       -o page-top=N
	    Sets  the page margins when printing text files. The values are in points - there are
	    72 points to the inch.

EXAMPLES
       Print a double-sided legal document to a printer called "foo":
	   lp -d foo -o media=legal -o sides=two-sided-long-edge filename

       Print an image across 4 pages:
	   lp -d bar -o scaling=200 filename

       Print a text file with 12 characters per inch, 8 lines per inch, and a 1 inch left margin:
	   lp -d bar -o cpi=12 -o lpi=8 -o page-left=72 filename

COMPATIBILITY
       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 not case-sen-
       sitive.

       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).

SEE ALSO
       cancel(1), lpadmin(8), lpmove(8), lpoptions(1), lpstat(1),
       http://localhost:631/help

COPYRIGHT
       Copyright 2007-2013 by Apple Inc.

16 July 2012				       CUPS					    lp(1)
Unix & Linux Commands & Man Pages : ©2000 - 2018 Unix and Linux Forums


All times are GMT -4. The time now is 12:34 AM.