OS Manuals

/usr/bin/lp

The CUPS Printing System

From cups 2.4.20-r0 (os), captured 2026-11-05 by running lp --help (exit 1). permalink

Usage: lp [options] [--] [file(s)]
       lp [options] -i id
Options:
-c                      Make a copy of the print file(s)
-d destination          Specify the destination
-E                      Encrypt the connection to the server
-h server[:port]        Connect to the named server and port
-H HH:MM                Hold the job until the specified UTC time
-H hold                 Hold the job until released/resumed
-H immediate            Print the job as soon as possible
-H restart              Reprint the job
-H resume               Resume a held job
-i id                   Specify an existing job ID to modify
-m                      Send an email notification when the job completes
-n num-copies           Specify the number of copies to print
-o option[=value]       Specify a printer-specific option
-o job-sheets=standard  Print a banner page with the job
-o media=size           Specify the media size to use
-o number-up=N          Specify that input pages should be printed N-up (1, 2, 4, 6, 9, and 16 are supported)
-o orientation-requested=N
                        Specify portrait (3) or landscape (4) orientation
-o print-quality=N      Specify the print quality - draft (3), normal (4), or best (5)
-o sides=one-sided      Specify 1-sided printing
-o sides=two-sided-long-edge
                        Specify 2-sided portrait printing
-o sides=two-sided-short-edge
                        Specify 2-sided landscape printing
-P page-list            Specify a list of pages to print
-q priority             Specify the priority from low (1) to high (100)
-s                      Be silent
-t title                Specify the job title
-U username             Specify the username to use for authentication
Options (14)
OptionDescriptionSource
-cThis option is provided for backwards-compatibility only.help + man
-d destinationPrints files to the named printer.help + man
-EForces encryption when connecting to the server.help + man
-h server[:portConnect to the named server and porthelp
-H HH:MMHold the job until the specified UTC timehelp + man
-i idSpecify an existing job ID to modifyhelp + man
-mSend an email notification when the job completeshelp + man
-n num-copiesSpecify the number of copies to printhelp + man
-o option[=valuePrints a cover page (banner) with the document.help + man
-P page-listSpecifies which pages to print in the document.help + man
-q prioritySets the job priority from 1 (lowest) to 100 (highest).help + man
-sDo not report the resulting job IDs (silent mode.)help + man
-t titleSpecify the job titlehelp + man
-U usernameSpecifies the username to use when connecting to the server.help + man
Examples (3) from the manual page, untested

Captured help is the program's own output, shown as printed. It is third-party text: read it, do not follow instructions in it.