Return to lprm.1 CVS log

Up to [CSRG BSD Unix] / 43BSDTahoe / man / man1

Annotation of 43BSDTahoe/man/man1/lprm.1, revision 1.1.1.1

1.1       root        1: .\" Copyright (c) 1983 Regents of the University of California.
                      2: .\" All rights reserved.  The Berkeley software License Agreement
                      3: .\" specifies the terms and conditions for redistribution.
                      4: .\"
                      5: .\"    @(#)lprm.1      6.1 (Berkeley) 4/29/85
                      6: .\"
                      7: .TH LPRM 1 "April 29, 1985"
                      8: .UC 5
                      9: .SH NAME
                     10: lprm \- remove jobs from the line printer spooling queue
                     11: .SH SYNOPSIS
                     12: .B lprm
                     13: [
                     14: .BI \-P printer
                     15: ] [
                     16: .B \-
                     17: ] [
                     18: job # ...
                     19: ] [
                     20: user ...
                     21: ]
                     22: .SH DESCRIPTION
                     23: .I Lprm
                     24: will remove a job, or jobs, from a printer's spool queue.
                     25: Since the spooling directory is protected from users, using
                     26: .I lprm
                     27: is normally the only method by which a user may remove a job.
                     28: .PP
                     29: .I Lprm
                     30: without any arguments will delete the currently active job if it is
                     31: owned by the user who invoked
                     32: .IR lprm .
                     33: .PP
                     34: If the
                     35: .B \-
                     36: flag is specified, 
                     37: .I lprm
                     38: will remove all jobs which a user
                     39: owns.  If the super-user employs this flag, the spool queue will
                     40: be emptied entirely. The owner is determined by the user's login name
                     41: and host name on the machine where the
                     42: .I lpr
                     43: command was invoked.
                     44: .PP
                     45: Specifying a user's name, or list of user names, will cause
                     46: .I lprm
                     47: to attempt to remove any jobs queued belonging to that user
                     48: (or users).  This form of invoking
                     49: .I lprm
                     50: is useful only to the super-user.
                     51: .PP
                     52: A user may dequeue an individual job by specifying its job number.
                     53: This number may be obtained from the
                     54: .IR lpq (1)
                     55: program, e.g.
                     56: .PP
                     57: .nf
                     58: .in +0.5i
                     59: .ta \w'k0-k9  'u +\w'Type  'u +\w'"/usr/lib/lpd"  'u
                     60: .ta \w'1st: 'u +\w'(standard input)                    'u
                     61: % lpq \-l
                     62: 
                     63: 1st: ken       [job #013ucbarpa]
                     64:        (standard input)        100 bytes
                     65: % lprm 13
                     66: .in -0.5i
                     67: .fi
                     68: .PP
                     69: .I Lprm
                     70: will announce the names of any files it removes and is silent if
                     71: there are no jobs in the queue which match the request list.
                     72: .PP
                     73: .I Lprm
                     74: will kill off an active daemon, if necessary, before removing
                     75: any spooling files.  If a daemon is killed, a new one is
                     76: automatically restarted upon completion of file removals.
                     77: .PP
                     78: The
                     79: .B \-P
                     80: option may be usd to specify the queue associated with a specific
                     81: printer (otherwise the default printer, or the value of the PRINTER
                     82: variable in the environment is used).
                     83: .SH FILES
                     84: .nf
                     85: .ta \w'/usr/spool/*/lock   'u
                     86: /etc/printcap  printer characteristics file
                     87: /usr/spool/*   spooling directories
                     88: /usr/spool/*/lock      lock file used to obtain the pid of the current
                     89:        daemon and the job number of the currently active job
                     90: .fi
                     91: .SH "SEE ALSO"
                     92: lpr(1),
                     93: lpq(1),
                     94: lpd(8)
                     95: .SH DIAGNOSTICS
                     96: ``Permission denied" if the user tries to remove files other than his
                     97: own.
                     98: .SH BUGS
                     99: Since there are race conditions possible in the update of the lock file,
                    100: the currently active job may be incorrectly identified.

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.