lp - print files
lp [ -E ] [ -U username ] [ -c ] [ -d destination[/instance] ] [ -h hostname[:port] ] [ -m ] [ -n num-copies ] [ -o option[=value] ]
[ -q priority ] [ -s ] [ -t title ] [ -H handling ] [ -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 ]
CUPS provides many ways to set the default destination. The "LPDEST" and "PRINTER" environment variables are consulted first. If nei-
ther are set, the current default set using the lpoptions(1) command is used, followed by the default set using the lpadmin(8) com-
mand.
-- 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 obselete
-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.
-u username Submits jobs as username.
-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 time value (HH:MM) will hold the job until the specified 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 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.
COMMON JOB OPTIONS
Aside from the printer-specific options reported by the lpoptions(1) command, the following generic options are available:
-o media=size Sets the page size to size.
Most printers support at least the size names "a4", "letter", 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 fitplot 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 scaling=number Scales image files to use up to number percent of the page. Values greater than 100 cause the image file to be printed across
multiple pages.
-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
CUPS allows printer names to contain any printable character except SPACE, TAB, "/", or "#".
printer and class names are not case-sensitive.
The "q" option accepts a range of values matching the IPP job priority values (1-100, 100 is highest priority)
lpr - print files
lpr [ -E ] [ -H server[:port] ] [ -U username ] [ -P destination[/instance] ] [ -# num-copies [ -h ] [ -l ] [ -m ] [ -o
option[=value] ] [ -p] [ -q ] [ -r ] [ -C/J/T title ] [ file(s) ]
lpr submits files for printing. Files named on the command line are sent to the named printer (or the default destination if no destination is specified). If no files are listed on the command-line, lpr reads the print file from the standard input.
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 lpoptions(1) command is used,
followed by the default set using the lpadmin(8) command.
-E Forces encryption when connecting to the server.
-H server[:port] Specifies an alternate server.
-C "name"
-J "name"
-T "name" Sets the job name.
-P destination[/instance] Prints files to the named printer.
-U username Specifies an alternate username.
-# copies Sets the number of copies to print from 1 to 100.
-h Disables banner printing. This option is equivalent to "-o job-sheets=none".
-l Specifies that the print file is already formatted for the destination and should be sent without filtering. This option is
equivalent to "-o raw".
-m Send an email on job completion.
-o option[=value] Sets a job option.
-p Specifies that the print file should be formatted with a shaded header with the date, time, job name, and page number. This
option is equivalent to "-o prettyprint" and is only useful when printing text files.
-q Hold job for printing.
-r Specifies that the named print files should be deleted after printing them.
COMPATIBILITY
The "c", "d", "f", "g", "i", "n", "t", "v", and "w" options are not supported by CUPS and produce a warning message if used.
SEE ALSO
lp(1), lpadmin(8), lpoptions(1), lpq(1), lprm(1), lpstat(1),cancel(1),
http://localhost:631/help
lpq - show printer queue status
lpq [ -E ] [ -U username ] [ -h server[:port] ] [ -P destination[/instance] ] [ -a ] [ -l ] [ +interval ]
lpq shows the current print queue status on the named printer. Jobs queued on the default destination will be shown if no printer or
class is specified on the command-line.
The +interval option allows you to continuously report the jobs in the queue until the queue is empty; the list of jobs is shown once
every interval seconds.
-E Forces encryption when connecting to the server.
-P destination[/instance] Specifies an alternate printer or class name.
-U username Specifies an alternate username.
-a Reports jobs on all printers.
-h server[:port] Specifies an alternate server.
-l Requests a more verbose (long) reporting format.
SEE ALSO
lpoptions - display or set printer options and defaults
SYNOPSIS
lpoptions [ -E ] [ -U username ] [ -h server[:port] ] -d destination[/instance] [ -o option[=value] ] ... [ -o option[=value] ]
lpoptions [ -E ] [ -U username ] [ -h server[:port] ] [ -p destination[/instance] ] -l
lpoptions [ -E ] [ -U username ] [ -h server[:port] ] [ -o option[=value] ] ... [ -o option[=value] ] [ -p destination[/instance] ]
-r option
lpoptions [ -E ] [ -U username ] [ -h server[:port] ] -x destination[/instance]
DESCRIPTION
lpoptions displays or sets printer options and defaults. lpoptions shows the default printer options when run with no arguments.
Other options include:
-E
Enables encryption when communicating with the CUPS server.
-U username
Uses an alternate username.
-d destination[/instance]
Sets the user default printer to destination. If instance is supplied then that particular instance is used. This option over-
rides the system default printer for the current user.
-h server[:port]
Uses an alternate server.
-l
Lists the printer specific options and their current settings.
-o option[=value]
Specifies a new option for the named destination.
-p destination[/instance]
Sets the destination and instance, if specified, for any options that follow. If the named instance does not exist then it is
created.
-r option
Removes the specified option for the named destination.
-x destination[/instance]
Removes the options for the named destination and instance, if specified. If the named instance does not exist then this does
nothing.
If no options are specified using the -o option, then the current options for the named printer are reported on the standard output.
Options set with the lpoptions command are used by the lp(1) and lpr(1) commands when submitting jobs.
ROOT ACCOUNT OPTIONS
When run by the root user, lpoptions gets and sets default options and instances for all users in the /private/etc/cups/lpoptions
file.
COMPATIBILITY
The lpoptions command is unique to CUPS.
FILES
~/.cups/lpoptions - user defaults and instances created by non-root users.
/private/etc/cups/lpoptions - system-wide defaults and instances created by the root user.
SEE ALSO
cancel(1), lp(1), lpadmin(8), lpr(1),
http://localhost:631/help
> lpoptions
auth-info-required=none
copies=1
device-uri=usb://Canon/iP1600?serial=74E0F6
finishings=3
job-hold-until=no-hold
job-priority=50
job-sheets=none,none
marker-change-time=1305914246
marker-colors=#101010,#00FFFF#FF00FF#FFFF00
marker-levels=0,40
marker-names=ink1140,ink1241
marker-types=ink,ink
number-up=1
printer-commands=PrintSelfTestPage,ReportLevels
printer-info='Canon iP1600'
printer-is-accepting-jobs=true
printer-is-shared=true
printer-location=smackerPro
printer-make-and-model='Canon iP1600'
printer-state=3
printer-state-change-time=1305914246
printer-state-reasons=none
printer-type=8425484
printer-uri-supported=ipp://localhost:631/printers/Canon_iP1600
> lpq
Canon_iP1600 is ready
Rank Owner Job File(s) Total Size
1st dgerman 7 (stdin) 0 bytes
2nd dgerman 8 (stdin) 0 bytes
> lpr ./Documents/invest/gold-110520.txt
> lpq
printing
Rank Owner Job File(s) Total Size
1st dgerman 7 (stdin) 0 bytes
2nd dgerman 8 (stdin) 0 bytes
active dgerman 9 gold-110520.txt 1024 bytes
add a network group or mobile account user to the lpadmin group.
sudo dseditgroup -o edit -n /Local/Default -a everyone -t group lpadmin