# 2.11BSD#431 - /usr/man/cat1/lprm.0

    LPRM(1)             UNIX Programmer's Manual		  LPRM(1)

    NAME
         lprm - remove jobs from the line printer spooling queue

    SYNOPSIS
         lprm [ -Pprinter ] [ - ] [ job # ...  ] [ user ...  ]

    DESCRIPTION
         Lprm will remove a job, or jobs, from a printer's spool
         queue.  Since the spooling directory is protected from
         users, using lprm is normally the only method by which a
         user may remove a job.

         Lprm without any arguments will delete the currently active
         job if it is owned by the user who invoked lprm.

         If the - flag is specified, lprm will remove all jobs which
         a user owns.  If the super-user employs this flag, the spool
         queue will be emptied entirely. The owner is determined by
         the user's login name and host name on the machine where the
         lpr command was invoked.

         Specifying a user's name, or list of user names, will cause
         lprm to attempt to remove any jobs queued belonging to that
         user (or users).  This form of invoking lprm is useful only
         to the super-user.

         A user may dequeue an individual job by specifying its job
         number.  This number may be obtained from the lpq(1) pro-
         gram, e.g.

    	  % lpq -l

    	  1st: ken			     [job #013ucbarpa]
    	       (standard input)              100 bytes
    	  % lprm 13

         Lprm will announce the names of any files it removes and is
         silent if there are no jobs in the queue which match the
         request list.

         Lprm will kill off an active daemon, if necessary, before
         removing any spooling files.  If a daemon is killed, a new
         one is automatically restarted upon completion of file remo-
         vals.

         The -P option may be usd to specify the queue associated
         with a specific printer (otherwise the default printer, or
         the value of the PRINTER variable in the environment is
         used).

    FILES
         /etc/printcap	 printer characteristics file

    Printed 11/26/99	October 22, 1996			1

    LPRM(1)             UNIX Programmer's Manual		  LPRM(1)

         /usr/spool/*	 spooling directories
         /usr/spool/*/lock	 lock file used to obtain the pid of the current
    			 daemon and the job number of the currently active job

    SEE ALSO
         lpr(1), lpq(1), lpd(8)

    DIAGNOSTICS
         ``Permission denied" if the user tries to remove files other
         than his own.

    BUGS
         Since there are race conditions possible in the update of
         the lock file, the currently active job may be incorrectly
         identified.

    Printed 11/26/99	October 22, 1996			2

Generated: 2016-12-26 | Generated by man2html V0.25 page hit count: 341 |