<html lang="en">
<head>
<title>Saving Data on Unexpected Exits - GNU Octave</title>
<meta http-equiv="Content-Type" content="text/html">
<meta name="description" content="GNU Octave">
<meta name="generator" content="makeinfo 4.13">
<link title="Top" rel="start" href="index.html#Top">
<link rel="up" href="Simple-File-I_002fO.html#Simple-File-I_002fO" title="Simple File I/O">
<link href="http://www.gnu.org/software/texinfo/" rel="generator-home" title="Texinfo Homepage">
<meta http-equiv="Content-Style-Type" content="text/css">
<style type="text/css"><!--
pre.display { font-family:inherit }
pre.format { font-family:inherit }
pre.smalldisplay { font-family:inherit; font-size:smaller }
pre.smallformat { font-family:inherit; font-size:smaller }
pre.smallexample { font-size:smaller }
pre.smalllisp { font-size:smaller }
span.sc { font-variant:small-caps }
span.roman { font-family:serif; font-weight:normal; }
span.sansserif { font-family:sans-serif; font-weight:normal; }
--></style>
</head>
<body>
<div class="node">
<a name="Saving-Data-on-Unexpected-Exits"></a>
<p>
Up: <a rel="up" accesskey="u" href="Simple-File-I_002fO.html#Simple-File-I_002fO">Simple File I/O</a>
<hr>
</div>
<h5 class="subsubsection">14.1.3.1 Saving Data on Unexpected Exits</h5>
<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><span class="samp">octave-core</span></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.
<!-- crash_dumps_octave_core src/load-save.cc -->
<p><a name="doc_002dcrash_005fdumps_005foctave_005fcore"></a>
<div class="defun">
— Built-in Function: <var>val</var> = <b>crash_dumps_octave_core</b> ()<var><a name="index-crash_005fdumps_005foctave_005fcore-955"></a></var><br>
— Built-in Function: <var>old_val</var> = <b>crash_dumps_octave_core</b> (<var>new_val</var>)<var><a name="index-crash_005fdumps_005foctave_005fcore-956"></a></var><br>
— Built-in Function: <b>crash_dumps_octave_core</b> (<var>new_val, "local"</var>)<var><a name="index-crash_005fdumps_005foctave_005fcore-957"></a></var><br>
<blockquote><p>Query or set the internal variable that controls whether Octave tries
to save all current variables to the file "octave-core" if it
crashes or receives a hangup, terminate or similar signal.
<p>When called from inside a function with the "local" option, the variable is
changed locally for the function and any subroutines it calls. The original
variable value is restored when exiting the function.
<!-- Texinfo @sp should work but in practice produces ugly results for HTML. -->
<!-- A simple blank line produces the correct behavior. -->
<!-- @sp 1 -->
<p class="noindent"><strong>See also:</strong> <a href="doc_002doctave_005fcore_005ffile_005flimit.html#doc_002doctave_005fcore_005ffile_005flimit">octave_core_file_limit</a>, <a href="doc_002doctave_005fcore_005ffile_005fname.html#doc_002doctave_005fcore_005ffile_005fname">octave_core_file_name</a>, <a href="doc_002doctave_005fcore_005ffile_005foptions.html#doc_002doctave_005fcore_005ffile_005foptions">octave_core_file_options</a>.
</p></blockquote></div>
<!-- sighup_dumps_octave_core src/sighandlers.cc -->
<p><a name="doc_002dsighup_005fdumps_005foctave_005fcore"></a>
<div class="defun">
— Built-in Function: <var>val</var> = <b>sighup_dumps_octave_core</b> ()<var><a name="index-sighup_005fdumps_005foctave_005fcore-958"></a></var><br>
— Built-in Function: <var>old_val</var> = <b>sighup_dumps_octave_core</b> (<var>new_val</var>)<var><a name="index-sighup_005fdumps_005foctave_005fcore-959"></a></var><br>
— Built-in Function: <b>sighup_dumps_octave_core</b> (<var>new_val, "local"</var>)<var><a name="index-sighup_005fdumps_005foctave_005fcore-960"></a></var><br>
<blockquote><p>Query or set the internal variable that controls whether Octave tries
to save all current variables to the file "octave-core" if it receives
a hangup signal.
<p>When called from inside a function with the "local" 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></blockquote></div>
<!-- sigterm_dumps_octave_core src/sighandlers.cc -->
<p><a name="doc_002dsigterm_005fdumps_005foctave_005fcore"></a>
<div class="defun">
— Built-in Function: <var>val</var> = <b>sigterm_dumps_octave_core</b> ()<var><a name="index-sigterm_005fdumps_005foctave_005fcore-961"></a></var><br>
— Built-in Function: <var>old_val</var> = <b>sigterm_dumps_octave_core</b> (<var>new_val</var>)<var><a name="index-sigterm_005fdumps_005foctave_005fcore-962"></a></var><br>
— Built-in Function: <b>sigterm_dumps_octave_core</b> (<var>new_val, "local"</var>)<var><a name="index-sigterm_005fdumps_005foctave_005fcore-963"></a></var><br>
<blockquote><p>Query or set the internal variable that controls whether Octave tries
to save all current variables to the file "octave-core" if it receives
a terminate signal.
<p>When called from inside a function with the "local" 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></blockquote></div>
<!-- octave_core_file_options src/load-save.cc -->
<p><a name="doc_002doctave_005fcore_005ffile_005foptions"></a>
<div class="defun">
— Built-in Function: <var>val</var> = <b>octave_core_file_options</b> ()<var><a name="index-octave_005fcore_005ffile_005foptions-964"></a></var><br>
— Built-in Function: <var>old_val</var> = <b>octave_core_file_options</b> (<var>new_val</var>)<var><a name="index-octave_005fcore_005ffile_005foptions-965"></a></var><br>
— Built-in Function: <b>octave_core_file_options</b> (<var>new_val, "local"</var>)<var><a name="index-octave_005fcore_005ffile_005foptions-966"></a></var><br>
<blockquote><p>Query or set the internal variable that specifies the options used for
saving the workspace data if Octave aborts. 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>When called from inside a function with the "local" option, the variable is
changed locally for the function and any subroutines it calls. The original
variable value is restored when exiting the function.
<!-- Texinfo @sp should work but in practice produces ugly results for HTML. -->
<!-- A simple blank line produces the correct behavior. -->
<!-- @sp 1 -->
<p class="noindent"><strong>See also:</strong> <a href="doc_002dcrash_005fdumps_005foctave_005fcore.html#doc_002dcrash_005fdumps_005foctave_005fcore">crash_dumps_octave_core</a>, <a href="doc_002doctave_005fcore_005ffile_005fname.html#doc_002doctave_005fcore_005ffile_005fname">octave_core_file_name</a>, <a href="doc_002doctave_005fcore_005ffile_005flimit.html#doc_002doctave_005fcore_005ffile_005flimit">octave_core_file_limit</a>.
</p></blockquote></div>
<!-- octave_core_file_limit src/load-save.cc -->
<p><a name="doc_002doctave_005fcore_005ffile_005flimit"></a>
<div class="defun">
— Built-in Function: <var>val</var> = <b>octave_core_file_limit</b> ()<var><a name="index-octave_005fcore_005ffile_005flimit-967"></a></var><br>
— Built-in Function: <var>old_val</var> = <b>octave_core_file_limit</b> (<var>new_val</var>)<var><a name="index-octave_005fcore_005ffile_005flimit-968"></a></var><br>
— Built-in Function: <b>octave_core_file_limit</b> (<var>new_val, "local"</var>)<var><a name="index-octave_005fcore_005ffile_005flimit-969"></a></var><br>
<blockquote><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>). 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>When called from inside a function with the "local" option, the variable is
changed locally for the function and any subroutines it calls. The original
variable value is restored when exiting the function.
<!-- Texinfo @sp should work but in practice produces ugly results for HTML. -->
<!-- A simple blank line produces the correct behavior. -->
<!-- @sp 1 -->
<p class="noindent"><strong>See also:</strong> <a href="doc_002dcrash_005fdumps_005foctave_005fcore.html#doc_002dcrash_005fdumps_005foctave_005fcore">crash_dumps_octave_core</a>, <a href="doc_002doctave_005fcore_005ffile_005fname.html#doc_002doctave_005fcore_005ffile_005fname">octave_core_file_name</a>, <a href="doc_002doctave_005fcore_005ffile_005foptions.html#doc_002doctave_005fcore_005ffile_005foptions">octave_core_file_options</a>.
</p></blockquote></div>
<!-- octave_core_file_name src/load-save.cc -->
<p><a name="doc_002doctave_005fcore_005ffile_005fname"></a>
<div class="defun">
— Built-in Function: <var>val</var> = <b>octave_core_file_name</b> ()<var><a name="index-octave_005fcore_005ffile_005fname-970"></a></var><br>
— Built-in Function: <var>old_val</var> = <b>octave_core_file_name</b> (<var>new_val</var>)<var><a name="index-octave_005fcore_005ffile_005fname-971"></a></var><br>
— Built-in Function: <b>octave_core_file_name</b> (<var>new_val, "local"</var>)<var><a name="index-octave_005fcore_005ffile_005fname-972"></a></var><br>
<blockquote><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.
The default value is <code>"octave-core"</code>
<p>When called from inside a function with the "local" option, the variable is
changed locally for the function and any subroutines it calls. The original
variable value is restored when exiting the function.
<!-- Texinfo @sp should work but in practice produces ugly results for HTML. -->
<!-- A simple blank line produces the correct behavior. -->
<!-- @sp 1 -->
<p class="noindent"><strong>See also:</strong> <a href="doc_002dcrash_005fdumps_005foctave_005fcore.html#doc_002dcrash_005fdumps_005foctave_005fcore">crash_dumps_octave_core</a>, <a href="doc_002doctave_005fcore_005ffile_005fname.html#doc_002doctave_005fcore_005ffile_005fname">octave_core_file_name</a>, <a href="doc_002doctave_005fcore_005ffile_005foptions.html#doc_002doctave_005fcore_005ffile_005foptions">octave_core_file_options</a>.
</p></blockquote></div>
</body></html>
