/usr/share/doc/magic/html/crash.html is in magic 8.0.210-2.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 | <HTML>
<HEAD>
<STYLE type="text/css">
H1 {color: black }
H2 {color: maroon }
H3 {color: #007090 }
A.head:link {color: #0060a0 }
A.head:visited {color: #3040c0 }
A.head:active {color: white }
A.head:hover {color: yellow }
A.red:link {color: red }
A.red:visited {color: maroon }
A.red:active {color: yellow }
</STYLE>
</HEAD>
<TITLE>Magic-7.3 Command Reference</TITLE>
<BODY BACKGROUND=graphics/blpaper.gif>
<H1> <IMG SRC=graphics/magic_title2.gif ALT="Magic VLSI Layout Tool Version 7.3">
<IMG SRC=graphics/magic_OGL_sm.gif ALIGN="top" ALT="*"> </H1>
<H2>crash</H2>
<HR>
Handle crash backup files
<HR>
<H3>Usage:</H3>
<BLOCKQUOTE>
<B>crash save</B> | <B>recover</B> [<I>filename</I>] <BR><BR>
</BLOCKQUOTE>
<H3>Summary:</H3>
<BLOCKQUOTE>
The <B>crash</B> command handles crash backup files. The exact
operation depends on the options, and are outlined below:
<DL>
<DT> <B>crash save</B>
<DD> creates and writes to a single file a copy of the contents
of all modified cells. If <B>crash save</B> has been
called previously, then the filename specified or
generated will be used again. If this is the first
call to <B>crash save</B>, or if the previous call was
<B>crash save ""</B>, then a new, unique filename of
a file in the system temporary directory (normally
"<TT>/tmp</TT>") is created and remembered for subsequent
calls to <B>crash save</B>.
<DT> <B>crash save</B> <I>filename</I>
<DD> creates and writes to the file <I>filename</I> a copy of
the contents of all modified cells. <I>filename</I>
is retained as the crash filename, so subsequent uses
of <B>crash save</B> without a filename specified will
also write to this file.
<DT> <B>crash save ""</B>
<DD> causes magic to forget the name of the crash file. The
next use of <B>crash save</B> without a filename will
revert to the behavior of generating a unique filename
in the system temporary directory.
<DT> <B>crash recover</B>
<DD> searches the system temporary directory for magic crash
recovery files. If one or more such files is found,
then the user is prompted for the action of either
recovering or ignoring the most recent file found.
If the chosen action is to recover the file, then the
contents of the saved crash file are loaded into the
database, and the file is removed.
<DT> <B>crash recover</B> <I>filename</I>
<DD> recovers the database from the contents of the saved crash
file <I>filename</I> upon successful read-in, the file
<I>filename</I> is removed. <B>
</DL>
If a crash file has been generated during a layout editing session,
and magic is exited normally with the "quit" command, then the
crash backup file is removed. <P>
For backward-compatibility, crash backup files are always generated
when magic receives a SIGTERM signal. In the non-Tcl version of
magic, periodic backups are not made.
</BLOCKQUOTE>
<H3>Implementation Notes:</H3>
<BLOCKQUOTE>
<B>crash</B> is implemented as a built-in command in <B>magic</B>.
The Tcl/Tk version defines various scripts in "tools.tcl" that
implement a periodic backup using the <B>crash</B> command.
Invoking magic on the command-line using "<B>magic -r</B>" is
equivalent to starting magic followed by the command
"<B>crash recover</B>".
</BLOCKQUOTE>
<H3>See Also:</H3>
<BLOCKQUOTE>
<A HREF=crashbackups.html><B>crashbackups</B></A> <BR>
</BLOCKQUOTE>
<P><IMG SRC=graphics/line1.gif><P>
<TABLE BORDER=0>
<TR>
<TD> <A HREF=commands.html>Return to command index</A>
</TR>
</TABLE>
<P><I>Last updated:</I> December 7, 2005 at 3:06pm <P>
</BODY>
</HTML>
|