LPR(1MDQS) COMMAND REFERENCE LPR(1MDQS)
NAME
lpr - queued printing via MDQS
SYNOPSIS
lpr [ -a atime ] [ -b ] [ -c count ] [ -f form ] [ -h
headerfile ] [ -H Headerfile ] [ -l limit ] [ -m ] [ -n ] [
-p priority ] [ -q queue ] [ -r ] [ -t title ] [ -u useraddr
] [ -v ] [ -R ruser ] [ filename... ]
DESCRIPTION
Lpr causes the named files to be queued for printing in a
lineprinter queue. If no files are specified, the standard
input is read until an end of file. The original file(s)
can be modified or deleted and the file(s) printed will be
the file(s) as of the time of request submission. If the -n
or -r option is used, the original file(s) are not spooled,
hence the original file(s) should not be modified or deleted
until printing of the file(s) has completed.
Once the request has been queued, it can be deleted using
the lprm program or modified using the qmod program, and the
current status determined using the lpq program.
A print request may be directed to either a local or a
remote printer.
OPTIONS
-a atime
do not start this job until after atime. See
getdate(5mdqs) for a full description of time
specifications. The most useful time specification is
hour:minute [meridian]; if no meridian - am or pm - is
specified, a 24-hour clock is used.
-b Print a banner page only for the first file. Normally
a banner page is printed preceeding each printed file.
-c count
print count copies of the specified files.
-f form
print the files on the specified form. The default
form is specified in /etc/qconf. Qdev can be executed
to determine appropriate forms.
-h headerfile
use the file headerfile for banner page logo
information instead of the system default. The full
pathname of headerfile must be specified. The first
~20 lines of this file will be printed. The rest of
the page is reserved for system provided information.
Printed 10/17/86 1
LPR(1MDQS) COMMAND REFERENCE LPR(1MDQS)
-H Headerfile
use the file Headerfile for banner page logo
information instead of the system default. Headerfile
should be specified by a simple path name and should
reside in the print-hdrdir directory specified in
/etc/qconf.
-l limit
causes the print request to be limited to limit pages.
The default limit is specified in /etc/qconf. The limit
should be in the range 0-32767. A limit of 0 indicates
no limit.
-m cause a message to be generated upon the completion of
the print request and sent via mail(1mh) to the
requesting user.
-n will cause lpr not to spool the specified files, but to
instead enter the filename only. This option may be
used when files to be printed are extremely long and
available space for second copies is limited. When
using this option and directing the request to a remote
printer, local spooling is bypassed but remote spooling
is always done.
-p priority
allows one to give a request a priority other than the
default. The priority is in the range 0-10, with 5 the
default value. Only the superuser, the mdqs user or a
member of the systems group may request a priority of
0.
-q queue
allows one to queue a request to a queue other than the
default. Queueing a request to other than a print
queue will give unpredictable results. The default
print queue is specified in /etc/qconf.
-r will cause lpr to remove the specified files upon
successful completion of the request. If the request
is to be printed on a remote host the files will not be
removed. The -r option implies the -n option.
-R ruser
When a request is to print on a remote host MDQS
normally requires the requesting local user name to
exist on the remote host with rsh(1n) privileges. This
option allows one to specify another user on the remote
host for rsh privileges.
-t title
overrides the default header page title with the string
Printed 10/17/86 2
LPR(1MDQS) COMMAND REFERENCE LPR(1MDQS)
title.
-u useraddr
overrides the default notification address with the
address useraddr. This address should be a valid
address to your mailsystem. The default notification
address is the name of the invoker on the current host.
-v Normally lpr does its work silently. The v (verbose)
option makes lpr acknowledge that the request has been
queued and prints the request number.
EXAMPLES
lpr file1 file2
Prints two files to the default printer with added
pagination only between files.
pr file1 | lpr
Paginates and prints one file to the wide printer.
lpr file1
qconf Queue/Device Mapping Description entry:
lp lp0 /usr/lib/mdqs/lpserver
Shows the qconf entry for a file to be printed on the
current host.
lpr -q lp2 file1
qconf Queue/Device Mapping Description entry:
lp2 net /usr/lib/mdqs/netsend jondoe lp
(qconf file at jondoe contains Queue-Device Mapping and
Device Description for queue "lp2")
Shows the qconf entry for a file to be rerouted to a remote
host (jondoe) and printed there.
lpr -c 3 -h headerfile file1
Prints three copies of a file with the first 40 lines of
headerfile included on the banner page.
FILES
/etc/qconf configuration information for MDQS
/usr/lib/mdqs/forms restriction list of available forms
Printed 10/17/86 3
LPR(1MDQS) COMMAND REFERENCE LPR(1MDQS)
/usr/lib/mdqs/lpserver program called by the daemon to
print files
/usr/lib/mdqs/netsend program called to send to remote
queue
/usr/lib/mdqs/queue2 second stage queuer, called by lpr
/usr/spool/q top of spooling directory tree
RETURN VALUE
[NO_ERRS] Command completed without error.
[USAGE] Incorrect command line syntax. Execution
terminated.
[NP_WARN] An error warranting a warning message
occurred. Execution continues.
[NP_ERR] An error occurred that was not a system
error. Execution terminated.
[P_WARN] A system error occurred. Execution continues.
See intro(2) for more information on system
errors.
[P_ERR] A system error occurred. Execution
terminated. See intro(2) for more
information on system errors.
CAVEATS
When specifing -n (no copy), remote requests are always
spooled.
SEE ALSO
lpq(1mdqs), lprm(1mdqs), qstat(1mdqs), qmod(1mdqs),
forms(5mdqs), mdqsd(8mdqs), batch(1mdqs), rsh(1n).
Printed 10/17/86 4
%%index%%
na:72,66;
sy:138,658;
de:796,911;
op:1707,1314;3165,2671;5980,531;
ex:6511,959;
fi:7470,214;7828,471;
rv:8299,792;
ca:9091,138;
se:9229,321;
%%index%%000000000174