Commit | Line | Data |
---|---|---|
15637ed4 RG |
1 | .TH ELVISPRESERVE 8 |
2 | .SH NAME | |
3 | elvispreserve - Preserve the the modified version of a file after a crash. | |
4 | .SH SYNOPSIS | |
5 | .nf | |
6 | \fB\fBelvispreserve\fP ["-\fIwhy elvis died\fP"] /tmp/\fIfilename\fP... | |
7 | \fB\fBelvispreserve\fP -R /tmp/\fIfilename\fP... | |
8 | .fi | |
9 | .SH DESCRIPTION | |
10 | .PP | |
11 | \fIelvispreserve\fP preserves your edited text after \fIelvis\fP dies. | |
12 | The text can be recovered later, via the \fIelvispreserve\fP program. | |
13 | .PP | |
14 | For UNIX-like systems, | |
15 | you should never need to run this program from the command line. | |
16 | It is run automatically when \fIelvis\fP is about to die, | |
17 | and it should be run (via /etc/rc) when the computer is booted. | |
18 | THAT'S ALL! | |
19 | .PP | |
20 | For non-UNIX systems such as MS-DOS, you can either use \fIelvispreserve\fP | |
21 | the same way as under UNIX systems (by running it from your AUTOEXEC.BAT file), | |
22 | or you can run it separately with the "-R" flag to recover the files | |
23 | in one step. | |
24 | .PP | |
25 | If you're editing a file when \fIelvis\fP dies | |
26 | (due to a bug, system crash, power failure, etc.) | |
27 | then \fIelvispreserve\fP will preserve the most recent version of your text. | |
28 | The preserved text is stored in a special directory; it does NOT overwrite | |
29 | your text file automatically. | |
30 | .PP | |
31 | \fIelvispreserve\fP will send mail to any user whose work it preserves, | |
32 | if your operating system normally supports mail. | |
33 | .SH FILES | |
34 | .IP /tmp/elv* | |
35 | The temporary file that \fIelvis\fP was using when it died. | |
e4b163b1 | 36 | .IP /var/preserve/p* |
15637ed4 | 37 | The text that is preserved by \fIelvispreserve\fP. |
e4b163b1 | 38 | .IP /var/preserve/Index |
15637ed4 | 39 | A text file which lists the names of all preserved files, and the names |
e4b163b1 | 40 | of the /var/preserve/p* files which contain their preserved text. |
15637ed4 RG |
41 | .SH BUGS |
42 | .PP | |
e4b163b1 | 43 | Due to the permissions on the /var/preserve directory, on UNIX systems |
15637ed4 RG |
44 | \fIelvispreserve\fP must be run as superuser. |
45 | This is accomplished by making the \fIelvispreserve\fP executable be owned by "root" | |
46 | and turning on its "set user id" bit. | |
47 | .PP | |
48 | If you're editing a nameless buffer when \fIelvis\fP dies, then \fIelvispreserve\fP will pretend | |
49 | that the file was named "foo". | |
50 | .SH AUTHOR | |
51 | .nf | |
52 | Steve Kirkendall | |
53 | kirkenda@cs.pdx.edu | |
54 | .fi |