lp, cancel - Sends or cancels a printing request
lp [-cmsw] [-A options] [-o option] [-d printer] [-n
copies] [-t title] [file...]
cancel [request_ID...] printer...
cancel request_ID... [printer...]
Interfaces documented on this reference page conform to
industry standards as follows:
Refer to the standards(5) reference page for more information
about industry standards and associated tags.
Options for the lp command can appear in any order and can
be mixed with filenames.
The cancel command has no options. [Tru64 UNIX] Specifies
one or more country-specific options. See lpr(1) for
details about these options. Makes copies of the files to
be printed immediately when lp is invoked. Normally,
files are not copied, but are linked whenever possible.
If the -c option is not given, be careful not to remove
any of the files before the request is finished printing.
Note also 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, are reflected in the printed output.
Selects printer as the device to do the printing (also
known as the printing destination). Under certain conditions
(printer unavailability, file space limitations, and
so on), requests for specific destinations cannot be
accepted. By default, printer is taken from the LPDEST
environment variable if it is set. Otherwise, the PRINTER
environment variable or a default destination, if one
exists, for the system is used. Destination names vary
between systems. (See the lpq(1) and lpstat(1) reference
pages.) Sends mail (see the mailx(1) reference page)
after the files are printed. By default, no mail is sent
upon normal completion of the print request. Prints number
copies (default of 1). This option is recognized as
valid option by the command-line parser, but is not supported
on a Tru64 UNIX system. On other systems, multiple
-o options can be used to specify printer-dependent or
class-dependent options. Suppresses messages from lp,
such as "request id is ...". Prints title on the banner
page of the output. Functions like -m (for compatibility
Specifies one or more files to be printed. Cancel the
request with the request ID. Cancel all requests made by
you with that printer as the destination.
The lp command sends the specified files and associated
information (collectively called a request) to a line
printer for printing. The cancel command cancels printing
The lp command associates a unique ID with each request
and prints it on the standard output. If you do not specify
a file, or specify a - (dash) in place of a file, lp
accepts standard input at this point in the list of files.
The cancel command cancels printer requests made by the lp
or lpr command (see lpr(1)). You can specify either
request_ID, to cancel the request with that request ID, or
printer, to cancel all requests made by you with that
printer as the destination. (If you are operating with
superuser authority, all requests to that printer are canceled,
including those of other users.) A specified
request is canceled even if it is currently printing, and
the printer is freed to print the next available request.
The cancel command is marked LEGACY in XCU Issue 5.
You can also use the request ID to find the status of the
request. (See the lpq(1) and lpstat(1) reference pages.)
The following exit values are returned by both the cancel
and lp commands: Successful completion. An error
ENVIRONMENT VARIABLES [Toc] [Back]
The following environment variables affect the execution
of lp and cancel: Provides a default value for the internationalization
variables that are unset or null. If LANG
is unset or null, the corresponding value from the default
locale is used. If any of the internationalization variables
contain an invalid setting, the utility behaves as
if none of the variables had been defined. If set to a
non-empty string value, overrides the values of all the
other internationalization variables. Determines the
locale for the interpretation of sequences of bytes of
text data as characters (for example, single-byte as
opposed to multi-byte characters in arguments). Determines
the locale for the format and contents of diagnostic
messages written to standard error. Determines the format
of date and time strings displayed in the banner. Determines
the output device destination if the -d option is
not used with the lp command. Determines the location of
message catalogues for the processing of LC_MESSAGES.
Determines the output device destination if the -d option
is not used with lp command and the LPDEST environment
variable is not set.
Printer description file Spool directories Daemon control
files Data files specified in cf files Temporary copies of
cf files Minimum free space to leave Line printer devices
Socket for local requests
Commands: lpc(8), lpd(8), lpq(1), lpr(1), lprm(1),
[ Back ]