unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (OSF1-V5.1-alpha)
Page:
Section:
Apropos / Subsearch:
optional field



lprm(1)								      lprm(1)



NAME

  lprm - Removes requests from the line	printer	spooling queue

SYNOPSIS

  lprm [-Pprinter] [-] [request_ID...] [user...]

  The lprm command removes one or more requests	from a printer's spool queue.

OPTIONS

  -   Removes all requests that	a user owns.  If specified by a	user with
      superuser	authority, the spool queue is emptied entirely.

  -Pprinter
      Specifies	the queue associated with a specific printer; otherwise, the
      default printer or the value of the PRINTER variable in the environment
      is used.

DESCRIPTION

  Because the spooling directory is protected from users, using	lprm is	nor-
  mally	the way	a user can remove a request.

  The lprm command without any arguments deletes the currently active request
  if it	is owned by the	user who invoked lprm.

  The -	flag removes all requests from the user	issuing	the command. If	a
  user who has superuser authority uses	this flag, the spool queue is emptied
  entirely.  The owner is determined by	the user's username and	hostname on
  the machine where the	lpr command was	invoked.

  You can remove an individual request from a queue by specifying its request
  ID.  (You can	obtain the request ID by using the lpq or lpstat commands.)
  Specifying one or more users removes any requests queued belonging to	those
  users.  This works only for a	user with superuser authority.

  The lprm command is silent if	there are no requests in the queue that	match
  the request list.

  The lprm command kills an active daemon, if necessary, before	removing any
  spooling files.  If a	daemon is killed, a new	one is automatically res-
  tarted upon completion of file removals.

NOTES

  Because race conditions are possible in the update of	the lock file, the
  currently active request may be incorrectly identified.





DIAGNOSTICS

  Permission denied
      The user tried to	remove files that belong to another user.


EXAMPLES

   1.  To remove a request from	the default queue by specifying	the request
       ID, enter:
	    lprm 13

   2.  To remove a request from	a specific queue, enter:
	    lprm -Plp0 13

   3.  To remove from a	specific queue a request from user guest, enter:
	    lprm -Plp0 guest



FILES

  /etc/printcap
      Printer description file.

  /var/spool/*
      Spool directories.

  /var/spool/*/cf*
      Daemon control files.

  /var/spool/*/df*
      Data files specified in cf files.

  /var/spool/*/tf*
      Temporary	copies of cf files.

  /var/spool/*/lock
      Lock file	used to	obtain the process ID of the current daemon and	the
      request ID of the	currently active request.

SEE ALSO

  Commands:  lp(1), lpc(8), lpd(8), lpq(1), lpr(1), lpstat(1)