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     ! 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.