lprm(1B)																  lprm(1B)

NAME

       lprm - remove print requests from the print queue

SYNOPSIS

       /usr/ucb/lprm [-P destination] [-] [ request-ID...] [user...]

       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 . If a superuser 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.

       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  or POSIX-style (server:destination) names. See printers.conf(4) for information regarding the naming conven-
		       tions for atomic names and standards(5) for information regarding POSIX.

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

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

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

       Example 1: Removing a print request

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

       example% lprm -P killtree 385

       The following exit values are returned:

       0	       Successful completion.

       non-zero        An error occurred.

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

       /var/spool/lp/*		       LP print queue

       $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

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

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |Availability		     |SUNWscplp 		   |
       +-----------------------------+-----------------------------+

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

       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.

								    23 Feb 2005 							  lprm(1B)