Return to lprm.1 CVS log

Up to [CSRG BSD Unix] / 43BSDReno / usr.sbin / lpr / lprm

Annotation of 43BSDReno/usr.sbin/lpr/lprm/lprm.1, revision 1.1

1.1     ! root        1: .\" Copyright (c) 1983, 1990 The Regents of the University of California.
        !             2: .\" All rights reserved.
        !             3: .\"
        !             4: .\" Redistribution and use in source and binary forms are permitted provided
        !             5: .\" that: (1) source distributions retain this entire copyright notice and
        !             6: .\" comment, and (2) distributions including binaries display the following
        !             7: .\" acknowledgement:  ``This product includes software developed by the
        !             8: .\" University of California, Berkeley and its contributors'' in the
        !             9: .\" documentation or other materials provided with the distribution and in
        !            10: .\" all advertising materials mentioning features or use of this software.
        !            11: .\" Neither the name of the University nor the names of its contributors may
        !            12: .\" be used to endorse or promote products derived from this software without
        !            13: .\" specific prior written permission.
        !            14: .\" THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR IMPLIED
        !            15: .\" WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF
        !            16: .\" MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
        !            17: .\"
        !            18: .\"     @(#)lprm.1     6.5 (Berkeley) 7/24/90
        !            19: .\"
        !            20: .Dd July 24, 1990
        !            21: .Dt LPRM 1
        !            22: .Os BSD 4.2
        !            23: .Sh NAME
        !            24: .Nm lprm
        !            25: .Nd remove jobs from the line printer spooling queue
        !            26: .Sh SYNOPSIS
        !            27: .Nm lprm
        !            28: .Oo
        !            29: .Op Fl P Ar printer
        !            30: .Oo
        !            31: .Op Fl
        !            32: .Op job # ...
        !            33: .Op Ar user ...
        !            34: .Sh DESCRIPTION
        !            35: .Nm Lprm
        !            36: will remove a job, or jobs, from a printer's spool queue.
        !            37: Since the spooling directory is protected from users, using
        !            38: .Nm lprm
        !            39: is normally the only method by which a user may remove a job.
        !            40: The owner of a job is determined by the user's login name
        !            41: and host name on the machine where the
        !            42: .Xr lpr 1
        !            43: command was invoked.
        !            44: .Pp
        !            45: Options and arguments:
        !            46: .Tw Fl
        !            47: .Tc Fl P
        !            48: .Ar printer
        !            49: .Cx
        !            50: Specify the queue associated with a specific
        !            51: .Ar printer
        !            52: (otherwise the default printer is used).
        !            53: .Tp Fl
        !            54: If a single
        !            55: .Sq Fl
        !            56: is given,
        !            57: .Nm lprm
        !            58: will remove all jobs which a user
        !            59: owns.  If the super-user employs this flag, the spool queue will
        !            60: be emptied entirely.
        !            61: .Tp Ar user
        !            62: Causes
        !            63: .Nm lprm
        !            64: to attempt to remove any jobs queued belonging to that user
        !            65: (or users).  This form of invoking
        !            66: .Nm lprm
        !            67: is useful only to the super-user.
        !            68: .Tp Ar job\ \&#
        !            69: A user may dequeue an individual job by specifying its job number.
        !            70: This number may be obtained from the
        !            71: .Ar lpq  1
        !            72: program, e.g.
        !            73: .Pp
        !            74: .Ds I
        !            75: .Cw \&a 1st:standard_input)
        !            76: .Cl \&% lpq \-l
        !            77: 
        !            78: .Cl 1st:ken\t\t[job #013ucbarpa]
        !            79: .Cl \t(standard input) 100 bytes
        !            80: .Cl % lprm 13
        !            81: .Cw
        !            82: .De
        !            83: .Tp
        !            84: .Pp
        !            85: If neither arguments or options are given,
        !            86: .Nm Lprm
        !            87: will delete the currently active job if it is
        !            88: owned by the user who invoked
        !            89: .Nm lprm  .
        !            90: .Pp
        !            91: .Nm Lprm
        !            92: announces the names of any files it removes and is silent if
        !            93: there are no jobs in the queue which match the request list.
        !            94: .Pp
        !            95: .Nm Lprm
        !            96: will kill off an active daemon, if necessary, before removing
        !            97: any spooling files.  If a daemon is killed, a new one is
        !            98: automatically restarted upon completion of file removals.
        !            99: .Sh ENVIRONMENT
        !           100: The following environment variable exists, it is utilized by
        !           101: .Nm lprm .
        !           102: .Tw Fl
        !           103: .Tp Ev PRINTER
        !           104: If the environment variable
        !           105: .Ev PRINTER
        !           106: exists,
        !           107: and a printer has not been specified with the
        !           108: .Fl P
        !           109: option,
        !           110: the default printer is assumed from 
        !           111: .Ev PRINTER .
        !           112: .Tp
        !           113: .Sh FILES
        !           114: .Dw /var/spool/*/lock/
        !           115: .Di L
        !           116: .Dp Pa /etc/printcap
        !           117: printer characteristics file
        !           118: .Dp Pa /var/spool/*
        !           119: spooling directories
        !           120: .Dp Pa /var/spool/*/lock
        !           121: lock file used to obtain the pid of the current
        !           122: daemon and the job number of the currently active job
        !           123: .Dp
        !           124: .Sh SEE ALSO
        !           125: .Xr lpr 1 ,
        !           126: .Xr lpq 1 ,
        !           127: .Xr lpd 8
        !           128: .Sh DIAGNOSTICS
        !           129: ``Permission denied" if the user tries to remove files other than his
        !           130: own.
        !           131: .Sh BUGS
        !           132: Since there are race conditions possible in the update of the lock file,
        !           133: the currently active job may be incorrectly identified.
        !           134: .Sh HISTORY
        !           135: .Nm Lprm
        !           136: appeared in 3 BSD.

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