Skip site navigation (1)Skip section navigation (2)

FreeBSD Man Pages

Man Page or Keyword Search:
Man Architecture
Apropos Keyword Search (all sections) Output format
home | help
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 super-user 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, POSIX-style  (server:destination),	 or  Federated	Naming
	     Service   (FNS)   (.../service/printer/...)   names.  See	print-
	     ers.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	deter-
	     mined  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	TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |Availability		     |SUNWscplp			   |
       +-----------------------------+-----------------------------+

SEE ALSO
       lp(1),	lpc(1B),   lpq(1B),   lpr(1B),	lpstat(1),  lpadmin(1M),  nss-
       witch.conf(4),  printers(4),  printers.conf(4),	attributes(5),	 stan-
       dards(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-equiva-
       lence=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.9			  10 Nov 1999			      lprm(1B)

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | OPERANDS | EXAMPLES | EXIT STATUS | FILES | ATTRIBUTES | SEE ALSO | NOTES

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=lprm&sektion=1b&manpath=SunOS+5.9>

home | help