Man Pages (1), (1B): User Commands

lprm(1B)

NAME

lprm- Remove print requests from the print queue

SYNOPSIS

/usr/ucb/lprm

-P

destination

request-ID

user

DESCRIPTION

The lprm utility removes print requests (request-ID) from the print queue.

If invoked without arguments, lprm deletes the user's current print request. lprm reports the name of the file associated with print requests that it removes, but is silent if there are no applicable print requests to remove.

To remove a job belonging to another user, the user must have the cancel any print job authorization. lprm then removes all jobs that belong to the specified user.

You can remove a specific job by supplying its job number (request-ID) as an argument. To find the job number, run lpq(1B). See EXAMPLES.

lprm can normally cancel only requests that are at its own sensitivity label. To cancel jobs at other SLs, the user must have the bypass system mac check authorization.

The print client commands locate destination information in a very specific order. See printers(4) and printers.conf(4) for details.

OPTIONS

The following options are supported.

-P destination: The name of the printer or class of printers (see lpadmin(1M)) from which to remove print requests. Specify destination using atomic, POSIX-style (server:destination), or Federated Naming Service (FNS) (.../service/printer/...) names. See printers.conf(4) for information regarding the naming conventions for atomic and FNS names, and standards(5) for information regarding POSIX.
-: If a user specifies this option, lprm removes all print requests owned by that user. If invoked by a user with the administer printing authorization, it removes all requests in the print queue. Job ownership is determined by the user's login name and host name on the machine from which lprm was executed. See NOTES.

OPERANDS

The following operands are supported.

user: Removes print requests associated with a specific user. Specify user as a valid user name. Use of this operand requires the administer printing authorization.
request-ID: Removes a specific print request. Specify request-ID as the job number (Job) associated with a print request and reported by lpq. See lpq(1B).

EXAMPLES

Example 1 Find and Remove a Print Job

The following example finds the job number on the printer killtree using lpq, then removes the job:

admin$ lpq -P killtree
killtree is ready and printing

`Rank`	`Owner`	`Job`	`Files`	`Total Size`
`active`	`wendy`	`385`	`standard input`	`35501 bytes`

admin$ lprm -P killtree 385

EXIT STATUS

The following exit values are returned:

0: Successful completion.
>0: An error occurred.

FILES

/var/spool/print/[cd]f*: Spooling directories and files.

ATTRIBUTES

See attributes(5) for descriptions of the following attributes:

ATTRIBUTE TYPE	ATTRIBUTE VALUE
Availability	SUNWscplp

SUMMARY OF TRUSTED SOLARIS CHANGES

For lprm to cancel other users' requests, requires that the user have the cancel any print job authorization. For lprm to cancel requests at other sensitivity labels requires that the user have the bypass system mac check authorization.

Trusted Solaris 7 Reference Manual

lp(1), lpstat(1), lpc(1B), lpq(1B), lpr(1B), lpadmin(1M), lpsched(1M)

SunOS 5.7 Reference Manual

printers(4), printers.conf(4), attributes(5), standards(5)

DIAGNOSTICS

lprm: printer: unknown printer: The printer was not found in the System V LP database. Usually this is a typing mistake; however, it may indicate that the printer does not exist on the system. Use `lpstat -p' (see lpstat(1)) or `lpc status' (see lpc(1B)) to discover the reason.
lprm: error on opening queue to spooler: The connection to lpsched on the local machine failed. This usually means the printer server started at boot time has died or is hung. Check if the printer spooler daemon /usr/lib/lpsched is running.
lprm: Can't send message to the LP print service
lprm: Can't receive message from the LP print service: These indicate that the LP print service has been stopped. Get help from the system administrator.
lprm: Received unexpected message from the LP print service: It is likely there is an error in this software. Get help from system administrator.
lprm: Can't cancel request: You are not allowed to remove another's request.

NOTES

An active job may be incorrectly identified for removal by an lprm command issued with no arguments. During the interval between an lpq command and the execution of lprm, the next job in queue may have become active; you can remove that job unintentionally if you own it. To avoid this, supply lprm with the job number as an argument.

Trusted Solaris 7 Last Revised 05 Nov 1999