Mac Developer Library Developer


This manual page is for Mac OS X version 10.9

If you are running a different version of Mac OS X, view the documentation locally:

  • In Terminal, using the man(1) command

Reading manual pages

Manual pages are intended as a quick reference for people who already understand a technology.

  • To learn how the manual is organized or to learn about command syntax, read the manual page for manpages(5).

  • For more information about this technology, look for other documentation in the Apple Developer Library.

  • For general information about writing shell scripts, read Shell Scripting Primer.

lpr(1)                                           Apple Inc.                                           lpr(1)

       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  vari-ables variables
       ables 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.

       The following options are recognized by lpr:

            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.

            Disables banner printing. This option is equivalent to "-o job-sheets=none".

            Specifies that the print file is already formatted for the destination and should be sent  with-out without
            out filtering. This option is equivalent to "-o raw".

            Send an email on job completion.

       -o option[=value]
            Sets a job option.

            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.

            Hold job for printing.

            Specifies that the named print files should be deleted after printing them.

       The  "c",  "d", "f", "g", "i", "n", "t", "v", and "w" options are not supported by CUPS and produce a
       warning message if used.

       cancel(1), lp(1), lpadmin(8), lpoptions(1), lpq(1), lprm(1), lpstat(1),

       Copyright 2007-2013 by Apple Inc.

29 August 2008                                      CUPS                                              lpr(1)

Reporting Problems

The way to report a problem with this manual page depends on the type of problem:

Content errors
Report errors in the content of this documentation with the feedback links below.
Bug reports
Report bugs in the functionality of the described tool or API through Bug Reporter.
Formatting problems
Report formatting mistakes in the online version of these pages with the feedback links below.