mirror of
https://github.com/HDFGroup/hdf5.git
synced 2025-03-13 16:47:58 +08:00
[svn-r3253]
Purpose: Clarifications in H5Pset_fapl_core. Platforms tested: IE 5
This commit is contained in:
parent
35bc545296
commit
c6b677dde6
@ -3756,7 +3756,6 @@ facilitate moving easily between them.</i>
|
||||
Storage Resource Broker (SRB). For further information, see
|
||||
<a href="http://www.npaci.edu/Research/DI/srb/">http//www.npaci.edu/Research/DI/srb/</a>.
|
||||
<dt><strong>Parameters:</strong>
|
||||
<dl>
|
||||
<dl>
|
||||
<dt><em>hid_t</em> <code>fapl_id</code>
|
||||
<dd>IN: File access property list identifier.
|
||||
@ -3794,12 +3793,22 @@ facilitate moving easily between them.</i>
|
||||
<dd><code>H5Pset_fapl_core</code> modifies the file access property list
|
||||
to use the <code>H5FD_CORE</code> driver.
|
||||
<p>
|
||||
<code>increment</code> specifies the increment by which allocated memory
|
||||
is to be increased each time more memory is required.
|
||||
The <code>H5FD_CORE</code> driver enables an application to work
|
||||
with a file in memory, speeding reads and writes as no disk access
|
||||
is made. File contents are stored only in memory until the file
|
||||
is closed. The <code>backing_store</code> parameter determines
|
||||
whether file contents are ever written to disk.
|
||||
<p>
|
||||
<code>increment</code> specifies the increment by which allocated
|
||||
memory is to be increased each time more memory is required.
|
||||
<p>
|
||||
If <code>backing_store</code> is set to <code>1</code>
|
||||
(<code>TRUE</code>), the file contents are flushed to a file
|
||||
with the same name as this core file.
|
||||
with the same name as this core file when the file is closed
|
||||
or access to the file is terminated in memory.
|
||||
<dt><strong>Note:</strong>
|
||||
<dd>There is currently no means for reading a file from disk then
|
||||
using the <code>H5FD_CORE</code> driver to manipulate the file.
|
||||
<dt><strong>Parameters:</strong>
|
||||
<dl>
|
||||
<dt><em>hid_t</em> <code>fapl_id</code>
|
||||
@ -3807,7 +3816,8 @@ facilitate moving easily between them.</i>
|
||||
<dt><em>size_t</em> <code>increment</code>
|
||||
<dd>IN: Size, in bytes, of memory increments.
|
||||
<dt><em>hbool_t</em> <code>backing_store</code>
|
||||
<dd>IN: Boolean flag indicating whether to create file.
|
||||
<dd>IN: Boolean flag indicating whether to write the file
|
||||
contents to disk when the file is closed.
|
||||
</dl>
|
||||
<dt><strong>Returns:</strong>
|
||||
<dd>Returns a non-negative value if successful.
|
||||
@ -3838,7 +3848,6 @@ facilitate moving easily between them.</i>
|
||||
<dt><strong>Description:</strong>
|
||||
<dd><code>H5Pget_fapl_core</code> queries the <code>H5FD_CORE</code>
|
||||
driver properties as set by <code>H5Pset_fapl_core</code>.
|
||||
|
||||
<dt><strong>Parameters:</strong>
|
||||
<dl>
|
||||
<dt><em>hid_t</em> <code>fapl_id</code>
|
||||
@ -3846,7 +3855,8 @@ facilitate moving easily between them.</i>
|
||||
<dt><em>size_t</em> *<code>increment</code>
|
||||
<dd>OUT: Size, in bytes, of memory increments.
|
||||
<dt><em>hbool_t</em> *<code>backing_store</code>
|
||||
<dd>OUT: Boolean flag indicating whether to create file.
|
||||
<dd>OUT: Boolean flag indicating whether to write the file
|
||||
contents to disk when the file is closed.
|
||||
</dl>
|
||||
<dt><strong>Returns:</strong>
|
||||
<dd>Returns a non-negative value if successful.
|
||||
|
Loading…
Reference in New Issue
Block a user