mirror of
https://github.com/HDFGroup/hdf5.git
synced 2025-02-05 15:42:32 +08:00
1c576affc6
Purpose:
Two more new tools.
Description:
Add h5diff and h5c++ to new tools list.
Minor formatting fixes.
Platforms tested:
IE 5, Safari
682 lines
26 KiB
HTML
Executable File
682 lines
26 KiB
HTML
Executable File
<html>
|
|
<head>
|
|
<title>HDF5 Software Changes</title>
|
|
|
|
<!-- #BeginLibraryItem "/ed_libs/styles_Gen.lbi" --><link href="../ed_styles/GenElect.css" rel="stylesheet" type="text/css"><!-- #EndLibraryItem --></head>
|
|
|
|
<body bgcolor="#FFFFFF">
|
|
|
|
|
|
<!-- #BeginLibraryItem "/ed_libs/NavBar_ADevG.lbi" --><hr>
|
|
<center>
|
|
<table border=0 width=98%>
|
|
<tr><td valign=top align=left>
|
|
<a href="../index.html">HDF5 documents and links</a> <br>
|
|
<a href="../H5.intro.html">Introduction to HDF5</a> <br>
|
|
<!--
|
|
<a href="Glossary.html">Glossary</a><br>
|
|
-->
|
|
</td>
|
|
<td valign=top align=right>
|
|
<a href="../H5.user.html">HDF5 User's Guide</a> <br>
|
|
<a href="../RM_H5Front.html">HDF5 Reference Manual</a> <br>
|
|
<a href="../ADGuide.html">HDF5 Application Developer's Guide</a> <br>
|
|
</td></tr>
|
|
</table>
|
|
</center>
|
|
<hr>
|
|
<!-- #EndLibraryItem --><center>
|
|
<h1>HDF5 Software Changes from Release to Release</h1>
|
|
</center>
|
|
|
|
This document is intended to assist application developers who must keep
|
|
an application synchronized with the HDF5 library or related software.
|
|
|
|
|
|
<h2>Development Release 1.5 <br>(current development toward Production Release 1.6)</h2>
|
|
|
|
<dir>
|
|
|
|
This section lists the API-level changes that have been made during the
|
|
Release 1.5 development phase. (The development release number, 1.5,
|
|
will be used to describe this version until this the current development
|
|
cycle is completed, at which point it will be promoted to a production
|
|
release. The first production release of this code will be as Release 1.6.)
|
|
|
|
<p>
|
|
Note that changes at the subrelease level in the Release 1.4 production
|
|
branch, i.e., Releases 1.4.1, 1.4.2, ..., are summarized in the
|
|
Release 1.4.x versions of this document; they are not reported here.
|
|
|
|
<h3>New Functions and Tools</h3>
|
|
<dl>
|
|
<dt>The following functions are new for Release 1.5 and are included in the
|
|
<a href="../RM_H5Front.html"><cite>HDF5 Reference Manual</cite></a>.
|
|
|
|
<dd>
|
|
<table border="0">
|
|
<tr>
|
|
<td align="left" valign="top"><code>H5Dget_offset</code></td>
|
|
<td align="left" valign="top"><em>hsize_t</em> <code>H5Dget_offset</code> (<em>hid_t </em><code>dset_id</code>)</td>
|
|
</tr>
|
|
<tr>
|
|
<td align="left" valign="top"><code>H5Dget_space_status</code></td>
|
|
<td align="left" valign="top"><em>hid_t</em> <code>H5Dget_space_status</code> (<em>hid_t</em>
|
|
<code>dset_id</code>, <em>H5D_space_status_t *</em><code>status</code>)
|
|
</td>
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td align="left" valign="top"><code>H5Fget_obj_ids</code></td>
|
|
<td align="left" valign="top">
|
|
<em>int </em><code>H5Fget_obj_ids</code> (<em>hid_t</em> <code>file_id</code>,
|
|
<em>unsigned int</em> <code>types</code>,
|
|
<em>int</em> <code>max_objs</code>, <em>hid_t *</em><code>obj_id_list</code>)
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td align="left" valign="top"><code>H5Fget_vfd_handle</code></td>
|
|
<td align="left" valign="top">
|
|
<em>herr_t </em><code>H5Fget_vfd_handle</code> (<em>hid_t</em> <code>file_id</code>,
|
|
<em>hid_t</em> <code>fapl_id</code>, <em>void *</em><code>file_handle</code>)
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td align="left" valign="top"><code>H5Gget_num_objs</code></td>
|
|
<td align="left" valign="top">
|
|
<em>herr_t</em> <code>H5Gget_num_objs</code> (<em>hid_t</em> <code>loc_id</code>,
|
|
<em>hsize_t* </em> <code>num_obj</code>)
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td align="left" valign="top"><code>H5Gget_objname_by_idx</code></td>
|
|
<td align="left" valign="top">
|
|
<em>ssize_t</em> <code>H5Gget_objname_by_idx</code> (<em>hid_t</em> <code>group_id</code>,
|
|
<em>hsize_t</em> <code>idx</code>, <em>char *</em><code>name</code>,
|
|
<em>size_t*</em> <code>size</code>)
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td align="left" valign="top"><code>H5Gget_objtype_by_idx</code></td>
|
|
<td align="left" valign="top">
|
|
<em>int</em> <code>H5Gget_objtype_by_idx</code> (<em>hid_t</em> <code>group_id</code>,
|
|
<em>hsize_t</em> <code>idx</code>)
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td align="left" valign="top"><code>H5Iget_name</code></td>
|
|
<td align="left" valign="top">
|
|
<em>ssize_t</em> <code>H5Iget_name</code> (<em>hid_t</em> <code>obj_id</code>,
|
|
<em>char *</em><code>name</code>, <em>size_t</em> <code>size</code>)
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td align="left" valign="top"><code>H5Pall_filters_avail</code></td>
|
|
<td align="left" valign="top">
|
|
<em>htri_t</em> <code>H5Pall_filters_avail</code> (<em>hid_t</em> <code>dcpl_id</code>)
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td align="left" valign="top"><code>H5Pfill_value_defined</code></td>
|
|
<td align="left" valign="top">
|
|
<em>herr_t </em><code>H5Pfill_value_defined</code> (<em>hid_t</em> <code>plist_id</code>,
|
|
<em>H5D_fill_value_t *</em><code>status</code>)
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td align="left" valign="top"><code>H5Pget_alloc_time</code></td>
|
|
<td align="left" valign="top">
|
|
<em>herr_t </em><code>H5Pget_alloc_time</code> (<em>hid_t</em> <code>plist_id</code>,
|
|
<em>H5D_alloc_time_t *</em><code>alloc_time</code>)
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td align="left" valign="top"><code>H5Pget_edc_check</code></td>
|
|
<td align="left" valign="top">
|
|
<em>H5Z_EDC_t</em> <code>H5Pget_edc_check</code> (<em>hid_t</em>
|
|
<code>plist</code>)
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td align="left" valign="top"><code>H5Pget_family_offset</code></td>
|
|
<td align="left" valign="top">
|
|
<em>herr_t</em> <code>H5Pget_family_offset</code> (<em>hid_t</em> <code>fapl_id</code>,
|
|
<em>hsize_t *</em><code>offset</code>)
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td align="left" valign="top"><code>H5Pget_fapl_mpiposix</code></td>
|
|
<td align="left" valign="top">
|
|
<em>herr_t</em> <code>H5Pget_fapl_mpiposix</code> (<em>hid_t</em> <code>fapl_id</code>,
|
|
<em>MPI_Comm *</em><code>comm</code>)
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td align="left" valign="top"><code>H5Pget_fill_time</code></td>
|
|
<td align="left" valign="top">
|
|
<em>herr_t </em><code>H5Pget_fill_time</code> (<em>hid_t</em> <code>plist_id</code>,
|
|
<em>H5D_fill_time_t *</em><code>fill_time</code>)
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td align="left" valign="top"><code>H5Pget_filter_by_id</code></td>
|
|
<td align="left" valign="top">
|
|
<em>herr_t</em> <code>H5Pget_filter_by_id</code> (<em>hid_t</em> <code>plist_id</code>,
|
|
<em>H5Z_filter_t</em> <code>filter</code>, <em>unsigned int *</em><code>flags</code>,
|
|
<em>size_t *</em><code>cd_nelmts</code>, <em>unsigned int</em> <code>cd_values[]</code>,
|
|
<em>size_t</em> <code>namelen</code>, <em>char *</em><code>name[]</code>)
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td align="left" valign="top"><code>H5Pget_hyper_vector_size</code></td>
|
|
<td align="left" valign="top">
|
|
<em>herr_t</em> <code>H5Pget_hyper_vector_size</code> (<em>hid_t</em> <code>dxpl_id</code>,
|
|
<em>size_t *</em><code>vector_size</code>)
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td align="left" valign="top"><code>H5Pget_multi_type</code></td>
|
|
<td align="left" valign="top">
|
|
<em>herr_t</em> <code>H5Pget_multi_type</code> (<em>hid_t</em> <code>fapl_id</code>,
|
|
<em>H5FD_mem_t *</em><code>type</code>)
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td align="left" valign="top"><code>H5Pmodify_filter</code></td>
|
|
<td align="left" valign="top">
|
|
<em>herr_t</em> <code>H5Pmodify_filter</code> (<em>hid_t</em> <code>plist</code>,
|
|
<em>H5Z_filter_t</em> <code>filter</code>, <em>unsigned int</em> <code>flags</code>,
|
|
<em>size_t</em> <code>cd_nelmts</code>, <em>const unsigned int</em> <code>cd_values[]</code>)
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td align="left" valign="top"><code>H5Pset_alloc_time</code></td>
|
|
<td align="left" valign="top">
|
|
<em>herr_t </em><code>H5Pset_alloc_time</code> (<em>hid_t</em>
|
|
<code>plist_id</code>, <em>H5D_alloc_time_t</em> <code>alloc_time</code>)
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td align="left" valign="top"><code>H5Pset_edc_check</code></td>
|
|
<td align="left" valign="top">
|
|
<em>herr_t</em> <code>H5Pset_edc_check</code> (<em>hid_t</em>
|
|
<code>plist</code>, <em>H5Z_EDC_t</em> <code>check</code>)
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td align="left" valign="top"><code>H5Pset_family_offset</code></td>
|
|
<td align="left" valign="top">
|
|
<em>herr_t</em> <code>H5Pset_family_offset</code> (<em>hid_t</em> <code>fapl_id</code>,
|
|
<em>hsize_t</em> <code>offset</code>)
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td align="left" valign="top"><code>H5Pset_fapl_mpiposix</code></td>
|
|
<td align="left" valign="top">
|
|
<em>herr_t</em> <code>H5Pset_fapl_mpiposix</code> (<em>hid_t</em> <code>fapl_id</code>,
|
|
<em>MPI_Comm</em> <code>comm</code>)
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td align="left" valign="top"><code>H5Pset_fill_time</code></td>
|
|
<td align="left" valign="top">
|
|
<em>herr_t </em><code>H5Pset_fill_time</code> (<em>hid_t</em> <code>plist_id</code>,
|
|
<em>H5D_fill_time_t</em> <code>fill_time</code>)
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td align="left" valign="top"><code>H5Pset_filter</code></td>
|
|
<td align="left" valign="top">
|
|
<em>herr_t</em> <code>H5Pset_filter</code>
|
|
(<em>hid_t</em> <code>plist</code>, <em>H5Z_filter_t</em> <code>filter</code>,
|
|
<em>unsigned int</em> <code>flags</code>, <em>size_t</em> <code>cd_nelmts</code>,
|
|
<em>const unsigned int</em> <code>cd_values[])</code>
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td align="left" valign="top"><code>H5Pset_filter_callback</code></td>
|
|
<td align="left" valign="top">
|
|
<em>herr_t</em> <code>H5Pset_filter_callback</code> (<em>hid_t</em>
|
|
<code>plist</code>, <em>H5Z_filter_func_t</em> <code>func</code>,
|
|
<em>void *</em><code>op_data</code>)
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td align="left" valign="top"><code>H5Pset_fletcher32</code></td>
|
|
<td align="left" valign="top">
|
|
<em>herr_t</em> <code>H5Pset_fletcher32</code> (<em>hid_t</em>
|
|
<code>plist</code>)
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td align="left" valign="top"><code>H5Pset_hyper_vector_size</code> </td>
|
|
<td align="left" valign="top">
|
|
<em>herr_t</em> <code>H5Pset_hyper_vector_size</code> (<em>hid_t</em> <code>dxpl_id</code>,
|
|
<em>size_t</em> <code>vector_size</code>)
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td align="left" valign="top"><code>H5Pset_multi_type</code></td>
|
|
<td align="left" valign="top">
|
|
<em>herr_t</em> <code>H5Pset_multi_type</code> (<em>hid_t</em> <code>fapl_id</code>,
|
|
<em>H5FD_mem_t</em> <code>type</code>)
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td align="left" valign="top"><code>H5Pset_shuffle</code></td>
|
|
<td align="left" valign="top">
|
|
<em>herr_t</em> <code>H5Pset_shuffle</code> (<em>hid_t</em> <code>plist_id</code>)
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td align="left" valign="top"><code>H5Pset_szip</code></td>
|
|
<td align="left" valign="top">
|
|
<em>herr_t</em> <code>H5Pset_szip</code> (<em>hid_t</em> <code>plist</code>,
|
|
<em>unsigned int</em> <code>options_mask</code>, <em>unsigned int</em>
|
|
<code>pixels_per_block</code>)
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td align="left" valign="top"><code>H5Rget_object_type</code></td>
|
|
<td align="left" valign="top">
|
|
<em>int</em> <code>H5Rget_object_type</code> (<em>hid_t</em> <code>id</code>,
|
|
<em>void *</em><code>ref</code>)
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td align="left" valign="top"><code>H5set_free_list_limits</code></td>
|
|
<td align="left" valign="top">
|
|
<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>)
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td align="left" valign="top"><code>H5Sget_select_type</code></td>
|
|
<td align="left" valign="top">
|
|
<em>H5S_sel_type</em> <code>H5Sget_select_type</code> (<em>hid_t</em> <code>space_id</code>)
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td align="left" valign="top"><code>H5Tdetect_class</code></td>
|
|
<td align="left" valign="top">
|
|
<em>htri_t </em><code>H5Tdetect_class</code> (<em>hid_t</em> <code>dtype_id</code>,
|
|
<em>H5T_class_t</em> <code>dtype_class</code>)
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td align="left" valign="top"><code>H5Tget_native_type</code></td>
|
|
<td align="left" valign="top">
|
|
<em>hid_t</em> <code>H5Tget_native_type</code> (<em>hid_t</em> <code>type_id</code>,
|
|
<em>H5T_direction_t</em> <code>direction</code>)
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td align="left" valign="top"><code>H5Tis_variable_str</code></td>
|
|
<td align="left" valign="top">
|
|
<em>htri_t </em><code>H5Tis_variable_str</code> (<em>hid_t </em><code>dtype_id</code>)
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td align="left" valign="top"><code>H5Zfilter_avail</code></td>
|
|
<td align="left" valign="top">
|
|
<em>herr_t</em> <code>H5Zfilter_avail</code> (<em>H5Z_filter_t</em> <code>filter</code>)
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td align="left" valign="top"><code>H5Zunregister</code></td>
|
|
<td align="left" valign="top">
|
|
<em>herr_t</em> <code>H5Zunregister</code> (<em>H5Z_filter_t</em> <code>filter</code>)
|
|
</td>
|
|
</tr>
|
|
</table>
|
|
</dd>
|
|
<dd> </dd>
|
|
|
|
</dt>
|
|
<dt>The following tools are new for Release 1.5 and are included in the
|
|
<a href="../RM_H5Front.html"><cite>HDF5 Reference Manual</cite></a>.
|
|
<dd><code>h5diff</code>
|
|
<dd><code>h5import</code>
|
|
<dd><code>h5fc</code>
|
|
<dd><code>h5c++</code>
|
|
<dd><code>h5perf</code>
|
|
<dd><code>h5redeploy</code>
|
|
</dt>
|
|
</dl>
|
|
|
|
|
|
<h3>Deleted Functions</h3>
|
|
The following functions have been removed from the HDF5 library
|
|
and from the <cite>HDF5 Reference Manual</cite>.
|
|
<dir>
|
|
<table border=0>
|
|
<tr valign="top" align="left"><td>
|
|
|
|
</td><td>
|
|
<pre>
|
|
H5function1
|
|
H5function2
|
|
</pre>
|
|
</td><td>
|
|
|
|
</td><td>
|
|
<pre>
|
|
H5function3
|
|
H5function4
|
|
</pre>
|
|
</td><td>
|
|
|
|
</td><td>
|
|
<pre>
|
|
H5function5
|
|
H5function6
|
|
</pre>
|
|
</td></tr>
|
|
</table>
|
|
</dir>
|
|
|
|
|
|
<h3>Functions with Changed Syntax</h3>
|
|
The following functions have changed slightly.
|
|
<dir>
|
|
<dl>
|
|
<dt><code>H5FDflush and VFL "flush" callbacks</code>
|
|
<dd>An extra parameter 'closing' has been added to these functions,
|
|
to allow the library to indicate that the file will be closed
|
|
following the call to "flush". Actions in the "flush" call
|
|
that are duplicated in the VFL "close" call may be omitted by
|
|
the VFL driver.
|
|
<dt><code>H5Sget_select_bounds</code>
|
|
<dd>The 'start' and 'end' parameters have changed from
|
|
<code>'hsize_t *'</code>
|
|
to <code>'hssize_t *'</code> to better match the rest of the dataspace API.
|
|
<dt><code>h5pset(get)_fapl_core_f</code>
|
|
<dd>The 'backing_store' parameter has changed from
|
|
<code>INTEGER</code> to <code>LOGICAL</code> to match better C API
|
|
<dt><code>h5pset(get)_preserve_f</code>
|
|
<dd>The 'flag' parameter has changed from
|
|
<code>INTEGER</code> to <code>LOGICAL</code> to match better C API
|
|
<dt><code>H5function</code>
|
|
<dd>Description of change
|
|
</dl>
|
|
</dir>
|
|
|
|
<h3>Constants with Changed Values</h3>
|
|
|
|
|
|
</dir>
|
|
<p>
|
|
|
|
<h2>Release 1.4</h2>
|
|
|
|
<dir>
|
|
|
|
Note: Changes at the subrelease level, i.e., 1.4.1, 1.4.2, ..., are
|
|
summarized in the Release 1.4.x version of this document; they are not
|
|
reported here.
|
|
|
|
Several functions were added to or removed from the HDF5 library
|
|
in the development of Release 1.4.
|
|
A few functions have been modified in minor ways.
|
|
|
|
<h3>New Functions</h3>
|
|
The following functions are new for Release 1.4 and are included in the
|
|
<a href="../RM_H5Front.html"><cite>HDF5 Reference Manual</cite></a>.
|
|
|
|
<dir>
|
|
<pre>
|
|
herr_t <font color=red>H5Dvlen_get_buf_size</font> (hid_t dataset_id, hid_t type_id,
|
|
hid_t space_id, hsize_t *size);
|
|
herr_t <font color=red>H5Epush</font> (const char *file, const char *func,
|
|
unsigned line, H5E_major_t maj, H5E_minor_t min,
|
|
const char *str);
|
|
hid_t <font color=red>H5Pget_driver</font> (hid_t plist_id);
|
|
void *<font color=red>H5Pget_driver_info</font> (hid_t plist_id);
|
|
herr_t <font color=red>H5Pget_dxpl_mpio</font> (hid_t dxpl_id,
|
|
H5FD_mpio_xfer_t *xfer_mode/*out*/);
|
|
herr_t <font color=red>H5Pget_dxpl_multi</font> (hid_t dxpl_id,
|
|
hid_t *memb_dxpl/*out*/);
|
|
herr_t <font color=red>H5Pget_fapl_core</font> (hid_t fapl_id, size_t *increment/*out*/,
|
|
hbool_t *backing_store/*out*/)
|
|
herr_t <font color=red>H5Pget_fapl_family</font> (hid_t fapl_id,
|
|
hsize_t *memb_size/*out*/, hid_t *memb_fapl_id/*out*/);
|
|
herr_t <font color=red>H5Pget_fapl_mpio</font> (hid_t fapl_id, MPI_Comm *comm/*out*/,
|
|
MPI_Info *info/*out*/);
|
|
herr_t <font color=red>H5Pget_fapl_multi</font> (hid_t fapl_id,
|
|
H5FD_mem_t *memb_map/*out*/, hid_t *memb_fapl/*out*/,
|
|
char **memb_name/*out*/, haddr_t *memb_addr/*out*/,
|
|
hbool_t *relax/*out*/);
|
|
herr_t <font color=red>H5Pget_fapl_stream</font> (hid_t fapl_id,
|
|
H5FD_stream_fapl_t *fapl /*out*/ );
|
|
herr_t <font color=red>H5Pget_meta_block_size</font> (hid_t fapl_id,
|
|
hsize_t *size/*out*/);
|
|
herr_t <font color=red>H5Pget_sieve_buf_size</font> (hid_t fapl_id,
|
|
hsize_t *size/*out*/);
|
|
herr_t <font color=red>H5Pset_driver</font> (hid_t plist_id, hid_t driver_id,
|
|
const void *driver_info);
|
|
herr_t <font color=red>H5Pset_dxpl_mpio</font> (hid_t dxpl_id,
|
|
H5FD_mpio_xfer_t xfer_mode);
|
|
herr_t <font color=red>H5Pset_dxpl_multi</font> (hid_t dxpl_id,
|
|
const hid_t *memb_dxpl);
|
|
herr_t <font color=red>H5Pset_fapl_core</font> (hid_t fapl_id, size_t increment,
|
|
hbool_t backing_store)
|
|
herr_t <font color=red>H5Pset_fapl_family</font> (hid_t fapl_id, hsize_t memb_size,
|
|
hid_t memb_fapl_id);
|
|
herr_t <font color=red>H5Pset_fapl_log</font> (hid_t fapl_id, char *logfile,
|
|
int verbosity);
|
|
herr_t <font color=red>H5Pset_fapl_mpio</font> (hid_t fapl_id, MPI_Comm comm,
|
|
MPI_Info info);
|
|
herr_t <font color=red>H5Pset_fapl_multi</font> (hid_t fapl_id,
|
|
const H5FD_mem_t *memb_map, const hid_t *memb_fapl,
|
|
const char **memb_name, const haddr_t *memb_addr,
|
|
hbool_t relax);
|
|
herr_t <font color=red>H5Pset_fapl_sec2</font> (hid_t fapl_id);
|
|
herr_t <font color=red>H5Pset_fapl_split</font> (hid_t fapl, const char *meta_ext,
|
|
hid_t meta_plist_id, const char *raw_ext,
|
|
hid_t raw_plist_id);
|
|
herr_t <font color=red>H5Pset_fapl_stdio</font> (hid_t fapl_id);
|
|
herr_t <font color=red>H5Pset_fapl_stream</font> (hid_t fapl_id,
|
|
H5FD_stream_fapl_t *fapl);
|
|
herr_t <font color=red>H5Pset_meta_block_size</font>(hid_t fapl_id, hsize_t size);
|
|
herr_t <font color=red>H5Pset_sieve_buf_size</font>(hid_t fapl_id, hsize_t size);
|
|
hid_t <font color=red>H5Tarray_create</font> (hid_t base, int rank, const hsize_t dims[],
|
|
const int perm[])
|
|
int <font color=red>H5Tget_array_dims</font> (hid_t adtype_id, hsize_t *dims[], int *perm[])
|
|
int <font color=red>H5Tget_array_ndims</font> (hid_t adtype_id)
|
|
</pre>
|
|
</dir>
|
|
|
|
|
|
<p>
|
|
The following functions are new for Release 1.4, but
|
|
are intended only for use in specialized environments.
|
|
These are also included in the
|
|
<a href="../RM_H5Front.html"><cite>HDF5 Reference Manual</cite></a>.
|
|
|
|
<dir>
|
|
<pre>
|
|
herr_t <font color=red>H5Pget_fapl_dpss</font> (hid_t fapl_id);
|
|
herr_t <font color=red>H5Pget_fapl_gass</font> (hid_t fapl_id, GASS_Info *info/*out*/);
|
|
herr_t <font color=red>H5Pget_fapl_srb</font> (hid_t fapl_id, SRB_Info *info);
|
|
herr_t <font color=red>H5Pset_fapl_dpss</font> (hid_t fapl_id);
|
|
herr_t <font color=red>H5Pset_fapl_gass</font> (hid_t fapl_id, GASS_Info info);
|
|
herr_t <font color=red>H5Pset_fapl_srb</font> (hid_t fapl_id, SRB_Info info);
|
|
</pre>
|
|
</dir>
|
|
|
|
|
|
<p>
|
|
The following functions are new for Release 1.4 but are intended
|
|
only for driver development work, not for general use.
|
|
They are listed in the
|
|
<a href="../TechNotes/VFLfunc.html"><cite>List of VFL Functions</cite></a>
|
|
document in the
|
|
<a href="../TechNotes.html"><cite>HDF5 Technical Notes</cite></a>.
|
|
They are described in detail only in the source code and
|
|
do not appear in the <cite>HDF5 Reference Manual</cite>.
|
|
|
|
<dir>
|
|
<pre>
|
|
haddr_t <font color=red>H5FDalloc</font> (H5FD_t *file, H5FD_mem_t type,
|
|
hsize_t size);
|
|
herr_t <font color=red>H5FDclose</font> (H5FD_t *file);
|
|
int <font color=red>H5FDcmp</font> (const H5FD_t *f1, const H5FD_t *f2);
|
|
herr_t <font color=red>H5FDflush</font> (H5FD_t *file);
|
|
herr_t <font color=red>H5FDfree</font> (H5FD_t *file, H5FD_mem_t type,
|
|
haddr_t addr, hsize_t size);
|
|
haddr_t <font color=red>H5FDget_eoa</font> (H5FD_t *file);
|
|
haddr_t <font color=red>H5FDget_eof</font> (H5FD_t *file);
|
|
H5FD_t *<font color=red>H5FDopen</font> (const char *name, unsigned flags,
|
|
hid_t fapl_id, haddr_t maxaddr);
|
|
int <font color=red>H5FDquery</font> (const H5FD_t *f, unsigned long *flags);
|
|
herr_t <font color=red>H5FDread</font> (H5FD_t *file, hid_t dxpl_id, haddr_t addr,
|
|
hsize_t size, void *buf/*out*/);
|
|
haddr_t <font color=red>H5FDrealloc</font> (H5FD_t *file, H5FD_mem_t type,
|
|
haddr_t addr, hsize_t old_size, hsize_t new_size);
|
|
hid_t <font color=red>H5FDregister</font> (const H5FD_class_t *cls);
|
|
herr_t <font color=red>H5FDset_eoa</font> (H5FD_t *file, haddr_t eof);
|
|
herr_t <font color=red>H5FDunregister</font> (hid_t driver_id);
|
|
herr_t <font color=red>H5FDwrite</font> (H5FD_t *file, H5FD_mem_t type,
|
|
hid_t dxpl_id, haddr_t addr, hsize_t size,
|
|
const void *buf);
|
|
</pre>
|
|
</dir>
|
|
|
|
|
|
<h3>Deleted Functions</h3>
|
|
The following functions have been removed from the HDF5 library
|
|
and from the <cite>HDF5 Reference Manual</cite>.
|
|
<dir>
|
|
<table>
|
|
<tr valign=top align=left><td>
|
|
<pre>
|
|
H5Pget_core
|
|
H5Pget_driver
|
|
H5Pget_family
|
|
H5Pget_mpi
|
|
H5Pget_sec2
|
|
H5Pget_split
|
|
H5Pget_stdio
|
|
H5Pget_xfer
|
|
</pre>
|
|
</td><td>
|
|
|
|
</td><td>
|
|
<pre>
|
|
H5Pset_core
|
|
H5Pset_family
|
|
H5Pset_mpi
|
|
H5Pset_sec2
|
|
H5Pset_split
|
|
H5Pset_stdio
|
|
H5Pset_xfer
|
|
</pre>
|
|
</td><td>
|
|
|
|
</td><td>
|
|
<pre>
|
|
H5RAclose
|
|
H5RAcreate
|
|
H5RAopen
|
|
H5RAread
|
|
H5RAwrite
|
|
H5Tget_member_dims
|
|
H5Tinsert_array
|
|
</pre>
|
|
</td></tr>
|
|
</table>
|
|
</dir>
|
|
Note that the entire H5RA interface, an esperimental interface for
|
|
ragged arrays, has been removed from the library.
|
|
|
|
|
|
<h3>Functions with Changed Syntax</h3>
|
|
The following functions have changed slightly.
|
|
<dir>
|
|
<dl>
|
|
<dt><code>H5Pget_buffer</code>
|
|
<dd>Return type has changed to <em>hsize_t</em>.
|
|
<dt><code>H5Pset_buffer</code>
|
|
<dd>The type of the <code>size</code> parameter has changed
|
|
to <em>hsize_t</em>.
|
|
<dt><code>H5Tconvert</code>
|
|
<dd>The type of the <code>nelmts</code> parameter has changed
|
|
to <em>hsize_t</em>.
|
|
</dl>
|
|
</dir>
|
|
|
|
<h3>Constants with Changed Values</h3>
|
|
The values of the constants <code>H5P_DEFAULT</code> and
|
|
<code>H5S_ALL</code> have been changed from <code>-2</code>
|
|
to <code>0</code>.
|
|
These default values had to be special-cased in situations where
|
|
they could be returned to distinguish them from error values.
|
|
|
|
</dir>
|
|
<p>
|
|
|
|
|
|
<h2>This and Prior Releases: The RELEASE and HISTORY Files</h2>
|
|
|
|
<dir>
|
|
The HDF5 source code, as distributed to users and developers,
|
|
contains two files that will be of interest to readers of this
|
|
document. Both files are located at the top level of the
|
|
source code tree (i.e., in <code>.../hdf5/</code>) and are
|
|
duplicated here for your reference:
|
|
<p>
|
|
<dl>
|
|
<dt><a href="RELEASE.txt" target="ExtWin">RELEASE</a>
|
|
<dd>Technical notes regarding the release, including
|
|
new features and the changes since the last release,
|
|
notes regarding new or revised utilities,
|
|
notes regarding alternative language APIs (Fortran90, C++),
|
|
bugs fixed since the last release,
|
|
platforms on which the release has been tested,
|
|
and
|
|
known problems.
|
|
This is the file commonly known among developers as
|
|
"the release notes."
|
|
<p>
|
|
<dt><a href="HISTORY.txt" target="ExtWin">HISTORY</a>
|
|
<dd>A release-by-release history of the HDF5 library.
|
|
This file is a compiled set of the release notes
|
|
(i.e., the RELEASE files) from prior releases.
|
|
<dl>
|
|
</dir>
|
|
|
|
|
|
<!-- #BeginLibraryItem "/ed_libs/NavBar_ADevG.lbi" --><hr>
|
|
<center>
|
|
<table border=0 width=98%>
|
|
<tr><td valign=top align=left>
|
|
<a href="../index.html">HDF5 documents and links</a> <br>
|
|
<a href="../H5.intro.html">Introduction to HDF5</a> <br>
|
|
<!--
|
|
<a href="Glossary.html">Glossary</a><br>
|
|
-->
|
|
</td>
|
|
<td valign=top align=right>
|
|
<a href="../H5.user.html">HDF5 User's Guide</a> <br>
|
|
<a href="../RM_H5Front.html">HDF5 Reference Manual</a> <br>
|
|
<a href="../ADGuide.html">HDF5 Application Developer's Guide</a> <br>
|
|
</td></tr>
|
|
</table>
|
|
</center>
|
|
<hr>
|
|
<!-- #EndLibraryItem --><!-- #BeginLibraryItem "/ed_libs/Footer.lbi" --><address>
|
|
<a href="mailto:hdfhelp@ncsa.uiuc.edu">HDF Help Desk</a>
|
|
<br>
|
|
Describes HDF5 Release 1.5, Unreleased Development Branch
|
|
</address><!-- #EndLibraryItem -->
|
|
|
|
<!-- Created: Spring 1999 -->
|
|
<!-- hhmts start -->
|
|
Last modified: 25 June 2003
|
|
<!-- hhmts end -->
|
|
|
|
</body>
|
|
</html>
|