Return to lprm.1 CVS log

Up to [Power 6/32 Unix Tahoe 4.2BSD] / cci / usr / src / man / man1

Annotation of cci/usr/src/man/man1/lprm.1, revision 1.1.1.1

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