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