![[BACK]](/cvsweb/icons/back.gif){kind=icon}
Return to lprm.1 CVS log ![[TXT]](/cvsweb/icons/text.gif){kind=icon}
![[DIR]](/cvsweb/icons/dir.gif){kind=icon}
Up to [CSRG BSD Unix] / 43BSDReno / usr.sbin / lpr / lprm|
Return to lprm.1 CVS log | Up to [CSRG BSD Unix] / 43BSDReno / usr.sbin / lpr / lprm |
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.