lpr(1) lpr(1)
NAME
lpr - Sends files to spooling daemon for printing
SYNOPSIS
lpr [options] filename
OPTIONS
The lpr options -c, -d, -f, -g, -l, -n, -p, -t, and -v are used to notify
the line printer spooler that the files are not standard text files; there-
fore these options are mutually exclusive. The spooling daemon uses the
appropriate filters to print the data if you specify one of these options.
In an international environment, the lpr command needs locale information
to use the appropriate filter to print a text file. The -A option allows
you to specify, among other things, locales for text files and printers.
The lpr command supports the following options:
-Akeyword_list
Specifies one or more keywords and keyword assignments, separated by
spaces. For a list of valid keywords, refer to the "Country-Specific
Options" section.
-Busername
Enables you to specify a username which will appear as the banner on
the print job.
-c Assumes that the files contain data produced by the cifplot filter.
-C class
Specifies a print class as the request classification on the burst
page.
-d Assumes that files contain data from tex (DVI format from Stanford
University).
-f Interprets the first character of each line as a standard FORTRAN car-
riage control character.
-g Assumes that files contain standard plot data as produced by plot rou-
tines.
-h Suppresses the printing of the burst page.
-i[number]
Indents the output number spaces. If number is not given, the indenta-
tion is 8 spaces.
-Itray
Selects the input paper tray that supplies paper for the print job. The
tray name is printer dependent. The following list shows the valid
tray variable values for the printers that support the -I option:
ln05 and ln05r printers:
cassette, upper, or manual
ln06 and ln06r printers:
upper, envelope_feeder, lower, or manual
ln07 and ln07r printers:
upper, manual, lower, or cassette
ln08 and ln08r printers:
envelope_feeder, mmf, manual, upper, lower, or lcit
ln14 printer:
front, manual, upper, or lower
ln10ja (Japanese-specific) printers:
upper, lower, or manual
For more information on the input options, refer to the documentation
for your printer.
If you have one of the previously listed printers connected locally,
there are two additional forms of the -I option. You can specify the
option in the form -Itray_name, where the tray_name variable specifies
the name of a tray that is supported by the particular printer (for
example, -Ilettertray). You also can specify the option in the form
-In, where the n variable specifies an integer value. Refer to your
printer documentation for information on specifying valid tray selec-
tions.
-j Causes the request ID of the printer request to be displayed on stan-
dard output after it is entered in the print spooling queue.
-J name
Specifies the request name to appear on the burst page. Normally, the
lpr command uses the name of the first file.
-Ksides
Prints the job in a way specified by the sides variable. You can
specify sides as follows:
1 or one_sided or one_sided_simplex
Prints only on one side of the sheet.
2 or two_sided or two_sided_duplex
Prints on both sides of the sheet; the second side is reached by
flipping the sheet about its left edge, as in the binding of a
book.
tumble or two_sided_tumble
Prints on both sides of the sheet, but prints the opposite way up
on each side, so the second side can be read by flipping the sheet
along its top axis.
one_sided_duplex
Prints only on one side of the sheet, but retains the page layout
intended for two_sided_duplex printing. The layout refers to such
things as where the margins are and where the page numbers are.
one_sided_tumble
Prints only on one side of the paper, but retains the page layout
intended for tumble printing.
two_sided_simplex
Prints on two sides of the paper, but retains the page layout
intended for one_sided_simplex printing.
-l Prints control characters and suppresses page breaks.
-m Sends mail (see the mailx(1) reference page) when spooling is com-
pleted.
-n Assumes that files contain data output by the ditroff (device-
independent troff) command.
-Nnumber
Prints one or more pages on one sheet of paper. The printer automati-
cally adjusts to handle the number of pages printed on one sheet of
paper. The maximum that may be specified is 100 pages.
-on Selects the output tray where the printed job will be deposited. The n
variable specifies an integer value that depends on the printer. Refer
to your printer documentation to determine the correct values.
-Okeyword-list or -Okeyword
Specifies one or more keywords, among them keywords for page orienta-
tion, that may be print filter specific. The choices for page orienta-
tion are:
portrait
The printed output is parallel to the short side of the page.
landscape
The printed output is parallel to the long side of the page.
Currently, only the pcfof and wwpsof print filters support additional
keywords. See the description of the -O option in the wwpsof(8) refer-
ence page for the list of additional keywords and keyword assignments
you can specify.
The keyword-list argument is a comma-separated (no embedded spaces)
list of keywords, keyword assignments, or both. As an alternative to
listing multiple keywords after the same -O option, your command line
can include multiple instances of the -O option, each with a different
keyword or keyword assignment.
You cannot use the -O option to specify keywords other than portrait or
landscape if you are printing to a remote system that is running a
Tru64 UNIX version earlier than Version 5.0.
-p Formats the files using pr as a filter. If you specify the -T option
you must also specify the -p option.
-Pprinter
Specifies printer as the output device (print job destination). If you
do not specify the -P option, the default printer or the value of the
PRINTER environment variable is used.
-r Removes the file when spooling or printing is completed.
-s Uses symbolic links to print. Usually, files are copied to the spool-
ing directory, but the -s option uses symlink() to link data files,
rather than trying to copy them. This allows you to print large files.
If you specify the -s option, files should not be modified or removed
until they have been printed. Note that the -s option is disabled if
codeset conversion is performed.
-t Assumes that files contain data output by the troff (cat photo-
typesetter) command.
-T title
Specifies the title to be used by the pr command instead of the
filename. The -p option also must be specified, otherwise the -T
option is ignored.
-v Assumes that the files contain a raster image for devices like the Ben-
son Varian.
-wnumber
Prints the job using the page width in columns specified by the argu-
ment number. If this option is not specified, the page width is taken
from the /etc/printcap file.
-x Assumes the files do not require filtering before printing.
-znumber
Prints the job using the page length in lines specified by the argument
number. If this option is not specified, the page length is taken from
the /etc/printcap file.
-#number
Produces number copies of the output.
-1 font, -2 font, -3 font, -4 font
Mounts the specified font on font position 1, 2, 3, or 4, respectively.
DESCRIPTION
The lpr command uses the lpd spooling daemon to print files.
If you specify a hyphen (-) for a file name, the lpr command reads from
standard input; this can be used in conjunction with specified file names.
If you do not specify a particular printer with the -P option, the default
printer or the value of the PRINTER environment variable is used.
To check the status of a printer, use either the lpq or lpstat command. To
cancel printer requests, use the lprm or cancel command.
Country-Specific Options
The -A option allows you to specify information that is required to print
files in various native languages and also supports some country-specific
printers. You specify this information by using keywords, most of which
require value assignments. See i18n_printing(5) for a general description
of country-specific support and to determine which keywords may be required
for particular languages and printers.
The -A option keywords are supported by software installed by optional
worldwide support subsets. In other words, a country-specific keyword will
not work unless an associated country-specific software subset is
installed.
For the lpr command, the following keywords can be included through the -A
option:
flocale=locale_name
Specifies the locale for the source text file. If this is not a valid
locale name, it will be interpreted as a codeset name. Print filters
use a codeset name or the codeset part of a locale name to this locale
to validate the characters in the text. If the flocale keyword is not
set, the text is interpreted in the codeset of the current locale. The
flocale setting is particularly important for correct interpretation of
characters in multibyte codesets. Moreover, if the plocale keyword is
also set, the lpr command automatically converts characters from the
text file codeset to the printer codeset before printing the file. For
example, the following command converts a file created in a Traditional
Chinese locale from the Big 5 codeset to the DEC Hanyu codeset before
printing it:
% lpr -A "flocale=zh_TW.big5 plocale=zh_TW.dechanyu" big5.txt
If you are printing to a printer controlled by the wwpsof filter, it is
recommended that you set locale for a print job by using the -Olocale-
name option. See the wwpsof(8) reference page for more information.
plocale=locale_name
Specifies the locale for the printer. Some printers, like the LA380-
CB, are country specific and have builtin fonts encoded in a particular
codeset. For example, the builtin fonts for the LA380-CB printer are
encoded in DEC Hanzi. For these printers, the codeset part of the plo-
cale value should match the codeset (dechanzi) of the printer's builtin
fonts. Other printers are generic and suitable for use with files in a
variety of languages. For example, the DEClaser 5100, when used with
the wwpsof print filter, can handle fonts for different codesets. For
these printers, the plocale value should match the font used in the
text file. The following example prints a file encoded in DEC Hanyu by
using the Sung-Light-CNS11643 font, which supports DEC Hanyu charac-
ters:
% lpr -A"font=Sung-Light-CNS11643 plocale=zh_TW.dechanyu" \
dechanyu.txt
When the plocale value is inappropriate for the font codeset, printed
output is useless.
To determine printer locale for country-specific printers, refer to
i18n_printing(5). To find out which fonts are available for a particu-
lar locale, refer to the reference page for the corresponding codeset.
For example, if locale_name is zh_TW.dechanyu, see dechanyu(5) for a
list of appropriate fonts.
font=font_name
Specifies the outline font name for printing source text files on a
PostScript printer. For more information, refer to the entry for the
plocale keyword.
length=number_of_lines
Specifies the number of lines per page. When used with the -w option,
the length keyword can control the font size and orientation of the
printed output.
odldb=odl_database_path
Specifies the path of the software on-demand loading (SoftODL) database
files. The odldb keyword setting overrides the default path, which
specifies the systemwide SoftODL database. Therefore, users can set
odldb to specify private SoftODL databases. For example, the following
command directs lpr to use the SoftODL database in /usr/tmp:
% lpr -A "odldb=/usr/tmp/odl"
Refer to odl(5) for more information on SoftODL.
odlstyle=style-NxN
Specifies what SoftODL font style and size to use, for example normal-
24x24. If the odlstyle is not specified, the system default SoftODL
style and size is used. Refer to odl(5) for more information on Sof-
tODL.
spcom
Enables space-compensation mode for languages, such as Thai, that con-
tain nonspacing characters. Nonspacing characters can combine with
other characters for display and therefore do not occupy space. Many
of the existing tools for text alignment do not handle nonspacing char-
acters properly. If you want to print Thai output from such utilities,
you should enable space compensation mode to ensure proper text align-
ment in the printed file.
Space compensation is done line by line. The print filter keeps count
of the number of nonspacing characters found in a line. When two or
more consecutive spaces are encountered, the print filter inserts the
appropriate number of spaces, therefore compensating for spaces added
by the nonspacing characters.
Space-compensation mode is valid only for printing Thai characters.
tm Enables text morphing for Thai printing. Text morphing replaces some
characters with others to produce better output in desktop publishing
environments. Refer to Thai(5) for more details on text morphing. Text
morphing rules are proprietary. Therefore, text morphing is supported
only by Compaq Thai outline fonts and are available only for PostScript
printing.
onehalf
Specifies that Thai characters be printed on one and a half lines,
rather than on three lines, to produce more compressed and natural
looking output. The onehalf keyword works only with the thailpof print
filter. Refer to i18n_printing(5) for general information on text
morphing.
tacdata=tac_data_path
Specifies where the character code tables for the printer (thailpof
filter only) can be found. These tables are selected for use with the
yp value in the /etc/printcap file. The default path is
/usr/lbin/tac_data.
vprint
Specifies vertical printing mode for ideographic characters in the
Chinese, Japanese, and Korean languages. In vertical printing mode,
any single-byte characters that files contain are still printed in hor-
izontal printing mode.
If you are using a printer controlled by the wwpsof filter, it is
recommended that you use the -Ovprint option to specify vertical print-
ing. See the wwpsof(8) reference page for more information.
NOTES
1. Tru64 UNIX software does not include ditroff or troff. Therefore,
files suitable for use with the -n or -t options may not be available
on your system.
2. If you try to print too large a file, the file is truncated. The lpr
command does not print binary files. If a user other than the root
user prints a file and spooling is disabled, lpr will print a message
and will not put requests in the queue. If a connection to lpd on the
local machine cannot be made, lpr will indicate that the daemon cannot
be started.
3. Fonts for troff and text reside on the host with the printer.
Currently, it is not possible to use local font libraries. Tru64 UNIX
does not supply troff, so local font libraries for troff may not exist
on your system.
EXAMPLES
1. The following example prints three copies of the new.index.c,
print.index.c, and more.c files:
% lpr -#3 new.index.c print.index.c more.c
2. The following example prints three copies of the concatenated
new.index.c, print.index.c, and more.c files:
# cat new.index.c print.index.c more.c | lpr -#3
3. The following example prints Operations on the burst page instead of
the node name before printing the new.index.c file:
# lpr -C Operations new.index.c
FILES
/etc/passwd
User information
/etc/printcap
Printer description file
/usr/lbin/lpd
Line printer daemon
/usr/lbin/lpr
The executable image
/var/spool/*
Spool directories
/var/spool/*/cf*
Daemon control files
/var/spool/*/df*
Data files specified in cf files
/var/spool/*/tf*
Temporary copies of cf files
/usr/lbin/tac/tac_data/*
Character encoding tables for Thai
SEE ALSO
Commands: cancel(1), checknr(1), lp(1), lpc(8), lpd(8), lpq(1), lprm(1),
lpstat(1), mailx(1), neqn(1), nroff(1), pr(1), tbl(1), wwpsof(8)
Functions: symlink(2)
Others: dechanyu(5), i18n_intro(5), i18n_printing(5), l10n_intro(5),
odl(5), Thai(5)