lprm(1B)					     SunOS/BSD Compatibility Package 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.

       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 superuser executes lprm and specifies the user  oper-
       and, 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, URI-style (scheme://endpoint), or POSIX-style (server:destination) names. See printers.conf(4) for informa-
			 tion regarding the naming naming conventions for destination names.

       -		 If a user specifies this option,  removes all print requests owned by that user. If a superuser  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.

       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).

       user	     Removes print requests associated with  a specific user. Specify user as a valid user name. This option can only be used by a
		     superuser.

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

       $HOME/.printers	       User-configurable printer database

       /etc/printers.conf      System printer configuration database

       printers.conf.byname    NIS version of /etc/printers.conf

       printers.org_dir        NIS+ version of /etc/printers.conf

       ou=printers	       LDAP version of /etc/printers.conf

ATTRIBUTES

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

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |Availability		     |SUNWlpr-cmds		   |
       +-----------------------------+-----------------------------+
       |Interface Stability	     |Standard			   |
       +-----------------------------+-----------------------------+

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 superuser 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. Superusers can remove print requests on the host from  which	the  print
       request was submitted. Superusers can also remove print requests from the print server.

       Some  print  servers send cancelation notification to job owners when their print jobs have been cancelled. This notification usually comes
       in the form of an email message. Cancelation notices cannot be disabled on a Solaris server.

NOTES

       When IPP is in use, the user is prompted for a passphrase if the remote print service is configured to require authentication.

SunOS 5.11							    2 Jun 2006								  lprm(1B)