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