2
0
mirror of https://github.com/HDFGroup/hdf5.git synced 2025-04-24 17:51:25 +08:00

[svn-r6704]

Purpose:
    Add new function.

Description:
    Added H5set_free_list_limits.

Platforms tested:
    Safari, IE 5
This commit is contained in:
Frank Baker 2003-04-17 16:02:41 -05:00
parent 242f50e03e
commit e68390cdc5

@ -65,6 +65,7 @@ and it users.
</ul>
</td><td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</td><td valign=top>
<ul>
<li><a href="#Library-SetFreeListLimits">H5set_free_list_limits</a>
<li><a href="#Library-GarbageCollect">H5garbage_collect</a>
<li><a href="#Library-DontAtExit">H5dont_atexit</a>
</ul>
@ -99,6 +100,7 @@ facilitate moving easily between them.</i>
</ul>
</td><td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</td><td valign=top>
<ul>
<!--<li><a href="#Library-SetFreeListLimits">h5set_free_list_limits_f</a>-->
<li><a href="#Library-GarbageCollect">h5garbage_collect_f</a>
<li><a href="#Library-DontAtExit">h5dont_atexit_f</a>
</ul>
@ -166,6 +168,71 @@ facilitate moving easily between them.</i>
</dl>
<hr>
<dl>
<dt><strong>Name:</strong> <a name="Library-SetFreeListLimits">H5set_free_list_limits</a>
<dt><strong>Signature:</strong>
<dd><em>herr_t</em> <code>H5set_free_list_limits</code>(<em>int</em> <code>reg_global_lim</code>,
<em>int</em> <code>reg_list_lim</code>,
<em>int</em> <code>arr_global_lim</code>,
<em>int</em> <code>arr_list_lim</code>,
<em>int</em> <code>blk_global_lim</code>,
<em>int</em> <code>blk_list_lim</code>
)
<dt><strong>Purpose:</strong>
<dd>Sets free-list size limits.
<dt><strong>Description:</strong>
<dd><code>H5set_free_list_limits</code> sets size limits
on all types of free lists.
Free lists are
<b><font color="red "size="+1">
... just what, exactly?
</font></b>
<p>
These are global limits, but each limit applies only to
free lists of the specified type.
Therefore, if an application sets a 1Mb limit on each of
the global lists, up to 3Mb of total storage might be
allocated, 1Mb for each of the regular, array, and
block type lists.
<p>
Using a value of <code?>-1</code> for a limit means that
no limit is set for the specified type of free list.
<dt><strong>Parameters:</strong>
<dl>
<dt><b><font color="red "size="+1">
Why is <i>regular</i> quoted below?
What would be, say, <i>irregular</i>?
</font></b>
<dt><em>int</em> <code>reg_global_lim</code>
<dd>IN: The limit on all "regular" free list memory used
<dt><em>int</em> <code>reg_list_lim</code>
<dd>IN: The limit on memory used in each "regular" free list
<dt><em>int</em> <code>arr_global_lim</code>
<dd>IN: The limit on all "array" free list memory used
<dt><em>int</em> <code>arr_list_lim</code>
<dd>IN: The limit on memory used in each "array" free list
<dt><em>int</em> <code>blk_global_lim</code>
<dd>IN: The limit on all "block" free list memory used
<dt><em>int</em> <code>blk_list_lim</code>
<dd>IN: The limit on memory used in each "block" free list
</dl>
<dt><strong>Returns:</strong>
<dd>Returns a non-negative value if successful;
otherwise returns a negative value.
<!--
<dt><strong>Non-C API(s):</strong>
<dd><a href="fortran/h5_FORTRAN.html#h5set_free_list_limits_f"
target="FortranWin"><img src="Graphics/FORTRAN.gif" border=0></a>
--> <!--
<img src="Graphics/Java.gif">
<img src="Graphics/C++.gif">
-->
</dl>
<hr>
<dl>
<dt><strong>Name:</strong> <a name="Library-GarbageCollect">H5garbage_collect</a>
@ -415,7 +482,7 @@ And in this document, the
Describes HDF5 Release 1.5, Unreleased Development Branch
</address><!-- #EndLibraryItem -->
Last modified: 3 April 2003
Last modified: 11 April 2003
</body>
</html>