Sun Microsystems, Inc.
spacerspacer
spacer   www.sun.com docs.sun.com | | |  
spacer
black dot
   
A   B   C   D   E   F   G   H   I   J   K   L   M   N   O   P   Q   R   S   T   U   V   W   X   Y   Z
    
 
SunOS/BSD Compatibility Package Commandslprm(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.

Without arguments, lprm deletes the current print request. lprm reports the name of the file associated with print requests that it removes. lprm is silent if there are no applicable print requests to remove.

Users can only remove print requests associated with their user name. See NOTES. If a super-user executes lprm and specifies the user operand, lprm removes all print requests belonging to the specified user.

The print client commands locate destination information using the "printers" database in the name service switch. See nsswitch.conf(4), 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, removes all print requests owned by that user. If a super-user specifies this option, 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 lpr 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. This option can only be used by a super-user.
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. Removing a print request
 

The following example removes request-ID 385 from destination killtree:
 
example% lprm -P killtree 385

EXIT STATUS

 

The following exit values are returned:

0
Successful completion.
non-zero
An error occurred.

FILES

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

ATTRIBUTES

 

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

ATTRIBUTE TYPEATTRIBUTE VALUE
AvailabilitySUNWscplp

SEE ALSO

 

lp(1), lpc(1B), lpq(1B), lpr(1B), lpstat(1), lpadmin(1M), nsswitch.conf(4), printers(4), printers.conf(4), attributes(5), standards(5)

NOTES

 

Users can only remove print requests associated with their user name. By default, users can only remove print requests on the host from which the print request was submitted. If a super-user has set user-equivalence=true in /etc/printers.conf on the print server, users can remove print requests associated with their user name on any host. Super-users can remove print requests on the host from which the print request was submitted. Super-users can also remove print requests from the print server.


SunOS 5.9Go To TopLast Changed 10 Nov 1999

 
      
      
Copyright 2002 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms.