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, collec-
tively 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 will be
truncated to 52 files. lpr displays a warning message.
OPTIONS
The following options are supported:
- P destination
Prints file on a specific printer or class of
printers(see lpadmin(1M)). Specify destination using
atomic, POSIX-style (server:destination), or Federated
Naming Service (FNS) (.../service/printer/...) names.
See printers.conf(4) for information regarding the
naming conventions for atomic and FNS names, and stan-
dards(5) for information regarding POSIX.
-# number
Prints a specific number of copies. Specify number as
a positive integer. The default for number is 1.
-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).
-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.
-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.
-i indent
Indents the output a specific number of SPACE charac-
ters. Use indent to indicate the number of SPACE char-
acters 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.
-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.
-w cols
Prints file with pages of a specific width. cols indi-
cates the number of columns wide. The -w option is
ignored unless it is specified with the -p filter
option.
-m Sends mail after file has printed. See mail(1). By
default, no mail is sent upon normal completion of a
print request.
-h Suppresses printing of the banner page of the output.
-s Uses full pathnames (as opposed to symbolic links) to
file rather than trying to copy them. This means file
should not be modified or removed until it has com-
pleted printing. Option -s only prevents copies of
local files from being made on the local machine.
Option -s only works with specified files. If the lpr
command is at the end of a pipeline, file is copied to
the spool.
- 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 may 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 PostScriptO, inserting `%!' as the first two
characters of file causes file to be interpreted as
PostScript.
The following filter options are supported:
p Use pr to format the files. See pr(1).
l Print control characters and suppress page breaks.
t file contains troff (cat phototypesetter) binary data.
n file contains ditroff data from device independent
troff.
d file contains tex data in DVI format from Stanford.
g file contains standard plot data produced by plot(1B)
routines.
v file contains a raster image. printer must support an
appropriate imaging model such as PostScript in order
to print the image.
c file contains data produced by cifplot.
f Interprets the first character of each line as a stan-
dard FORTRAN carriage control character.
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
**31bytes).
EXIT STATUS
The following exit values are returned:
0 Successful completion.
non-zero
An error occurred.
FILES
/var/spool/print/.seq
File containing the sequence numbers for job ID
assignment.
/var/spool/print/[cd]f*
Spooling directories and files.
ATTRIBUTES
See attributes(5) for descriptions of the following attri-
butes:
____________________________________________________________
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
|_____________________________|_____________________________|
| Availability | SUNWscplp |
|_____________________________|_____________________________|
| 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), attri-
butes(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 may 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.
Man(1) output converted with
man2html