lprm(1)                  USER COMMANDS                    lprm(1)



NAME
     lprm - remove jobs from the printer queue

SYNOPSIS
     /usr/ucb/lprm [ -Pprinter ] [ - ] [ job # ...  ] [  username
     ...  ]

DESCRIPTION
     lprm removes a job or jobs from a printer's spooling  queue.
     Since  the  spool  directory  is protected from users, using
     lprm is normally the only method by which a user can  remove
     a  job.  Without any arguments, lprm deletes the job that is
     currently active, provided that the user  who  invoked  lprm
     owns  that  job.  When the privileged user specifies a user-
     name, lprm removes all jobs belonging to that user.  You can
     remove  a  specific  job  by  supplying its job number as an
     argument, which you can obtain using lpq(1).  For example:
          lpq  -Phost
          host is ready and printing
          Rank Owner   Job     Files   Total Size
          active       wendy   385     standard input  35501 bytes
          lprm -Phost 385
     lprm reports the names of  any  files  it  removes,  and  is
     silent  if  there  are  no  applicable jobs to remove.  lprm
     Sends the request to cancel a  job  to  the  print  spooler,
     LPSCHED.

OPTIONS
     -Pprinter Specify  the  queue  associated  with  a  specific
               printer.  Otherwise the value of the PRINTER vari-
               able in the environment is used.  If this variable
               is  unset,  the  queue  for the default printer is
               used.

     -         Remove all jobs owned by you.  If invoked  by  the
               privileged   user,  all  jobs  in  the  spool  are
               removed.   Job  ownership  is  determined  by  the
               user's  login  name  and  host name on the machine
               where the lpr command was executed.

FILES
     /var/spool/lp/*     spooling directories

SEE ALSO
     lpq(1), lpr(1) lpsched(1M)  in  the  System  Administrator's
     Reference Manual.
     cancel(1), lp(1) in the User's Reference Manual.

DIAGNOSTICS
     lprm: printer: unknown printer
          The printer was not found in the System V LP  database.
          Usually  this  is  a  typing  mistake;  however, it may



             Last change: BSD Compatibility Package             1

lprm(1)                  USER COMMANDS                    lprm(1)



          indicate that the printer does not exist on the system.
          Use `lptstat -p' to find the reason.

     lprm: error on opening queue to spooler
          The connection to lpsched on the local machine  failed.
          This  usually  means the printer server started at boot
          time has died or is hung.  Check if the printer spooler
          daemon /usr/lib/lpsched is running.

     lprm: Can't send message to the LP print service

     lprm: Can't receive message from the LP print service
          These indicate that  the  LP  print  service  has  been
          stopped.  Get help from the system administrator.

     lprm: Received unexpected message from the LP print service
          It is likely there is an error in this  software.   Get
          help from system administrator.

     lprm: Can't cancel request
          You are not allowed to remove another's request.

NOTES
     An active job may be incorrectly identified for  removal  by
     an lprm command issued with no arguments.  During the inter-
     val between an lpq(1) command and the execution of lprm, the
     next  job  in  queue may have become active; that job may be
     removed unintentionally if it is owned  by  you.   To  avoid
     this, supply lprm with the job number to remove when a crit-
     ical job that you own is next in line.  Only the  privileged
     user  can remove print jobs submitted from another host.  lp
     is the preferred interface.























             Last change: BSD Compatibility Package             2