SunOS/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]
[-filteroption] [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 trun-
cated 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 charac-
ters. Use indent to indicate the number of SPACE charac-
ters 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
SunOS 5.11 Last change: 2 Jun 2006 1
SunOS/BSD Compatibility Package Commands lpr(1B)
-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 indi-
cates the number of columns wide. The -w option is
ignored unless it is specified with the -p filter
option.
SunOS 5.11 Last change: 2 Jun 2006 2
SunOS/BSD Compatibility Package Commands lpr(1B)
-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.
- filteroption
Notifies the print spooler that file is not a standard
text file. Enables the spooling daemon to use the
appropriate filters to print file.
filteroptions offer a standard user interface. All
filter options might not be available for, or applicable
to, all printers.
Specify filteroption as a single character.
If filteroption 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:
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.
SunOS 5.11 Last change: 2 Jun 2006 3
SunOS/BSD Compatibility Package Commands lpr(1B)
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 data-
base
$HOME/.printers User-configurable printer database
ou=printers LDAP version of /etc/printers.conf
printers.conf.byname NIS version of /etc/printers.conf
printers.orgdir NIS] version of /etc/printers.conf
SunOS 5.11 Last change: 2 Jun 2006 4
SunOS/BSD Compatibility Package Commands lpr(1B)
ATRIBUTES
See attributes(5) for descriptions of the following attri-
butes:
ATRIBUTE TYPE ATRIBUTE VALUE
Availability SUNWlprcmds
Interface Stabilitly 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), attri-
butes(5), largefile(5), standards(5)
DIAGNOSTICS
lpr: destination : unknown destination
destination was not found in the LP configuration data-
base. Usually this is a typing mistake; however, it can
indicate that the destination does not exist on the sys-
tem. 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 IP is in use, the user is prompted for a passphrase if
the remote print service is configured to require authenti-
cation.
SunOS 5.11 Last change: 2 Jun 2006 5
|
