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