lp(1)
_________________________________________________________________
lp, cancel Command
send/cancel requests to an LP line printer
_________________________________________________________________
SYNTAX
lp [-c] [-ddest] [-m] [-nnumber] [-ooption] [-s] [-ttitle] [-w]
files
cancel [ids] [printers]
DESCRIPTION
Lp arranges for the named files and associated information
(collectively called a request) to be printed by a line printer.
If no file names are mentioned, the standard input is assumed.
The file name - stands for the standard input and may be supplied
on the command line in conjunction with named files. The order
in which files appear is the same order in which they will be
printed.
Lp associates a unique ID with each request and prints it on the
standard output. You can use this ID later to cancel (see
cancel) or find the status (see lpstat(1)) of the request.
The following options to lp may appear in any order and may be
intermixed with file names:
-c Copy the files to be printed as soon as lp is invoked.
Normally, files are linked, not copied. If the -c
option is not given, do not remove any of the files
before the request has been printed in its entirety.
Also note that in the absence of the -c option, any
changes made to the named files after the request is
made but before it is printed will be reflected in the
printed output.
-ddest Choose dest as the printer or class of printers that is
to do the printing. If dest is a printer, the request
will be printed only on that specific printer. If dest
is a class of printers, the request will be printed on
the first available printer that is a member of the
class. Under certain conditions (printer
unavailability, file space limitation, etc.), requests
for specific destinations may not be accepted (see
accept(1M) and lpstat(1)). By default, dest is taken
from the environment variable LPDEST (if it is set).
Otherwise, a default destination (if one exists) for
the computer system is used. Destination names vary
DG/UX 4.00 Page 1
Licensed material--property of copyright holder(s)
lp(1)
between systems (see lpstat(1)).
-m Send mail (see mail(1)) after the files have been
printed. By default, no mail is sent upon normal
completion of the print request.
-nnumber Print number copies (default of 1) of the output.
-ooption Specify printer-dependent or class-dependent options.
Several such options may be collected by specifying the
-o keyletter more than once. For more information
about what is valid for options, see "Models" in
lpadmin(1M).
-s Suppress messages from lp(1) such as "request id is
...".
-ttitle Print title on the banner page of the output.
-w Write a message on the user's terminal after the files
have been printed. If the user is not logged in, mail
will be sent instead.
Cancel cancels line printer requests that were made by the lp(1)
command. The command line arguments may be either request ids
(as returned by lp(1)) or printer names (for a complete list, use
lpstat(1)). Specifying a request id cancels the associated
request even if it is currently printing. Specifying a printer
cancels the request which is currently printing on that printer.
In either case, cancelling a current request frees the printer to
print its next available request.
_________________________________________________________________
EXAMPLES
$ lp textfile
request id is lpt-1762 (1 file)
$
Queues a request for "textfile" to be printed on the sytstems
default line printer. lp assigns a unique ID to each request and
prints it on the standard output. This ID can be used to later
cancel the request or find the status of the print request.
$ lp -n3 -tTITLE -w textfile
request id is lpt-1763 (1 file)
$
Queues a request for "textfile" to be printed on the system's
DG/UX 4.00 Page 2
Licensed material--property of copyright holder(s)
lp(1)
default line printer. The options specify print 3 copies, print
"TITLE" on the banner page and notify (write to) you when the
printing request is completed. If you are not logged on, the
notification will be mailed to you.
$ cancel lpt-1763
Cancels the printer request with ID "lpt-1763".
_________________________________________________________________
FILES
/usr/spool/lp/*
SEE ALSO
enable(1), lpstat(1), mail(1).
accept(1M), lpadmin(1M), lpsched(1M) in the System Manager's
Reference for the DG/UX System
DG/UX 4.00 Page 3
Licensed material--property of copyright holder(s)