1 | .\" $Source: /afs/dev.mit.edu/source/repository/athena/bin/delete/man1/expunge.1,v $ |
---|
2 | .\" $Author: jik $ |
---|
3 | .\" $Header: /afs/dev.mit.edu/source/repository/athena/bin/delete/man1/expunge.1,v 1.5 1989-08-13 02:06:55 jik Exp $ |
---|
4 | .\" |
---|
5 | .\" Copyright 1989 by the Massachusetts Institute of Technology. All |
---|
6 | .\" rights reserved. The file /usr/include/mit-copyright.h specifies |
---|
7 | .\" the terms and conditions for redistribution. |
---|
8 | .\" |
---|
9 | .\" |
---|
10 | .TH EXPUNGE 1 "January 27, 1988" "MIT Project Athena" |
---|
11 | .ds ]W MIT Project Athena |
---|
12 | .SH NAME |
---|
13 | expunge, purge \- permanent removal of \fIdelete\fR\^d files |
---|
14 | .SH SYNOPSIS |
---|
15 | .B expunge |
---|
16 | [ |
---|
17 | .B \-r |
---|
18 | ] [ |
---|
19 | .B \-i |
---|
20 | ] [ |
---|
21 | .B \-f |
---|
22 | ] [ |
---|
23 | .B \-t \fIn\fR |
---|
24 | ] [ |
---|
25 | .B \-n |
---|
26 | ] [ |
---|
27 | .B \-v |
---|
28 | ] [ |
---|
29 | .B \-l |
---|
30 | ] [ |
---|
31 | .B \-y |
---|
32 | ] [ |
---|
33 | .B \-\|\- |
---|
34 | ] [ filename [ ... ]] |
---|
35 | .PP |
---|
36 | .B purge |
---|
37 | .PP |
---|
38 | .SH DESCRIPTION |
---|
39 | .I Expunge |
---|
40 | and |
---|
41 | .I purge |
---|
42 | permanently remove files which have been marked for deletion using |
---|
43 | \fIdelete\fR(1). Files removed with \fIexpunge\fR or \fIpurge\fR |
---|
44 | cannot be recovered, and care should therefore be exercised in the |
---|
45 | use of these utilities. |
---|
46 | .PP |
---|
47 | .I Purge |
---|
48 | is a simple utility which takes no command-line arguments. When it is |
---|
49 | executed, it searches through the user's entire home directory and |
---|
50 | finds all files that have been marked for deletion. It then displays |
---|
51 | a list of the files where are to be removed and prompts for |
---|
52 | confirmation. A response from the user starting with the letter |
---|
53 | \fIy\fR will cause the files to be permanently expunged. |
---|
54 | .PP |
---|
55 | Because |
---|
56 | .I purge |
---|
57 | searches through the user's entire home directory, it can take quite a |
---|
58 | while to complete its search. This is normal. |
---|
59 | .PP |
---|
60 | The filenames passed to |
---|
61 | .I expunge |
---|
62 | on the command-line can be directories (deleted or not deleted) or |
---|
63 | deleted files. Deleted files or directories are always completely |
---|
64 | expunged, while the treatment of non-deleted directories depends on |
---|
65 | the |
---|
66 | .BR \-r |
---|
67 | command-line option (see below). If no command-line filenames are |
---|
68 | specified, |
---|
69 | .I expunge |
---|
70 | defaults to the current working directory. |
---|
71 | .PP |
---|
72 | For information about wildcard use with \fIexpunge\fR, please see |
---|
73 | \fIundelete\fR(1). |
---|
74 | .PP |
---|
75 | .SH OPTIONS |
---|
76 | .I Expunge |
---|
77 | accepts the following command-line options: |
---|
78 | .TP |
---|
79 | .B \-r |
---|
80 | When a non-deleted directory is passed to \fIexpunge\fR, the |
---|
81 | .BR \-r |
---|
82 | option causes the directory to be searced recursively for deleted |
---|
83 | files. If the recursive option is \fInot\fR specified, only the |
---|
84 | direct children of the non-deleted directory are examined. A |
---|
85 | recursive search of a large directory can take quite a while. |
---|
86 | .TP |
---|
87 | .B \-i |
---|
88 | The user is prompted for confirmation with the name of the file and |
---|
89 | its size in kilobytes before each file or directory is |
---|
90 | removed. |
---|
91 | .TP |
---|
92 | .B \-f |
---|
93 | Used in conjunction with the |
---|
94 | .BR \-l |
---|
95 | option, this option prevents |
---|
96 | .I expunge |
---|
97 | from prompting for confirmation after listing all the files that are |
---|
98 | too be deleted. Furthermore, it prevents the printing of error |
---|
99 | messages. |
---|
100 | .TP |
---|
101 | .B \-t\fIn\fR |
---|
102 | Specifies the minimum age (in days) of files to be expunged, measured |
---|
103 | as the length of time since the last file modification. |
---|
104 | .TP |
---|
105 | .B \-n |
---|
106 | No file expunges are performed. Instead, |
---|
107 | .I expunge |
---|
108 | prints to the standard output the files that it would expunge were the |
---|
109 | .BR \-n |
---|
110 | option not specified. |
---|
111 | .TP |
---|
112 | .B \-v |
---|
113 | Causes |
---|
114 | .I expunge |
---|
115 | to report each file as it is expunged, as well as the size of the file |
---|
116 | and a running total of the number of kilobytes expunged. |
---|
117 | .TP |
---|
118 | .B \-l |
---|
119 | Causes |
---|
120 | .I expunge |
---|
121 | to list all found files before expunging them, similar to the actions |
---|
122 | of |
---|
123 | .I purge. |
---|
124 | .TP |
---|
125 | .B \-y |
---|
126 | The total number of kilobytes expunged is printed after |
---|
127 | .I expunge |
---|
128 | is finished removing files. |
---|
129 | .TP |
---|
130 | .B \-\|\- |
---|
131 | Two dashes indicate that all arguments following it are to be treated |
---|
132 | as file names, even if they start with a dash. |
---|
133 | .SH "SEE ALSO" |
---|
134 | delete(1), undelete(1), lsdel(1), rm(1), rmdir(1) |
---|
135 | .SH AUTHOR |
---|
136 | Jonathan I. Kamens (MIT-Project Athena) |
---|
137 | .SH RESTRICTIONS |
---|
138 | Copyright (c) 1989 by the Massachusetts Institute of Technology. All |
---|
139 | rights reserved. |
---|
140 | .IR Delete (1) |
---|
141 | specifies the terms and conditions for redistribution. |
---|