/usr/share/doc/octave/octave.html/Saving-Data-on-Unexpected-Exits.html is in octave-doc 4.2.2-1ubuntu1.
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 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 | <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<!-- Created by GNU Texinfo 6.5, http://www.gnu.org/software/texinfo/ -->
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<title>Saving Data on Unexpected Exits (GNU Octave)</title>
<meta name="description" content="Saving Data on Unexpected Exits (GNU Octave)">
<meta name="keywords" content="Saving Data on Unexpected Exits (GNU Octave)">
<meta name="resource-type" content="document">
<meta name="distribution" content="global">
<meta name="Generator" content="makeinfo">
<link href="index.html#Top" rel="start" title="Top">
<link href="Concept-Index.html#Concept-Index" rel="index" title="Concept Index">
<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
<link href="Simple-File-I_002fO.html#Simple-File-I_002fO" rel="up" title="Simple File I/O">
<link href="C_002dStyle-I_002fO-Functions.html#C_002dStyle-I_002fO-Functions" rel="next" title="C-Style I/O Functions">
<link href="Simple-File-I_002fO.html#Simple-File-I_002fO" rel="prev" title="Simple File I/O">
<style type="text/css">
<!--
a.summary-letter {text-decoration: none}
blockquote.indentedblock {margin-right: 0em}
blockquote.smallindentedblock {margin-right: 0em; font-size: smaller}
blockquote.smallquotation {font-size: smaller}
div.display {margin-left: 3.2em}
div.example {margin-left: 3.2em}
div.lisp {margin-left: 3.2em}
div.smalldisplay {margin-left: 3.2em}
div.smallexample {margin-left: 3.2em}
div.smalllisp {margin-left: 3.2em}
kbd {font-style: oblique}
pre.display {font-family: inherit}
pre.format {font-family: inherit}
pre.menu-comment {font-family: serif}
pre.menu-preformatted {font-family: serif}
pre.smalldisplay {font-family: inherit; font-size: smaller}
pre.smallexample {font-size: smaller}
pre.smallformat {font-family: inherit; font-size: smaller}
pre.smalllisp {font-size: smaller}
span.nolinebreak {white-space: nowrap}
span.roman {font-family: initial; font-weight: normal}
span.sansserif {font-family: sans-serif; font-weight: normal}
ul.no-bullet {list-style: none}
-->
</style>
<link rel="stylesheet" type="text/css" href="octave.css">
</head>
<body lang="en">
<a name="Saving-Data-on-Unexpected-Exits"></a>
<div class="header">
<p>
Up: <a href="Simple-File-I_002fO.html#Simple-File-I_002fO" accesskey="u" rel="up">Simple File I/O</a> [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Concept-Index.html#Concept-Index" title="Index" rel="index">Index</a>]</p>
</div>
<hr>
<a name="Saving-Data-on-Unexpected-Exits-1"></a>
<h4 class="subsubsection">14.1.3.1 Saving Data on Unexpected Exits</h4>
<p>If Octave for some reason exits unexpectedly it will by default save the
variables available in the workspace to a file in the current directory.
By default this file is named ‘<samp>octave-workspace</samp>’ and can be loaded
into memory with the <code>load</code> command. While the default behavior
most often is reasonable it can be changed through the following
functions.
</p>
<a name="XREFcrash_005fdumps_005foctave_005fcore"></a><dl>
<dt><a name="index-crash_005fdumps_005foctave_005fcore"></a>: <em><var>val</var> =</em> <strong>crash_dumps_octave_core</strong> <em>()</em></dt>
<dt><a name="index-crash_005fdumps_005foctave_005fcore-1"></a>: <em><var>old_val</var> =</em> <strong>crash_dumps_octave_core</strong> <em>(<var>new_val</var>)</em></dt>
<dt><a name="index-crash_005fdumps_005foctave_005fcore-2"></a>: <em></em> <strong>crash_dumps_octave_core</strong> <em>(<var>new_val</var>, "local")</em></dt>
<dd><p>Query or set the internal variable that controls whether Octave tries
to save all current variables to the file <samp>octave-workspace</samp> if it
crashes or receives a hangup, terminate or similar signal.
</p>
<p>When called from inside a function with the <code>"local"</code> option, the
variable is changed locally for the function and any subroutines it calls.
The original variable value is restored when exiting the function.
</p>
<p><strong>See also:</strong> <a href="#XREFoctave_005fcore_005ffile_005flimit">octave_core_file_limit</a>, <a href="#XREFoctave_005fcore_005ffile_005fname">octave_core_file_name</a>, <a href="#XREFoctave_005fcore_005ffile_005foptions">octave_core_file_options</a>.
</p></dd></dl>
<a name="XREFsighup_005fdumps_005foctave_005fcore"></a><dl>
<dt><a name="index-sighup_005fdumps_005foctave_005fcore"></a>: <em><var>val</var> =</em> <strong>sighup_dumps_octave_core</strong> <em>()</em></dt>
<dt><a name="index-sighup_005fdumps_005foctave_005fcore-1"></a>: <em><var>old_val</var> =</em> <strong>sighup_dumps_octave_core</strong> <em>(<var>new_val</var>)</em></dt>
<dt><a name="index-sighup_005fdumps_005foctave_005fcore-2"></a>: <em></em> <strong>sighup_dumps_octave_core</strong> <em>(<var>new_val</var>, "local")</em></dt>
<dd><p>Query or set the internal variable that controls whether Octave tries
to save all current variables to the file <samp>octave-workspace</samp> if it
receives a hangup signal.
</p>
<p>When called from inside a function with the <code>"local"</code> option, the
variable is changed locally for the function and any subroutines it calls.
The original variable value is restored when exiting the function.
</p></dd></dl>
<a name="XREFsigterm_005fdumps_005foctave_005fcore"></a><dl>
<dt><a name="index-sigterm_005fdumps_005foctave_005fcore"></a>: <em><var>val</var> =</em> <strong>sigterm_dumps_octave_core</strong> <em>()</em></dt>
<dt><a name="index-sigterm_005fdumps_005foctave_005fcore-1"></a>: <em><var>old_val</var> =</em> <strong>sigterm_dumps_octave_core</strong> <em>(<var>new_val</var>)</em></dt>
<dt><a name="index-sigterm_005fdumps_005foctave_005fcore-2"></a>: <em></em> <strong>sigterm_dumps_octave_core</strong> <em>(<var>new_val</var>, "local")</em></dt>
<dd><p>Query or set the internal variable that controls whether Octave tries
to save all current variables to the file <samp>octave-workspace</samp> if it
receives a terminate signal.
</p>
<p>When called from inside a function with the <code>"local"</code> option, the
variable is changed locally for the function and any subroutines it calls.
The original variable value is restored when exiting the function.
</p></dd></dl>
<a name="XREFoctave_005fcore_005ffile_005foptions"></a><dl>
<dt><a name="index-octave_005fcore_005ffile_005foptions"></a>: <em><var>val</var> =</em> <strong>octave_core_file_options</strong> <em>()</em></dt>
<dt><a name="index-octave_005fcore_005ffile_005foptions-1"></a>: <em><var>old_val</var> =</em> <strong>octave_core_file_options</strong> <em>(<var>new_val</var>)</em></dt>
<dt><a name="index-octave_005fcore_005ffile_005foptions-2"></a>: <em></em> <strong>octave_core_file_options</strong> <em>(<var>new_val</var>, "local")</em></dt>
<dd><p>Query or set the internal variable that specifies the options used for
saving the workspace data if Octave aborts.
</p>
<p>The value of <code>octave_core_file_options</code> should follow the same format
as the options for the <code>save</code> function. The default value is Octave’s
binary format.
</p>
<p>When called from inside a function with the <code>"local"</code> option, the
variable is changed locally for the function and any subroutines it calls.
The original variable value is restored when exiting the function.
</p>
<p><strong>See also:</strong> <a href="#XREFcrash_005fdumps_005foctave_005fcore">crash_dumps_octave_core</a>, <a href="#XREFoctave_005fcore_005ffile_005fname">octave_core_file_name</a>, <a href="#XREFoctave_005fcore_005ffile_005flimit">octave_core_file_limit</a>.
</p></dd></dl>
<a name="XREFoctave_005fcore_005ffile_005flimit"></a><dl>
<dt><a name="index-octave_005fcore_005ffile_005flimit"></a>: <em><var>val</var> =</em> <strong>octave_core_file_limit</strong> <em>()</em></dt>
<dt><a name="index-octave_005fcore_005ffile_005flimit-1"></a>: <em><var>old_val</var> =</em> <strong>octave_core_file_limit</strong> <em>(<var>new_val</var>)</em></dt>
<dt><a name="index-octave_005fcore_005ffile_005flimit-2"></a>: <em></em> <strong>octave_core_file_limit</strong> <em>(<var>new_val</var>, "local")</em></dt>
<dd><p>Query or set the internal variable that specifies the maximum amount
of memory (in kilobytes) of the top-level workspace that Octave will
attempt to save when writing data to the crash dump file (the name of
the file is specified by <var>octave_core_file_name</var>).
</p>
<p>If <var>octave_core_file_options</var> flags specify a binary format,
then <var>octave_core_file_limit</var> will be approximately the maximum
size of the file. If a text file format is used, then the file could
be much larger than the limit. The default value is -1 (unlimited)
</p>
<p>When called from inside a function with the <code>"local"</code> option, the
variable is changed locally for the function and any subroutines it calls.
The original variable value is restored when exiting the function.
</p>
<p><strong>See also:</strong> <a href="#XREFcrash_005fdumps_005foctave_005fcore">crash_dumps_octave_core</a>, <a href="#XREFoctave_005fcore_005ffile_005fname">octave_core_file_name</a>, <a href="#XREFoctave_005fcore_005ffile_005foptions">octave_core_file_options</a>.
</p></dd></dl>
<a name="XREFoctave_005fcore_005ffile_005fname"></a><dl>
<dt><a name="index-octave_005fcore_005ffile_005fname"></a>: <em><var>val</var> =</em> <strong>octave_core_file_name</strong> <em>()</em></dt>
<dt><a name="index-octave_005fcore_005ffile_005fname-1"></a>: <em><var>old_val</var> =</em> <strong>octave_core_file_name</strong> <em>(<var>new_val</var>)</em></dt>
<dt><a name="index-octave_005fcore_005ffile_005fname-2"></a>: <em></em> <strong>octave_core_file_name</strong> <em>(<var>new_val</var>, "local")</em></dt>
<dd><p>Query or set the internal variable that specifies the name of the file
used for saving data from the top-level workspace if Octave aborts.
</p>
<p>The default value is <code>"octave-workspace"</code>
</p>
<p>When called from inside a function with the <code>"local"</code> option, the
variable is changed locally for the function and any subroutines it calls.
The original variable value is restored when exiting the function.
</p>
<p><strong>See also:</strong> <a href="#XREFcrash_005fdumps_005foctave_005fcore">crash_dumps_octave_core</a>, <a href="#XREFoctave_005fcore_005ffile_005fname">octave_core_file_name</a>, <a href="#XREFoctave_005fcore_005ffile_005foptions">octave_core_file_options</a>.
</p></dd></dl>
<hr>
<div class="header">
<p>
Up: <a href="Simple-File-I_002fO.html#Simple-File-I_002fO" accesskey="u" rel="up">Simple File I/O</a> [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Concept-Index.html#Concept-Index" title="Index" rel="index">Index</a>]</p>
</div>
</body>
</html>
|