LP(1) DOMAIN/IX SYS5 LP(1)
NAME
lp, cancel - send/cancel requests to an lp line printer
USAGE
lp [-c] [-ddest] [-m] [-nnumber] [-ooption] [-s] [-ttitle]
[-w] file(s)
cancel ids | printers
DESCRIPTION
Lp arranges for the named file(s) and associated information
(collectively called a request) to be printed on a line
printer. If no file(s) are mentioned, the standard input is
assumed. A dash (-) used a filename indicates the standard
input; you may supply this character on the command line
along with named file(s). The order in which file(s) 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 may use this id to cancel the
request, or you may use it to find the status (see
lpstat(1)) of the request.
OPTIONS
The following options to lp may appear in any order and may
be intermixed with filenames:
-c Make copies of the file(s) to be printed immedi-
ately when lp is invoked. Normally, file(s) will
not be copied, but will be linked. If the -c
option is not given, then you should be careful
not to remove any of the file(s) before the
request has been printed completely. Without the
-c option, any changes made to the filename(s)
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
where printing will take place. If dest is a
printer, then the request will be printed only on
that specific printer. If dest is a class of
printers, then the request will be printed on the
first available printer that is a member of the
class. Under certain conditions (printer una-
vailabile, 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. Destina-
tion names vary between systems (see lpstat(1)).
Printed 12/4/86 LP-1
LP(1) DOMAIN/IX SYS5 LP(1)
-m Send mail after the file(s) have been printed (see
mail(1)). By default, no mail is sent.
-nnumber Print number copies (default = 1) of the output.
-ooption Specify a printer-dependent or class-dependent
option. 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
file(s) have been printed. If the user is not
logged in, then send mail.
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 of printer names, use lpstat(1). Specifying a
request id cancels the associated request, even if it is
currently printing. Specifying a printer cancels the
request that is currently printing on that printer. In
either case, the cancellation of a request that is currently
printing frees the printer to print its next available
request.
FILES
/usr/spool/lp/* spooling directories
RELATED INFORMATION
enable(1)
lpstat(1)
mail(1)
accept(1M)
lpadmin(1M)
lpsched(1M)
LP-2 Printed 12/4/86