LPR(1B) BSD Compatibility Package Commands LPR(1B)


NAME


lpr - submit print requests

SYNOPSIS


/usr/ucb/lpr [-P destination] [-# number] [-C class]
[-J job] [-T title] [-i [indent]]
[-1 | -2 | -3 | -4 font] [-w cols] [-m] [-h] [-s]
[-filter_option] [file]...


DESCRIPTION


The lpr utility submits print requests to a destination. lpr prints files
(file) and associated information, collectively called a print request.
If file is not specified, lpr assumes the standard input.


The print client commands locate destination information using the
"printers" database in the name service switch. See nsswitch.conf(4),
printers(4), and printers.conf(4) for details.


Print requests with more than 52 files specified is truncated to 52 files
when the BSD print protocol is used for job submission.

OPTIONS


The following options are supported:

-C class

Prints class as the job classification on the banner page of the
output. Enclose class in double quotes if it contains blanks. If
class is not specified, the name of the system (as returned by
hostname) is printed as the job classification. See hostname(1).


-h

Suppresses printing of the banner page of the output.


-i indent

Indents the output a specific number of SPACE characters. Use indent
to indicate the number of SPACE characters to be indented. Specify
indent as a positive integer. If the optional argument to indent is
not specified, then eight SPACE characters is the default. The -i
option is ignored unless it is specified with the -p filter option.


-J job

Prints job as the job name on the banner page of the output. Enclose
job in double quotes if it contains blanks. If job is not specified,
file (or in the case of multiple files, the first file specified on
the command line) is printed as the job name on the banner page of
the output.


-m

Sends mail after file has printed. See mail(1). By default, no mail
is sent upon normal completion of a print request.


-P destination

Prints file on a specific printer or class of printers (see
lpadmin(1M)). Specify destination using atomic, URI-style
(scheme://endpoint), or POSIX-style (server:destination) names. See
printers.conf(4) for information regarding destination names.


-s

Prints files by reference rather than copying them. This means that
files should not be modified or removed until they have completed
printing. This option only prevents copying of files when the print
queue is on the local machine and the files are specified on the
command line.


-T title

Prints a title on the page header of the output. Enclose title in
double quotes if it contains blanks. The -T option is ignored unless
it is specified with the -p filter option.


-w cols

Prints file with pages of a specific width. cols indicates the number
of columns wide. The -w option is ignored unless it is specified with
the -p filter option.


-1|-2|-3|-4 font

Mounts the specified font in the font position 1, 2, 3, or 4. Specify
font as a valid font name.


- filter_option

Notifies the print spooler that file is not a standard text file.
Enables the spooling daemon to use the appropriate filters to print
file.

filter_options offer a standard user interface. All filter options
might not be available for, or applicable to, all printers.

Specify filter_option as a single character.

If filter_option is not specified and the printer can interpret
PostScript(R), inserting `%!' as the first two characters of file
causes file to be interpreted as PostScript.

The following filter options are supported:

c
file contains data produced by cifplot.


d
file contains tex data in DVI format from Stanford.


f
Interprets the first character of each line as a standard
FORTRAN carriage control character.


g
file contains standard plot data produced by plot(1B) routines.


l
Print control characters and suppress page breaks.


n
file contains ditroff data from device independent troff.


p
Use pr to format the files. See pr(1).


t
file contains troff (cat phototypesetter) binary data.


v
file contains a raster image. printer must support an
appropriate imaging model such as PostScript in order to print
the image.


-# number

Prints a specific number of copies. Specify number as a positive
integer. The default for number is 1.


OPERANDS


The following operand is supported:

file
The name of the file to be printed. Specify file as a pathname.
If file is not specified, lpr uses the standard input.


USAGE


See largefile(5) for the description of the behavior of lpr when
encountering files greater than or equal to 2 Gbyte ( 2^31 bytes).

EXIT STATUS


The following exit values are returned:

0
Successful completion.


non-zero
An error occurred.


FILES


/etc/printers.conf
System printer configuration database


$HOME/.printers
User-configurable printer database


ou=printers
LDAP version of /etc/printers.conf


printers.conf.byname
NIS version of /etc/printers.conf


ATTRIBUTES


See attributes(5) for descriptions of the following attributes:


+--------------------+--------------------+
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+--------------------+--------------------+
|Interface Stability | Standard |
+--------------------+--------------------+
|CSI | Enabled. See NOTES |
+--------------------+--------------------+

SEE ALSO


hostname(1), lp(1), lpc(1B), lpq(1B), lprm(1B), lpstat(1), mail(1),
plot(1B), pr(1), troff(1), lpadmin(1M), nsswitch.conf(4), printers(4),
printers.conf(4), attributes(5), largefile(5), standards(5)

DIAGNOSTICS


lpr: destination |: unknown destination

destination was not found in the LP configuration database. Usually
this is a typing mistake; however, it can indicate that the
destination does not exist on the system. Use lpstat -p to display
information about the status of the print service.


NOTES


lpr is CSI-enabled except for the printer name.


Print jobs are assumed to contain one type of data. That type of data is
either specified on the command line or autodetected (simple, PostScript)
based on the contents of the first file in the job.


When IPP is in use, the user is prompted for a passphrase if the remote
print service is configured to require authentication.


February 25, 2017 LPR(1B)