# lpr

## NAME



           lpr - print files
    


## SYNOPSIS



           **lpr**[ **-H** _server_[**:**_port_] ] [ **-E**] [ **-U** _username_ ] [ **-P**
           _destination_[**/**_instance_] ] [ **-#**_num-copies_ [ **-h**] [ **-l**] [ **-m**] [ **-o**
           _option_[**=**_value_] ] [ **-p**] [ **-q**] [ **-r**] [ **-C** _title_ ] [ **-J** _title_ ] [
           **-T** _title_ ] [ _file(s)_ ]
    


## DESCRIPTION



           **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.
    
       **THE DEFAULT DESTINATION**
           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.
    


## OPTIONS



           The following options are recognized by _lpr_ :
    
           **-E** Forces encryption when connecting to the server.
    
           **-H** _server_[**:**_port_]
                Specifies an alternate server.  Note: This option must occur
                before all others.
    
           **-C "**_name_**"**
    
           **-J "**_name_**"**
    
           **-T "**_name_**"**
                Sets the job name/title.
    
           **-P** _destination_[**/**_instance_]
                Prints files to the named printer.
    
           **-U** _username_
                Specifies an alternate username.
    
           **-#**_copies_
                Sets the number of copies to print.
    
           **-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.  See "COMMON JOB OPTIONS" below.
    
           **-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
                submitting them.
    
       **COMMON JOB OPTIONS**
           Aside from the printer-specific options reported by the
           lpoptions(1) command, the following generic options are available:
    
           **-o job-sheets=**_name_
                Prints a cover page (banner) with the document.  The "name"
                can be "classified", "confidential", "secret", "standard",
                "topsecret", or "unclassified".
    
           **-o media=**_size_
                Sets the page size to _size_. Most printers support at least
                the size names "a4", "letter", and "legal".
    
           **-o number-up=**{_2|4|6|9|16_}
                Prints 2, 4, 6, 9, or 16 document (input) pages on each
                output page.
    
           **-o orientation-requested=4**
                Prints the job in landscape (rotated 90 degrees counter-
                clockwise).
    
           **-o orientation-requested=5**
                Prints the job in landscape (rotated 90 degrees clockwise).
    
           **-o orientation-requested=6**
                Prints the job in reverse portrait (rotated 180 degrees).
    
           **-o print-quality=3**
    
           **-o print-quality=4**
    
           **-o print-quality=5**
                Specifies the output quality - draft (3), normal (4), or best
                (5).
    
           **-o sides=one-sided**
                Prints on one side of the paper.
    
           **-o sides=two-sided-long-edge**
                Prints on both sides of the paper for portrait output.
    
           **-o sides=two-sided-short-edge**
                Prints on both sides of the paper for landscape output.
    


## NOTES



           The _-c_ , _-d_ , _-f_ , _-g_ , _-i_ , _-n_ , _-t_ , _-v_ , and _-w_ options are not
           supported by CUPS and produce a warning message if used.
    


## ENVIRONMENT



           The following environment variables override the default
           destination:
    
           **LPDEST**
                Specifies the default print queue (System V standard).
    
           **PRINTER**
                Specifies the default print queue (Berkeley standard).
    


## EXAMPLES



           Print two copies of a document to the default printer:
    
               lpr -# 2 filename
    
           Print a double-sided legal document to a printer called "foo":
    
               lpr -P foo -o media=legal -o sides=two-sided-long-edge filename
    
           Print a presentation document 2-up to a printer called "foo":
    
               lpr -P foo -o number-up=2 filename
    


* * *