source: trunk/athena/bin/delete/man1/undelete.1 @ 2216

Revision 2216, 3.4 KB checked in by jik, 35 years ago (diff)
Deleted stuff about symbolc links being followed when restoring, because it isn't true.
Line 
1.\"     $Source: /afs/dev.mit.edu/source/repository/athena/bin/delete/man1/undelete.1,v $
2.\"     $Author: jik $
3.\"     $Header: /afs/dev.mit.edu/source/repository/athena/bin/delete/man1/undelete.1,v 1.5 1989-11-02 07:13:26 jik Exp $
4.\" Copyright 1989 by the Massachusetts Institute of Technology.  All
5.\" rights reserved.  The file /usr/include/mit-copyright.h specifies
6.\" the terms and conditions for redistribution.
7.\"
8.\"
9.TH UNDELETE 1 "January 26, 1988" "MIT Project Athena"
10.ds ]W MIT Project Athena
11.SH NAME
12undelete \- recover files removed by delete
13.SH SYNOPSIS
14.B undelete
15[
16.B \-r
17] [
18.B \-i
19] [
20.B \-f
21] [
22.B \-v
23] [
24.B \-n
25] [
26.B \-R
27] [
28.B \-\|\-
29] [ filename [ ... ]]
30.PP
31.DESCRIPTION
32.I Undelete
33recovers files and directories that have been marked for permanent removal by
34\fIdelete\fR(1), but have not
35yet been removed.
36.PP
37Filenames passed to
38.I undelete
39can be directories or deleted files.
40If a directory that is not deleted is passed to
41.I undelete,
42then the deleted files or directories in it will be restored; if the
43recursive option is specified, then all deleted files or directories
44in any of its children will be restored as well.
45.PP
46The shell wildcards \fI*\fR and \fI?\fR, as well as shell brace
47notation using \fI[\fR and \fI]\fR, are interpreted correctly by
48.I undelete.
49It is possible to pass wildcards to the program without the wildcards
50being intercepted by the shell by setting
51.I noglob
52(in \fIcsh\fR) or by quoting the wildcards.  To delete a file that
53actually has a wildcard in its name, you must precede the quoted
54wildcard with a quoted backslash.
55.PP
56If no files are specified on the command line,
57.I undelete
58goes into interactive mode.  In interactive mode, the user is prompted
59to enter files to be restored, one file per line.  Typing a carriage
60return on an empty prompt line exits the program.
61.PP
62Wildcards and quoting backslashes can be entered directly at the
63prompt without any shell interference (which is the
64main reason there is an interactive mode).
65.SH OPTIONS
66.I Undelete
67accepts the following command-line options:
68.TP
69.B \-r
70If a specified file is a directory, the directory and all of its
71children are restored recursively.
72.TP
73.B \-i
74The user is prompted for confirmation before each file or directory is
75restored.  This is not the same as the interactive file name entry
76mode which is automatically activated when no files are specified on
77the command line.
78.TP
79.B \-f
80Prevents
81.I undelete
82from reporting errors.  Further, if an intact (undeleted) version of a
83file which is requested for undeletion exists, then
84.I undelete
85will not prompt for confirmation before overwriting the undeleted file
86with the recovered one.
87.TP
88.B \-v
89Causes
90.I undelete
91to report each file as it is restored.  Also, causes an introductory
92message to be printed when entering interactive mode.
93.TP
94.B \-n
95No file recoveries are performed.  Instead,
96.I undelete
97prints to the standard output the files that it would recover were the
98.B \-n
99option not specified.
100.TP
101.B \-R
102Prevents
103.I undelete
104from restoring the contents of directories in any case.
105.TP
106.B \-\|\-
107Two dashes indicate that all arguments following it are to be treated as file
108names, even if they start with a dash.
109.SH "SEE ALSO"
110delete(1), purge(1), expunge(1), lsdel(1), rm(1), rmdir(1)
111.SH AUTHOR
112Jonathan I. Kamens (MIT-Project Athena)
113.SH RESTRICTIONS
114Copyright (c) 1989 by the Massachusetts Institute of Technology.  All
115rights reserved.
116.IR Delete (1)
117specifies the terms and conditions for redistribution.
Note: See TracBrowser for help on using the repository browser.