lp(1) DG/UX 4.30 lp(1)
NAME
lp, cancel - send/cancel requests to an LP line printer
SYNOPSIS
lp [-c] [-d dest] [-m] [-n number] [-o option] [-s] [-t
title] [-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 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.
Licensed material--property of copyright holder(s) Page 1
lp(1) DG/UX 4.30 lp(1)
-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 sytems
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 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".
Licensed material--property of copyright holder(s) Page 2
lp(1) DG/UX 4.30 lp(1)
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
Licensed material--property of copyright holder(s) Page 3