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
180
181
182
183
184
|
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<!-- Created by GNU Texinfo 6.7, 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 (version 6.2.0))</title>
<meta name="description" content="Saving Data on Unexpected Exits (GNU Octave (version 6.2.0))">
<meta name="keywords" content="Saving Data on Unexpected Exits (GNU Octave (version 6.2.0))">
<meta name="resource-type" content="document">
<meta name="distribution" content="global">
<meta name="Generator" content="makeinfo">
<link href="index.html" rel="start" title="Top">
<link href="Concept-Index.html" rel="index" title="Concept Index">
<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
<link href="Simple-File-I_002fO.html" rel="up" title="Simple File I/O">
<link href="C_002dStyle-I_002fO-Functions.html" rel="next" title="C-Style I/O Functions">
<link href="Simple-File-I_002fO.html" rel="prev" title="Simple File I/O">
<style type="text/css">
<!--
a.summary-letter {text-decoration: none}
blockquote.indentedblock {margin-right: 0em}
div.display {margin-left: 3.2em}
div.example {margin-left: 3.2em}
div.lisp {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}
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">
<span id="Saving-Data-on-Unexpected-Exits"></span><div class="header">
<p>
Up: <a href="Simple-File-I_002fO.html" 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" title="Index" rel="index">Index</a>]</p>
</div>
<hr>
<span id="Saving-Data-on-Unexpected-Exits-1"></span><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>
<span id="XREFcrash_005fdumps_005foctave_005fcore"></span><dl>
<dt id="index-crash_005fdumps_005foctave_005fcore">: <em><var>val</var> =</em> <strong>crash_dumps_octave_core</strong> <em>()</em></dt>
<dt id="index-crash_005fdumps_005foctave_005fcore-1">: <em><var>old_val</var> =</em> <strong>crash_dumps_octave_core</strong> <em>(<var>new_val</var>)</em></dt>
<dt id="index-crash_005fdumps_005foctave_005fcore-2">: <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>
<span id="XREFsighup_005fdumps_005foctave_005fcore"></span><dl>
<dt id="index-sighup_005fdumps_005foctave_005fcore">: <em><var>val</var> =</em> <strong>sighup_dumps_octave_core</strong> <em>()</em></dt>
<dt id="index-sighup_005fdumps_005foctave_005fcore-1">: <em><var>old_val</var> =</em> <strong>sighup_dumps_octave_core</strong> <em>(<var>new_val</var>)</em></dt>
<dt id="index-sighup_005fdumps_005foctave_005fcore-2">: <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>
<span id="XREFsigquit_005fdumps_005foctave_005fcore"></span><dl>
<dt id="index-sigquit_005fdumps_005foctave_005fcore">: <em><var>val</var> =</em> <strong>sigquit_dumps_octave_core</strong> <em>()</em></dt>
<dt id="index-sigquit_005fdumps_005foctave_005fcore-1">: <em><var>old_val</var> =</em> <strong>sigquit_dumps_octave_core</strong> <em>(<var>new_val</var>)</em></dt>
<dt id="index-sigquit_005fdumps_005foctave_005fcore-2">: <em></em> <strong>sigquit_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 quit 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>
<span id="XREFsigterm_005fdumps_005foctave_005fcore"></span><dl>
<dt id="index-sigterm_005fdumps_005foctave_005fcore">: <em><var>val</var> =</em> <strong>sigterm_dumps_octave_core</strong> <em>()</em></dt>
<dt id="index-sigterm_005fdumps_005foctave_005fcore-1">: <em><var>old_val</var> =</em> <strong>sigterm_dumps_octave_core</strong> <em>(<var>new_val</var>)</em></dt>
<dt id="index-sigterm_005fdumps_005foctave_005fcore-2">: <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>
<span id="XREFoctave_005fcore_005ffile_005foptions"></span><dl>
<dt id="index-octave_005fcore_005ffile_005foptions">: <em><var>val</var> =</em> <strong>octave_core_file_options</strong> <em>()</em></dt>
<dt id="index-octave_005fcore_005ffile_005foptions-1">: <em><var>old_val</var> =</em> <strong>octave_core_file_options</strong> <em>(<var>new_val</var>)</em></dt>
<dt id="index-octave_005fcore_005ffile_005foptions-2">: <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>
<span id="XREFoctave_005fcore_005ffile_005flimit"></span><dl>
<dt id="index-octave_005fcore_005ffile_005flimit">: <em><var>val</var> =</em> <strong>octave_core_file_limit</strong> <em>()</em></dt>
<dt id="index-octave_005fcore_005ffile_005flimit-1">: <em><var>old_val</var> =</em> <strong>octave_core_file_limit</strong> <em>(<var>new_val</var>)</em></dt>
<dt id="index-octave_005fcore_005ffile_005flimit-2">: <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
that Octave will save when writing a crash dump file.
</p>
<p>The limit is measured in kilobytes and is applied to the top-level workspace.
The name of the crash dump 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>
<span id="XREFoctave_005fcore_005ffile_005fname"></span><dl>
<dt id="index-octave_005fcore_005ffile_005fname">: <em><var>val</var> =</em> <strong>octave_core_file_name</strong> <em>()</em></dt>
<dt id="index-octave_005fcore_005ffile_005fname-1">: <em><var>old_val</var> =</em> <strong>octave_core_file_name</strong> <em>(<var>new_val</var>)</em></dt>
<dt id="index-octave_005fcore_005ffile_005fname-2">: <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" 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" title="Index" rel="index">Index</a>]</p>
</div>
</body>
</html>
|
