Files
hdf5/develop/rel_spec_110_change.html
T
2025-10-13 12:54:10 +00:00

745 lines
87 KiB
HTML

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "https://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
<meta http-equiv="X-UA-Compatible" content="IE=11"/>
<meta name="generator" content="Doxygen 1.13.2"/>
<meta name="viewport" content="width=device-width, initial-scale=1"/>
<title>HDF5: Release Software Changes for HDF5 1.10</title>
<link href="tabs.css" rel="stylesheet" type="text/css"/>
<script type="text/javascript" src="jquery.js"></script>
<script type="text/javascript" src="dynsections.js"></script>
<link href="navtree.css" rel="stylesheet" type="text/css"/>
<script type="text/javascript" src="navtreedata.js"></script>
<script type="text/javascript" src="navtree.js"></script>
<script type="text/javascript" src="resize.js"></script>
<script type="text/javascript" src="cookie.js"></script>
<link href="search/search.css" rel="stylesheet" type="text/css"/>
<script type="text/javascript" src="search/searchdata.js"></script>
<script type="text/javascript" src="search/search.js"></script>
<script type="text/javascript">
/* @license magnet:?xt=urn:btih:d3d9a9a6595521f9666a5e94cc830dab83b65699&amp;dn=expat.txt MIT */
$(function() { init_search(); });
/* @license-end */
</script>
<link href="doxygen.css" rel="stylesheet" type="text/css" />
<link href="hdf5doxy.css" rel="stylesheet" type="text/css"/>
<link href="doxygen-awesome.css" rel="stylesheet" type="text/css"/>
<link href="hdf5doxy.css" rel="stylesheet" type="text/css">
<script type="text/javascript" src="hdf5_navtree_hacks.js"></script>
<div style="background:#FFDDDD;font-size:120%;text-align:center;margin:0;padding:5px">Help us improve by taking our short survey: <a href="https://www.hdfgroup.org/website-survey/">https://www.hdfgroup.org/website-survey/</a></div>
<!-- ... other metadata & script includes ... -->
<script type="text/javascript" src="doxygen-awesome-tabs.js"></script>
<script type="text/javascript">
DoxygenAwesomeTabs.init()
</script>
<!-- Google tag (gtag.js) -->
<script async src="https://www.googletagmanager.com/gtag/js?id=G-57FMZK4S7X"></script>
<script>
window.dataLayer = window.dataLayer || [];
function gtag(){dataLayer.push(arguments);}
gtag('js', new Date());
gtag('config', 'G-57FMZK4S7X');
</script>
</head>
<body>
<div id="top"><!-- do not remove this div, it is closed by doxygen! -->
<div id="titlearea">
<table cellspacing="0" cellpadding="0">
<tbody>
<tr id="projectrow">
<td id="projectlogo"><img alt="Logo" src="HDFG-logo.png"/></td>
<td id="projectalign">
<div id="projectname">HDF5<span id="projectnumber">&#160;Last Updated on 2025-10-13</span>
</div>
<div id="projectbrief">The HDF5 Field Guide</div>
</td>
</tr>
</tbody>
</table>
</div>
<!-- end header part -->
<!-- Generated by Doxygen 1.13.2 -->
<script type="text/javascript">
/* @license magnet:?xt=urn:btih:d3d9a9a6595521f9666a5e94cc830dab83b65699&amp;dn=expat.txt MIT */
var searchBox = new SearchBox("searchBox", "search/",'.html');
/* @license-end */
</script>
<script type="text/javascript">
/* @license magnet:?xt=urn:btih:d3d9a9a6595521f9666a5e94cc830dab83b65699&amp;dn=expat.txt MIT */
$(function() { codefold.init(0); });
/* @license-end */
</script>
<div id="navrow1" class="tabs">
<ul class="tablist">
<li><a href="index.html"><span>Main&#160;Page</span></a></li>
<li><a href="_getting_started.html"><span>Getting&#160;started</span></a></li>
<li><a href="_u_g.html"><span>User&#160;Guide</span></a></li>
<li><a href="_r_m.html"><span>Reference&#160;Manual</span></a></li>
<li><a href="_cookbook.html"><span>Cookbook</span></a></li>
<li><a href="_t_n.html"><span>Technical&#160;Notes</span></a></li>
<li><a href="_r_f_c.html"><span>RFCs</span></a></li>
<li><a href="_s_p_e_c.html"><span>Specifications</span></a></li>
<li><a href="_g_l_s.html"><span>Glossary</span></a></li>
<li><a href="_f_t_s.html"><span>Full-Text&#160;Search</span></a></li>
<li><a href="_about.html"><span>About</span></a></li>
<li>
<div id="MSearchBox" class="MSearchBoxInactive">
<span class="left">
<span id="MSearchSelect" onmouseover="return searchBox.OnSearchSelectShow()" onmouseout="return searchBox.OnSearchSelectHide()">&#160;</span>
<input type="text" id="MSearchField" value="" placeholder="Search" accesskey="S"
onfocus="searchBox.OnSearchFieldFocus(true)"
onblur="searchBox.OnSearchFieldFocus(false)"
onkeyup="searchBox.OnSearchFieldChange(event)"/>
</span><span class="right">
<a id="MSearchClose" href="javascript:searchBox.CloseResultsWindow()"><img id="MSearchCloseImg" border="0" src="search/close.svg" alt=""/></a>
</span>
</div>
</li>
</ul>
</div>
</div><!-- top -->
<div id="side-nav" class="ui-resizable side-nav-resizable">
<div id="nav-tree">
<div id="nav-tree-contents">
<div id="nav-sync" class="sync"></div>
</div>
</div>
<div id="splitbar" style="-moz-user-select:none;"
class="ui-resizable-handle">
</div>
</div>
<script type="text/javascript">
/* @license magnet:?xt=urn:btih:d3d9a9a6595521f9666a5e94cc830dab83b65699&amp;dn=expat.txt MIT */
$(function(){initNavTree('rel_spec_110_change.html',''); initResizable(true); });
/* @license-end */
</script>
<div id="doc-content">
<!-- window showing the filter options -->
<div id="MSearchSelectWindow"
onmouseover="return searchBox.OnSearchSelectShow()"
onmouseout="return searchBox.OnSearchSelectHide()"
onkeydown="return searchBox.OnSearchSelectKey(event)">
</div>
<!-- iframe showing the search results (closed by default) -->
<div id="MSearchResultsWindow">
<div id="MSearchResults">
<div class="SRPage">
<div id="SRIndex">
<div id="SRResults"></div>
<div class="SRStatus" id="Loading">Loading...</div>
<div class="SRStatus" id="Searching">Searching...</div>
<div class="SRStatus" id="NoMatches">No Matches</div>
</div>
</div>
</div>
</div>
<div><div class="header">
<div class="headertitle"><div class="title">Release Software Changes for HDF5 1.10</div></div>
</div><!--header-->
<div class="contents">
<div class="textblock"><p>Navigate back: <a class="el" href="index.html">Main</a> / <a class="el" href="release_specific_info.html">Release Specific Information</a> / <a class="el" href="rel_spec_110.html">Release Specific Information for HDF5 1.10</a> </p><hr />
<h1><a class="anchor" id="sec_rel_spec_110_change"></a>
Software Changes from Release to Release in HDF5 1.10</h1>
<p>For a description of the major new features that were introduced, please see <a class="el" href="rel_spec_110.html#sec_rel_spec_110_feat">New Features in HDF5 Release 1.10</a>.</p>
<p>This page provides information on the changes that a maintenance developer needs to be aware of between successive releases of HDF5, such as: </p><ul>
<li>New or changed features or tools </li>
<li>Syntax and behavioral changes in the existing application programming interface (API) </li>
<li>Certain types of changes in configuration or build processes</li>
</ul>
<p>Note that bug fixes and performance enhancements in the C library are automatically picked up by the C++, Fortran, and Java libraries.</p>
<p>The following information is included below. </p><ul>
<li><a class="el" href="#subsec_rel_spec_110_change_compatibility">Compatibility and Performance Issues</a> </li>
<li><a class="el" href="#subsec_rel_spec_110_change_9versus8">Release 1.10.9 versus 1.10.8</a> </li>
<li><a class="el" href="#subsec_rel_spec_110_change_8versus7">Release 1.10.8 versus 1.10.7</a> </li>
<li><a class="el" href="#subsec_rel_spec_110_change_7versus6">Release 1.10.7 versus 1.10.6</a> </li>
<li><a class="el" href="#subsec_rel_spec_110_change_6versus5">Release 1.10.6 versus 1.10.5</a> </li>
<li><a class="el" href="#subsec_rel_spec_110_change_5versus4">Release 1.10.5 versus 1.10.4</a> </li>
<li><a class="el" href="#subsec_rel_spec_110_change_4versus3">Release 1.10.4 versus 1.10.3</a> </li>
<li><a class="el" href="#subsec_rel_spec_110_change_3versus2">Release 1.10.3 versus 1.10.2</a> </li>
<li><a class="el" href="#subsec_rel_spec_110_change_2versus1">Release 1.10.2 versus 1.10.1</a> </li>
<li><a class="el" href="#subsec_rel_spec_110_change_1versus0">Release 1.10.1 versus 1.10.0</a> </li>
<li><a class="el" href="#subsec_rel_spec_110_change_0versus8_16">Release 1.10.0 versus Release 1.8.16</a></li>
</ul>
<p>See [API Compatibility Reports for 1.10]() for information regarding compatibility with previous releases.</p>
<h2><a class="anchor" id="subsec_rel_spec_110_change_compatibility"></a>
Compatibility and Performance Issues</h2>
<p>Not all HDF5-1.10 releases are compatible. Users should NOT be using 1.10 releases prior to HDF5-1.10.3. See the compatibility matrix below for details on compatibility between 1.10 releases:</p>
<table class="doxtable">
<tr>
<th>Release</th><th>1.10.5+</th><th>1.10.4</th><th>1.10.3</th><th>1.10.2</th><th>1.10.1</th><th>1.10.0-patch1</th><th>1.10.0 </th></tr>
<tr>
<td>1.10.5+</td><td>.</td><td>Yes</td><td>Yes</td><td>No</td><td>No</td><td>No</td><td>No </td></tr>
<tr>
<td>1.10.4</td><td>Yes</td><td>.</td><td>Yes</td><td>No</td><td>No</td><td>No</td><td>No </td></tr>
<tr>
<td>1.10.3</td><td>Yes</td><td>Yes</td><td>.</td><td>No</td><td>No</td><td>No</td><td>No </td></tr>
<tr>
<td>1.10.2</td><td>No</td><td>No</td><td>No</td><td>.</td><td>No</td><td>No</td><td>No </td></tr>
</table>
<p>The following images show how performance has changed from release to release.</p>
<table class="doxtable">
<tr>
<td><div class="image">
<img src="cgns.png" alt=""/>
</div>
</td></tr>
</table>
<table class="doxtable">
<tr>
<td><div class="image">
<img src="writeLgNumDsets.png" alt=""/>
</div>
</td></tr>
</table>
<p>The release notes also list changes made to the library, but these notes tend to be more at a more detail-oriented level. The release notes may include new features, bugs fixed, supported configuration features, platforms on which the library has been tested, and known problems. The release note files are listed below and can be found at the top level of the HDF5 source code tree in the release_docs directory. </p><table class="doxtable">
<tr>
<th>Filename</th><th>Description </th></tr>
<tr>
<th>Release Notes</th><td>Technical notes regarding the current release of the HDF5 library (RELEASE.txt in the source code) </td></tr>
<tr>
<th>HISTORY-1_10.txt</th><td>Release information for all HDF5-1.10 releases </td></tr>
<tr>
<th>HISTORY-1_8_0-1_10_0.txt</th><td>Development history between the HDF5-1.8.0 and HDF5-1.10.0 releases </td></tr>
<tr>
<th>HISTORY-1_8.txt</th><td>Release information for HDF5-1.8.0 through HDF5-1.8.21 releases </td></tr>
<tr>
<th>HISTORY-1_0-1_8_0_rc3.txt</th><td>Technical notes starting with HDF5-1.0.0 and ending with HDF5-1.8.0-rc3 (the state of the code prior to the HDF5-1.8.0 release) </td></tr>
</table>
<h2><a class="anchor" id="subsec_rel_spec_110_change_9versus8"></a>
Release 1.10.9 versus 1.10.8</h2>
<h2><a class="anchor" id="subsec_rel_spec_110_change_9versus8_func"></a>
New and Changed Functions, Classes, Subroutines, Wrappers, and Macros</h2>
<h4>In the Java API</h4>
<p>One Java wrapper was added: </p><ul>
<li>H5.H5export_dataset</li>
</ul>
<h2><a class="anchor" id="subsec_rel_spec_110_change_9versus8_compat"></a>
Compatibility Notes and Reports</h2>
<p>See the [API compatibility report between 1.10.8 and 1.10.9]() for information regarding compatibility with the previous release.</p>
<h2><a class="anchor" id="subsec_rel_spec_110_change_8versus7"></a>
Release 1.10.8 versus 1.10.7</h2>
<h2><a class="anchor" id="subsec_rel_spec_110_change_8versus7_func"></a>
New and Changed Functions, Classes, Subroutines, Wrappers, and Macros</h2>
<h4>In the C++ API</h4>
<p>One C++ wrapper was added: </p><ul>
<li><code>DataSet::operator=</code></li>
</ul>
<h2><a class="anchor" id="subsec_rel_spec_110_change_8versus7_compat"></a>
Compatibility Notes and Reports</h2>
<p>See the [API compatibility report between 1.10.7 and 1.10.8]() for information regarding compatibility with the previous release.</p>
<h2><a class="anchor" id="subsec_rel_spec_110_change_7versus6"></a>
Release 1.10.7 versus 1.10.6</h2>
<h3><a class="anchor" id="subsubsec_rel_spec_110_change_7versus6_new"></a>
New and Changed Functions, Classes, Subroutines, Wrappers, and Macros</h3>
<h4>In the C Interface (main library)</h4>
<p>The following are new C functions in this release: </p><ul>
<li><a class="el" href="group___f_a_p_l.html#ga6e850a0319dc6839e2dd06a0522b3831" title="Gets splitter driver properties from the the file access property list.">H5Pget_fapl_splitter</a> - Retrieves information for a splitter file access property list </li>
<li><a class="el" href="group___f_a_p_l.html#ga6e850a0319dc6839e2dd06a0522b3831" title="Gets splitter driver properties from the the file access property list.">H5Pget_fapl_splitter</a> - Retrieves information for a splitter file access property list </li>
<li><a class="el" href="group___f_a_p_l.html#gacba378b6c9258d33da609ff7241d64c5" title="Sets the file access property list to use the splitter driver.">H5Pset_fapl_splitter</a> - Sets the file access property list to use the splitter driver </li>
<li><a class="el" href="group___f_a_p_l.html#ga6f68d03de151117cefa29b571865a394" title="Retrieves the file locking property values.">H5Pget_file_locking</a> - Gets the file locking property values </li>
<li><a class="el" href="group___f_a_p_l.html#gaae4de80c533a38da9f269c02b8e71de2" title="Sets the file locking property values.">H5Pset_file_locking</a> - Sets the file locking property values </li>
<li><a class="el" href="group___h5.html#ga2310d963a6f48ec12fda8c0c8bbefbbb" title="Gets the current size of the free lists used to manage memory.">H5get_free_list_sizes</a> - Gets the current size of the free lists used to manage memory </li>
<li><a class="el" href="group___h5_s.html#gae7578a93bb7b22989bcb737f26b60ad1" title="Performs an operation on a hyperslab and an existing selection and returns the resulting selection.">H5Scombine_hyperslab</a> - Performs an operation on a hyperslab and an existing selection and returns the resulting selection </li>
<li><a class="el" href="group___h5_s.html#ga356600d12d3cf0db53cc27b212d75b08" title="Combine two hyperslab selections with an operation, returning a dataspace with the resulting selectio...">H5Scombine_select</a> - Combines two hyperslab selections with an operation, returning a dataspace with the resulting selection </li>
<li><a class="el" href="group___h5_s.html#ga0ccb190f72fe41a927407ffb9f19ef1b" title="Refines a hyperslab selection with an operation, using a second hyperslab to modify it.">H5Smodify_select</a> - Refines a hyperslab selection with an operation using a second hyperslab to modify it </li>
<li><a class="el" href="group___h5_s.html#ga64f08c187b899f2728d4ac016d44f890" title="Adjusts a selection by subtracting an offset.">H5Sselect_adjust</a> - Adjusts a selection by subtracting an offset </li>
<li><a class="el" href="group___h5_s.html#ga57e5eba2d1b282803835ba3f7e0b9bfa" title="Copies a selection from one dataspace to another.">H5Sselect_copy</a> - Copies a selection from one dataspace to another </li>
<li><a class="el" href="group___h5_s.html#ga51472bcb9af024675fba6294a6aefa5e" title="Checks if current selection intersects with a block.">H5Sselect_intersect_block</a> - Checks if current selection intersects with a block </li>
<li><a class="el" href="group___h5_s.html#ga1e914ba45afb15ded99a0afeaf124c04" title="Projects the intersection of two source selections to a destination selection.">H5Sselect_project_intersection</a> - Projects the intersection of two source selections to a destination selection </li>
<li><a class="el" href="group___h5_s.html#gafc6cafae877900ee060709eaa0b9b261" title="Checks if two selections are the same shape.">H5Sselect_shape_same</a> - Checks if two selections are the same shape</li>
</ul>
<h4>In the C++ API</h4>
<p>The following C++ wrappers were added: </p><ul>
<li><code>FileAccPropList::getFileLocking</code> - See <a class="el" href="group___f_a_p_l.html#ga6f68d03de151117cefa29b571865a394" title="Retrieves the file locking property values.">H5Pget_file_locking</a> for details </li>
<li><code>FileAccPropList::setFileLocking</code> - See <a class="el" href="group___f_a_p_l.html#gaae4de80c533a38da9f269c02b8e71de2" title="Sets the file locking property values.">H5Pset_file_locking</a> for details</li>
</ul>
<h2><a class="anchor" id="subsec_rel_spec_110_change_7versus6_compat"></a>
Compatibility Notes and Reports</h2>
<p>See the [API compatibility report between 1.10.7 and 1.10.8]() for information regarding compatibility with the previous release.</p>
<h2><a class="anchor" id="subsec_rel_spec_110_change_6versus5"></a>
Release 1.10.6 versus 1.10.5</h2>
<h3><a class="anchor" id="subsubsec_rel_spec_110_change_6versus5_new"></a>
New and Changed Functions, Classes, Subroutines, Wrappers, and Macros</h3>
<h4>In the C Interface (main library)</h4>
<p>The following are new C functions in this release: </p><ul>
<li><a class="el" href="group___f_a_p_l.html#gafb4ec2b60ab86eade5aa55f5e4f5fd35" title="Queries a File Access Property List for H5FD_HDFS file driver properties.">H5Pget_fapl_hdfs</a> - Gets the information of the given Read-Only HDFS virtual file driver </li>
<li><a class="el" href="group___f_a_p_l.html#gaee5e0b8373b4b493b0cd2616938d601e" title="Queries a File Access Property List for H5FD_ROS3 file driver properties.">H5Pget_fapl_ros3</a> - Gets the information of the given Read-Only S3 virtual file driver </li>
<li><a class="el" href="group___f_a_p_l.html#gacc14b36c543d837e3257c216939d8931" title="Modifies the file access property list to use the H5FD_HDFS driver.">H5Pset_fapl_hdfs</a> - Sets up Read-Only HDFS virtual file driver </li>
<li><a class="el" href="group___f_a_p_l.html#ga9dd7950acea860b716831488dd87ae8f" title="Modifies the specified File Access Property List to use the H5FD_ROS3 driver.">H5Pset_fapl_ros3</a> - Sets up Read-Only S3 virtual file driver</li>
</ul>
<h4>In the C++ API</h4>
<p>The following C++ wrappers were added: </p><ul>
<li><code>LinkCreatPropList::getCreateIntermediateGroup() const</code> - See <a class="el" href="group___l_c_p_l.html#gaf7db1b7ce19703f30f1827b7c899c3b0" title="Determines whether property is set to enable creating missing intermediate groups.">H5Pget_create_intermediate_group</a> </li>
<li><code>LinkCreatPropList::setCreateIntermediateGroup(bool crt_intmd_group) const</code> - See <a class="el" href="group___l_c_p_l.html#ga66c4c5d3f34e5cf65d00e47a5387383c" title="Specifies in property list whether to create missing intermediate groups.">H5Pset_create_intermediate_group</a></li>
</ul>
<h2><a class="anchor" id="subsec_rel_spec_110_change_6versus5_compat"></a>
Compatibility Notes and Reports</h2>
<p>See the [API compatibility report between 1.10.7 and 1.10.8]() for information regarding compatibility with the previous release.</p>
<h2><a class="anchor" id="subsec_rel_spec_110_change_5versus4"></a>
Release 1.10.5 versus 1.10.4</h2>
<h3><a class="anchor" id="subsubsec_rel_spec_110_change_5versus4_new"></a>
New and Changed Functions, Classes, Subroutines, Wrappers, and Macros</h3>
<h4>In the C Interface (main library)</h4>
<p>The following are new C functions in this release: </p><ul>
<li><a class="el" href="group___h5_d.html#gaccff213d3e0765b86f66d08dd9959807" title="Retrieves information about a chunk specified by its index.">H5Dget_chunk_info</a> - Retrieves information about a chunk specified by the chunk index </li>
<li><a class="el" href="group___h5_d.html#ga408a49c6ec59c5b65ce4c791f8d26cb0" title="Retrieves information about a chunk specified by its coordinates.">H5Dget_chunk_info_by_coord</a> - Retrieves information about a chunk specified by its coordinates </li>
<li><a class="el" href="group___h5_d.html#ga8e15897dcc5799d6c09806644b492d7a" title="Retrieves number of chunks that have nonempty intersection with a specified selection.">H5Dget_num_chunks</a> - Retrieves number of chunks that have nonempty intersection with a specified selection </li>
<li><a class="el" href="group___h5_f.html#gae688a27695349925f08eaa3c44f99265" title="Retrieves the setting for whether or not a file will create minimized dataset object headers.">H5Fget_dset_no_attrs_hint</a> - Retrieves the setting for determining whether the specified file does or does not create minimized dataset object headers </li>
<li><a class="el" href="group___h5_f.html#gaddd372973b35cde53300817d3ffaee5a" title="Sets the flag to create minimized dataset object headers.">H5Fset_dset_no_attrs_hint</a> - Sets the flag to create minimized dataset object headers </li>
<li><a class="el" href="group___d_c_p_l.html#gacc70605145caa8ec9ca197aedaa38238" title="Retrieves the setting for whether or not to create minimized dataset object headers.">H5Pget_dset_no_attrs_hint</a> - Retrieves the setting for determining whether the specified DCPL does or does not create minimized dataset object headers </li>
<li><a class="el" href="group___d_c_p_l.html#gac6f61bff4d01bc98f67162d95a1b501a" title="Sets the flag to create minimized dataset object headers.">H5Pset_dset_no_attrs_hint</a> - Sets the flag to create minimized dataset object headers</li>
</ul>
<p>The following changed in this release: </p><ul>
<li><a class="el" href="group___h5_o.html#gaf4f302a33faba9e1c2b5f64c62ca4ed5">H5Oget_info</a> </li>
<li><a class="el" href="group___h5_o.html#ga16d8ac07f9244cfccb42b5f309ca6b3c">H5Oget_info_by_name</a> </li>
<li><a class="el" href="group___h5_o.html#gafe764884e1530f86079288dd5895a7bd">H5Oget_info_by_idx</a> </li>
<li><a class="el" href="group___h5_o.html#ga5ce86255fcc34ceaf84a62551cd24233">H5Ovisit</a> </li>
<li><a class="el" href="group___h5_o.html#gab02a69e88b11404e7fd61f55344b186c">H5Ovisit_by_name</a></li>
</ul>
<p>In 1.10.3 the original functions were versioned to H5Oget_info*1 and H5Ovisit*1 and the macros H5Oget_info* and H5Ovisit* were created. This broke the API compatibility for a maintenance release. In HDF5-1.10.5, the macros introduced in HDF5-1.10.3 were removed. The H5Oget_info*1 and H5Ovisit*1 APIs were copied to H5Oget_Info* and H5Ovisit*. As an example, <a class="el" href="group___h5_o.html#gaf4f302a33faba9e1c2b5f64c62ca4ed5">H5Oget_info</a> and <a class="el" href="group___h5_o.html#gaf3751684a6706e3ba49b863406011f80" title="Retrieves the metadata for an object specified by an identifier.">H5Oget_info1</a> are identical in this release.</p>
<h4>In the C++ API</h4>
<p>The following C++ wrapper was added: </p><ul>
<li><code>H5Object::visit()</code> - Wrapper for the C API <a class="el" href="group___h5_o.html#gaa4ab542f581f4fc9a4eaa95debb29c9e" title="Recursively visits all objects accessible from a specified object.">H5Ovisit2</a>. Recursively visit elements reachable from an HDF5 object and perform a common set of operations across all of those elements.</li>
</ul>
<h4>In the Fortran API</h4>
<p>The following Fortran wrappers were added or changed: </p><ul>
<li><a class="el" href="group___f_h5_f.html#gaceb86e903eddc57846c8a249ab5b0a66" title="Gets the value of the &quot;minimize dataset headers&quot; value which creates smaller dataset object headers w...">h5f.h5fget_dset_no_attrs_hint_f</a> - Wrappers for the dataset object header minimization calls. See <a class="el" href="group___h5_f.html#gae688a27695349925f08eaa3c44f99265" title="Retrieves the setting for whether or not a file will create minimized dataset object headers.">H5Fget_dset_no_attrs_hint</a>. </li>
<li><a class="el" href="group___f_h5_f.html#gafda7e4a737f10a9be280afcdbf468e61" title="Sets the value of the &quot;minimize dataset headers&quot; value which creates smaller dataset object headers w...">h5f.h5fset_dset_no_attrs_hint_f</a> - Wrappers for the dataset object header minimization calls. See <a class="el" href="group___h5_f.html#gaddd372973b35cde53300817d3ffaee5a" title="Sets the flag to create minimized dataset object headers.">H5Fset_dset_no_attrs_hint</a>. </li>
<li><a class="el" href="group___f_h5_p.html#ga7cc4d157c8502632af18454424aa58d6" title="Gets the value of the &quot;minimize dataset headers&quot; value which creates smaller dataset object headers w...">h5p.h5pget_dset_no_attrs_hint_f</a> - Wrappers for the dataset object header minimization calls. See <a class="el" href="group___d_c_p_l.html#gacc70605145caa8ec9ca197aedaa38238" title="Retrieves the setting for whether or not to create minimized dataset object headers.">H5Pget_dset_no_attrs_hint</a>. </li>
<li><a class="el" href="group___f_h5_p.html#ga3b2e599c1c38c395d6d9b1cdddee4f6a" title="Sets the value of the &quot;minimize dataset headers&quot; value which creates smaller dataset object headers w...">h5p.h5pset_dset_no_attrs_hint_f</a> - Wrappers for the dataset object header minimization calls. See <a class="el" href="group___d_c_p_l.html#gac6f61bff4d01bc98f67162d95a1b501a" title="Sets the flag to create minimized dataset object headers.">H5Pset_dset_no_attrs_hint</a>. </li>
<li><a class="el" href="group___f_h5_o.html#ga1aa4f84b78f029f048593b1ec0757a63" title="Recursively visits all objects starting from a specified object.">h5o.h5ovisit_f</a> - Added new Fortran 'fields' optional parameter. See <a class="el" href="group___h5_o.html#gaa4ab542f581f4fc9a4eaa95debb29c9e" title="Recursively visits all objects accessible from a specified object.">H5Ovisit2</a>. </li>
<li><a class="el" href="group___f_h5_o.html#ga40081a5f47dc7900a795c0df62791ff7" title="Retrieves the metadata for an object, identifying the object by location and relative name.">h5o.h5oget_info_by_name_f</a> - Added new Fortran 'fields' optional parameter. See <a class="el" href="group___h5_o.html#ga0090da86c086c1c63a5acfaed39a035e" title="Retrieves the metadata for an object, identifying the object by location and relative name.">H5Oget_info_by_name2</a>. </li>
<li><a class="el" href="group___f_h5_o.html#gabdbe70d333edbc46cffd791495e3edea" title="Retrieves the metadata for an object specified by an identifier.">h5o.h5oget_info_f</a> - Added new Fortran 'fields' optional parameter. See <a class="el" href="group___h5_o.html#ga06f896e14fe4fa940fbc2bc235e0cf74" title="Retrieves the metadata for an object specified by an identifier.">H5Oget_info2</a>. </li>
<li><a class="el" href="group___f_h5_o.html#ga6666adcfef409c0828390b75730f9987" title="Retrieves the metadata for an object, identifying the object by an index position.">h5o.h5oget_info_by_idx_f</a> - Added new Fortran 'fields' optional parameter. See <a class="el" href="group___h5_o.html#ga85e15e65922874111da1a5efd5dd7bed" title="Retrieves the metadata for an object, identifying the object by an index position.">H5Oget_info_by_idx2</a>. </li>
<li><a class="el" href="group___f_h5_o.html#gaed6f1ee04db6973cbffca2cf0c33348f" title="Recursively visits all objects starting from a specified object.">h5o.h5ovisit_by_name_f</a> - Added new Fortran 'fields' optional parameter. See <a class="el" href="group___h5_o.html#ga9c155caf5499405fe403e1eb27b5beb6" title="Recursively visits all objects starting from a specified object.">H5Ovisit_by_name2</a>.</li>
</ul>
<p>The following Fortran utility function was added: </p><ul>
<li><a class="el" href="group___f_h5.html#ga0185de6a71deabb35293843c481925af" title="Convert time_t structure (C) to Fortran DATE AND TIME storage format.">h5lib.h5gmtime</a> - converts (C) <code>time_t</code> structure to Fortran DATE AND TIME storage format</li>
</ul>
<p>A new Fortran derived type was added: </p><ul>
<li>c_h5o_info_t - This is interoperable with C's h5o_info_t. This is needed for callback functions which pass C's h5o_info_t data type definition.</li>
</ul>
<h4>In the Java wrapper</h4>
<p>The following Java wrappers were added or changed: </p><ul>
<li><a class="el" href="group___h5_f.html#ga4b833c33fe2e141a26b6f2ad559d3610" title="Enables the switch of version bounds setting for a file.">H5Fset_libver_bounds</a> </li>
<li><a class="el" href="group___h5_f.html#gae688a27695349925f08eaa3c44f99265" title="Retrieves the setting for whether or not a file will create minimized dataset object headers.">H5Fget_dset_no_attrs_hint</a> </li>
<li><a class="el" href="group___h5_f.html#gaddd372973b35cde53300817d3ffaee5a" title="Sets the flag to create minimized dataset object headers.">H5Fset_dset_no_attrs_hint</a> </li>
<li><a class="el" href="group___d_c_p_l.html#gacc70605145caa8ec9ca197aedaa38238" title="Retrieves the setting for whether or not to create minimized dataset object headers.">H5Pget_dset_no_attrs_hint</a> </li>
<li><a class="el" href="group___d_c_p_l.html#gac6f61bff4d01bc98f67162d95a1b501a" title="Sets the flag to create minimized dataset object headers.">H5Pset_dset_no_attrs_hint</a></li>
</ul>
<h2><a class="anchor" id="subsec_rel_spec_110_change_5versus4_compat"></a>
Compatibility Notes and Reports</h2>
<p>See the [API compatibility report between 1.10.5 and 1.10.2/1.10.3/1.10.4]() for details.</p>
<h2><a class="anchor" id="subsec_rel_spec_110_change_4versus3"></a>
Release 1.10.4 versus 1.10.3</h2>
<p>See the [API compatibility report between 1.10.4 and 1.10.3]() for details.</p>
<h2><a class="anchor" id="subsec_rel_spec_110_change_3versus2"></a>
Release 1.10.3 versus 1.10.2</h2>
<p>New and Changed Functions, Classes, Subroutines, Wrappers, and Macros </p><h4>In the C Interface (main library)</h4>
<p>The following are new C functions in this release: </p><ul>
<li><a class="el" href="_h5version_8h.html#a8ff3b0cf52e30e2e12d617aa2329486e">H5Dread_chunk</a> - Moved from HDF5 High Level Optimizations library to core library </li>
<li><a class="el" href="group___h5_d.html#ga416ccd200929b11386a10e9024977109" title="Writes a raw data chunk from a buffer directly to a dataset in a file.">H5Dwrite_chunk</a> - Moved from HDF5 High Level Optimizations library to core library </li>
<li><a class="el" href="group___h5_o.html#gaf4f302a33faba9e1c2b5f64c62ca4ed5">H5Oget_info</a> - The function <a class="el" href="group___h5_o.html#gaf4f302a33faba9e1c2b5f64c62ca4ed5">H5Oget_info</a> was moved to <a class="el" href="group___h5_o.html#gaf3751684a6706e3ba49b863406011f80" title="Retrieves the metadata for an object specified by an identifier.">H5Oget_info1</a>, and the macro <a class="el" href="group___h5_o.html#gaf4f302a33faba9e1c2b5f64c62ca4ed5">H5Oget_info</a> was created that can be mapped to either <a class="el" href="group___h5_o.html#gaf3751684a6706e3ba49b863406011f80" title="Retrieves the metadata for an object specified by an identifier.">H5Oget_info1</a> or <a class="el" href="group___h5_o.html#ga06f896e14fe4fa940fbc2bc235e0cf74" title="Retrieves the metadata for an object specified by an identifier.">H5Oget_info2</a>. For HDF5-1.10 and earlier releases, <a class="el" href="group___h5_o.html#gaf4f302a33faba9e1c2b5f64c62ca4ed5">H5Oget_info</a> is mapped to <a class="el" href="group___h5_o.html#gaf3751684a6706e3ba49b863406011f80" title="Retrieves the metadata for an object specified by an identifier.">H5Oget_info1</a> by default. </li>
<li><a class="el" href="group___h5_o.html#gaf3751684a6706e3ba49b863406011f80" title="Retrieves the metadata for an object specified by an identifier.">H5Oget_info1</a> </li>
<li><a class="el" href="group___h5_o.html#ga06f896e14fe4fa940fbc2bc235e0cf74" title="Retrieves the metadata for an object specified by an identifier.">H5Oget_info2</a> </li>
<li><a class="el" href="group___h5_o.html#gafe764884e1530f86079288dd5895a7bd">H5Oget_info_by_idx</a> - The function <a class="el" href="group___h5_o.html#gafe764884e1530f86079288dd5895a7bd">H5Oget_info_by_idx</a> was moved to <a class="el" href="group___h5_o.html#ga7208d2cf198dcfc875603323841bffae" title="Retrieves the metadata for an object, identifying the object by an index position.">H5Oget_info_by_idx1</a>, and the macro <a class="el" href="group___h5_o.html#gafe764884e1530f86079288dd5895a7bd">H5Oget_info_by_idx</a> was created that can be mapped to either <a class="el" href="group___h5_o.html#ga7208d2cf198dcfc875603323841bffae" title="Retrieves the metadata for an object, identifying the object by an index position.">H5Oget_info_by_idx1</a> or <a class="el" href="group___h5_o.html#ga85e15e65922874111da1a5efd5dd7bed" title="Retrieves the metadata for an object, identifying the object by an index position.">H5Oget_info_by_idx2</a>. For HDF5-1.10 and earlier releases, <a class="el" href="group___h5_o.html#gafe764884e1530f86079288dd5895a7bd">H5Oget_info_by_idx</a> is mapped to <a class="el" href="group___h5_o.html#ga7208d2cf198dcfc875603323841bffae" title="Retrieves the metadata for an object, identifying the object by an index position.">H5Oget_info_by_idx1</a> by default. </li>
<li><a class="el" href="group___h5_o.html#ga7208d2cf198dcfc875603323841bffae" title="Retrieves the metadata for an object, identifying the object by an index position.">H5Oget_info_by_idx1</a> </li>
<li><a class="el" href="group___h5_o.html#ga85e15e65922874111da1a5efd5dd7bed" title="Retrieves the metadata for an object, identifying the object by an index position.">H5Oget_info_by_idx2</a> </li>
<li><a class="el" href="group___h5_o.html#ga16d8ac07f9244cfccb42b5f309ca6b3c">H5Oget_info_by_name</a> - The function <a class="el" href="group___h5_o.html#ga16d8ac07f9244cfccb42b5f309ca6b3c">H5Oget_info_by_name</a> was moved to <a class="el" href="group___h5_o.html#ga96ce408ffda805210844246904da2842" title="Retrieves the metadata for an object, identifying the object by location and relative name.">H5Oget_info_by_name1</a>, and the macro <a class="el" href="group___h5_o.html#ga16d8ac07f9244cfccb42b5f309ca6b3c">H5Oget_info_by_name</a> was created that can be mapped to either <a class="el" href="group___h5_o.html#ga96ce408ffda805210844246904da2842" title="Retrieves the metadata for an object, identifying the object by location and relative name.">H5Oget_info_by_name1</a> or <a class="el" href="group___h5_o.html#ga0090da86c086c1c63a5acfaed39a035e" title="Retrieves the metadata for an object, identifying the object by location and relative name.">H5Oget_info_by_name2</a>. For HDF5-1.10 and earlier releases, <a class="el" href="group___h5_o.html#ga16d8ac07f9244cfccb42b5f309ca6b3c">H5Oget_info_by_name</a> is mapped to <a class="el" href="group___h5_o.html#ga96ce408ffda805210844246904da2842" title="Retrieves the metadata for an object, identifying the object by location and relative name.">H5Oget_info_by_name1</a> by default. </li>
<li><a class="el" href="group___h5_o.html#ga96ce408ffda805210844246904da2842" title="Retrieves the metadata for an object, identifying the object by location and relative name.">H5Oget_info_by_name1</a> </li>
<li><a class="el" href="group___h5_o.html#ga0090da86c086c1c63a5acfaed39a035e" title="Retrieves the metadata for an object, identifying the object by location and relative name.">H5Oget_info_by_name2</a> </li>
<li><a class="el" href="group___h5_o.html#ga5ce86255fcc34ceaf84a62551cd24233">H5Ovisit</a> - The function <a class="el" href="group___h5_o.html#ga5ce86255fcc34ceaf84a62551cd24233">H5Ovisit</a> was moved to <a class="el" href="group___h5_o.html#ga6efdb2a0a9fe9fe46695cc0f7bd993e7" title="Recursively visits all objects accessible from a specified object.">H5Ovisit1</a>, and the macro H5Ovisit was created that can be mapped to either <a class="el" href="group___h5_o.html#ga6efdb2a0a9fe9fe46695cc0f7bd993e7" title="Recursively visits all objects accessible from a specified object.">H5Ovisit1</a> or <a class="el" href="group___h5_o.html#gaa4ab542f581f4fc9a4eaa95debb29c9e" title="Recursively visits all objects accessible from a specified object.">H5Ovisit2</a>. For HDF5-1.10 and earlier releases, <a class="el" href="group___h5_o.html#ga5ce86255fcc34ceaf84a62551cd24233">H5Ovisit</a> is mapped to <a class="el" href="group___h5_o.html#ga6efdb2a0a9fe9fe46695cc0f7bd993e7" title="Recursively visits all objects accessible from a specified object.">H5Ovisit1</a> by default. </li>
<li><a class="el" href="group___h5_o.html#ga6efdb2a0a9fe9fe46695cc0f7bd993e7" title="Recursively visits all objects accessible from a specified object.">H5Ovisit1</a> </li>
<li><a class="el" href="group___h5_o.html#gaa4ab542f581f4fc9a4eaa95debb29c9e" title="Recursively visits all objects accessible from a specified object.">H5Ovisit2</a> </li>
<li><a class="el" href="group___h5_o.html#gab02a69e88b11404e7fd61f55344b186c">H5Ovisit_by_name</a> - The function <a class="el" href="group___h5_o.html#gab02a69e88b11404e7fd61f55344b186c">H5Ovisit_by_name</a> was moved to <a class="el" href="group___h5_o.html#gaffacf3bd66f4fe074099eae1c80914f2" title="Recursively visits all objects starting from a specified object.">H5Ovisit_by_name1</a>, and the macro <a class="el" href="group___h5_o.html#gab02a69e88b11404e7fd61f55344b186c">H5Ovisit_by_name</a> was created that can be mapped to either <a class="el" href="group___h5_o.html#gaffacf3bd66f4fe074099eae1c80914f2" title="Recursively visits all objects starting from a specified object.">H5Ovisit_by_name1</a> or <a class="el" href="group___h5_o.html#ga9c155caf5499405fe403e1eb27b5beb6" title="Recursively visits all objects starting from a specified object.">H5Ovisit_by_name2</a>. For HDF5-1.10 and earlier releases, <a class="el" href="group___h5_o.html#gab02a69e88b11404e7fd61f55344b186c">H5Ovisit_by_name</a> is mapped to <a class="el" href="group___h5_o.html#gaffacf3bd66f4fe074099eae1c80914f2" title="Recursively visits all objects starting from a specified object.">H5Ovisit_by_name1</a> by default. </li>
<li><a class="el" href="group___h5_o.html#gaffacf3bd66f4fe074099eae1c80914f2" title="Recursively visits all objects starting from a specified object.">H5Ovisit_by_name1</a> </li>
<li><a class="el" href="group___h5_o.html#ga9c155caf5499405fe403e1eb27b5beb6" title="Recursively visits all objects starting from a specified object.">H5Ovisit_by_name2</a></li>
</ul>
<h4>In the C High Level Interface</h4>
<p>The following C functions were deprecated in this release: </p><ul>
<li><a class="el" href="group___h5_d_o.html#ga42ee2888be9fe225803bf50641faae76" title="Reads a raw data chunk directly from a dataset in a file into a buffer.">H5DOread_chunk</a> - Deprecated, moved to <a class="el" href="_h5version_8h.html#a8ff3b0cf52e30e2e12d617aa2329486e">H5Dread_chunk</a> </li>
<li><a class="el" href="group___h5_d_o.html#ga873b08130d88e81487f24bc3c1ce0d29" title="Writes a raw data chunk from a buffer directly to a dataset in a file.">H5DOwrite_chunk</a> - Deprecated, moved to <a class="el" href="group___h5_d.html#ga416ccd200929b11386a10e9024977109" title="Writes a raw data chunk from a buffer directly to a dataset in a file.">H5Dwrite_chunk</a></li>
</ul>
<h4>In the C++ API</h4>
<p>Several C++ wrappers were added or modified to provide additional support. See the API Compatibility Report for details.</p>
<h2><a class="anchor" id="subsec_rel_spec_110_change_4versus3_compat"></a>
Compatibility Notes and Report</h2>
<p>See the [API compatibility report between 1.10.4 and 1.10.3]() for details.</p>
<h2><a class="anchor" id="subsec_rel_spec_110_change_2versus1"></a>
Release 1.10.2 versus 1.10.1</h2>
<p>This section lists interface-level changes and other user-visible changes in behavior in the transition from HDF5 Release 1.10.1 to Release 1.10.2.</p>
<p>New and Changed Functions, Classes, Subroutines, Wrappers, and Macros </p><h4>In the C Interface (main library)</h4>
<p>The following are new C functions in this release: </p><ul>
<li><a class="el" href="group___h5_d.html#gaaeea958861de082db9051fc4bf215234" title="Returns the amount of storage allocated within the file for a raw data chunk in a dataset.">H5Dget_chunk_storage_size</a> - Returns storage amount allocated within a file for a raw data chunk in a dataset </li>
<li><a class="el" href="group___h5_f.html#ga4c18bddafc652203944d889a602bd53f" title="Retrieves the file&#39;s end-of-allocation (EOA)">H5Fget_eoa</a> - Retrieves the file's EOA </li>
<li><a class="el" href="group___h5_f.html#gadbe82c1f6e16c21062fabd20b0ffccd4" title="Sets the file&#39; EOA to the maximum of (EOA, EOF) + increment.">H5Fincrement_filesize</a> - Sets the file's EOA to the maximum of (EOA, EOF) + increment </li>
<li><a class="el" href="group___h5_f.html#ga4b833c33fe2e141a26b6f2ad559d3610" title="Enables the switch of version bounds setting for a file.">H5Fset_libver_bounds</a> - Enables the switch of version bounds setting for a file </li>
<li><a class="el" href="group___h5_v_f_d.html#ga42cb42d302b233ce880a215784db0799" title="Allows querying a VFD ID for features before the file is opened.">H5FDdriver_query</a> - Queries a VFL driver for its feature flags when a file is not available (not documented in Reference Manual) </li>
<li><a class="el" href="group___d_a_p_l.html#ga9a48c80955877c20d53e8fd3f49a2995" title="Retrieves prefix applied to VDS source file paths.">H5Pget_virtual_prefix</a> - Retrieves prefix applied to VDS source file paths </li>
<li><a class="el" href="group___d_a_p_l.html#ga6816e0de35a335f636922c3cd5569819" title="Sets prefix to be applied to VDS source file paths.">H5Pset_virtual_prefix</a> - Sets prefix to be applied to VDS source file paths</li>
</ul>
<p>The following C functions changed in this release: </p><ul>
<li><a class="el" href="group___f_a_p_l.html#gacbe1724e7f70cd17ed687417a1d2a910" title="Controls the range of library release versions used when creating objects in a file.">H5Pset_libver_bounds</a> - HDF5-1.10 was added to the range of versions </li>
<li><a class="el" href="group___d_c_p_l.html#gadec895092dbbedb94f85d9cacf8924f5" title="Sets the mapping between virtual and source datasets.">H5Pset_virtual</a> - A change was made to the method of searching for VDS source files </li>
<li>H5PL* - The parameters for many of the H5PL APIs were renamed</li>
</ul>
<h4>In the C High Level Interface</h4>
<p>The following new C function was added to this release: </p><ul>
<li><a class="el" href="group___h5_d_o.html#ga42ee2888be9fe225803bf50641faae76" title="Reads a raw data chunk directly from a dataset in a file into a buffer.">H5DOread_chunk</a> - Reads a raw data chunk directly from a dataset in a file</li>
</ul>
<h4>In the C++ API</h4>
<p>The following C++ wrappers were added: </p><ul>
<li><a class="el" href="group___h5_l.html#ga894444623b58ce1ac3bd35538245ac78" title="Creates a soft link.">H5Lcreate_soft</a> - Creates a soft link from link_name to target_name </li>
<li><a class="el" href="group___h5_l.html#ga69d50f7acdfd2f1dc7c4372397e63bd2" title="Creates a hard link to an object.">H5Lcreate_hard</a> - Creates a hard link from new_name to curr_name </li>
<li><a class="el" href="group___h5_l.html#gafd4624f1c040d5f1df36cb1e6986aac6" title="Creates an identical copy of a link with the same creation time and target. The new link can have a d...">H5Lcopy</a> - Copy an object from a group of file </li>
<li><a class="el" href="group___h5_l.html#ga0bbc7f9bf25c8aca9dd8433a325c8acb" title="Moves a link within an HDF5 file.">H5Lmove</a> - Rename an object in a group or file </li>
<li><a class="el" href="group___h5_l.html#ga5b4e7f59f5d4bdae94fd8ce6875295cf" title="Removes a link from a group.">H5Ldelete</a> - Removes the specified link from this location </li>
<li><a class="el" href="group___h5_t.html#ga1ceda41ee462fab8dd70bdf67205ed1c" title="Encodes a datatype object description into a binary buffer.">H5Tencode</a> - Creates a binary object description of this datatype </li>
<li><a class="el" href="_h5version_8h.html#ac90f7722dacad861c0a22507d3adf0dd">H5Tdecode</a> - Returns the decoded type from the binary object description </li>
<li><a class="el" href="group___h5_l.html#ga97279697f3010a6ad31dd7f4341eb698">H5Lget_info</a> - Returns the information of the named link</li>
</ul>
<p>These were also added: </p><ul>
<li><code>Class LinkCreatPropList</code> for link create property list</li>
</ul>
<p>Overloaded functions: </p><ul>
<li><code>H5Location::createGroup</code> to take a link creation property list</li>
</ul>
<p>See the API Compatibility report for complete details.</p>
<h4>In the Java API</h4>
<p>The following Java wrappers were added: </p><ul>
<li><a class="el" href="group___f_a_p_l.html#gaca1f462af9b441a0fdc6d0da6d4e17de" title="Controls the library&#39;s behavior of evicting metadata associated with a closed object.">H5Pset_evict_on_close</a> - Controls the library's behavior of evicting metadata associated with a closed object </li>
<li><a class="el" href="group___f_a_p_l.html#ga465a52e20e031a604b719bbfe9883b66" title="Retrieves the file access property list setting that determines whether an HDF5 object will be evicte...">H5Pget_evict_on_close</a> - Retrieves the file access property list setting that determines whether an HDF5 object will be evicted from the library's metadata cache when closed </li>
<li><a class="el" href="group___d_c_p_l.html#ga8e60618d9030dc1b99ad9c8ff7867873" title="Sets the edge chunk option in a dataset creation property list.">H5Pset_chunk_opts</a> - Sets the edge chunk option in a dataset creation property list </li>
<li><a class="el" href="group___d_c_p_l.html#ga6e8d8f6a14b79bd110e27666d95031cf" title="Retrieves the edge chunk option setting from a dataset creation property list.">H5Pget_chunk_opts</a> - Retrieves the edge chunk option setting from a dataset creation property list </li>
<li><a class="el" href="group___d_a_p_l.html#gad487f84157fd0944cbe1cbd4dea4e1b8" title="Sets the external dataset storage file prefix in the dataset access property list.">H5Pset_efile_prefix</a> - Sets the external dataset storage file prefix in the dataset access property list </li>
<li><a class="el" href="group___d_a_p_l.html#ga442647d48171db920c71a7baf6fdeee6" title="Retrieves the prefix for external raw data storage files as set in the dataset access property list.">H5Pget_efile_prefix</a> - Retrieves the prefix for external raw data storage files as set in the dataset access property list </li>
<li><a class="el" href="group___d_a_p_l.html#ga6816e0de35a335f636922c3cd5569819" title="Sets prefix to be applied to VDS source file paths.">H5Pset_virtual_prefix</a> - Sets prefix to be applied to VDS source file paths </li>
<li><a class="el" href="group___d_a_p_l.html#ga9a48c80955877c20d53e8fd3f49a2995" title="Retrieves prefix applied to VDS source file paths.">H5Pget_virtual_prefix</a> - Retrieves prefix applied to VDS source file paths</li>
</ul>
<p>See the Release.txt file for details.</p>
<h4>Tools</h4>
<p>New options were added to the <a class="el" href="_h5_t_o_o_l__c_r__u_g.html#sec_cltools_h5clear">h5clear</a> utility: </p><ul>
<li><code>&ndash;filesize</code> - Print the file's EOA and EOF </li>
<li><code>&ndash;increment=C</code> - Set the file's EOA to the maximum of <code>(EOA, EOF) + C</code> for the file <code>C is &gt;= 0</code>; C is optional and will default to 1M when not set</li>
</ul>
<p>A new option was added to <a class="el" href="_h5_t_o_o_l__d_f__u_g.html#sec_cltools_h5diff">h5diff</a> </p><ul>
<li><code>&ndash;enable-error-stack</code> - Enable the error stack</li>
</ul>
<h2><a class="anchor" id="subsec_rel_spec_110_change_2versus1_compat"></a>
Compatibility Notes and Report</h2>
<p>See the [API compatibility report between 1.10.4 and 1.10.3]() for details.</p>
<h2><a class="anchor" id="subsec_rel_spec_110_change_1versus0"></a>
Release 1.10.1 versus 1.10.0</h2>
<p>This section lists interface-level changes and other user-visible changes in behavior in the transition from HDF5 Release 1.10.0 (and HDF5-1.10.0-patch1) to Release 1.10.1.</p>
<h3><a class="anchor" id="subsubsec_rel_spec_110_change_1versus0_new"></a>
New Features</h3>
<p>Several new features are introduced in HDF5 Release 1.10.1. </p><ul>
<li>Metadata Cache Image </li>
<li>Metadata Cache Evict on Close </li>
<li>Paged Aggregation </li>
<li>Page Buffering</li>
</ul>
<h4>New Features, including associated C Functions</h4>
<p>The following features are described and documented in New Features in HDF5 Release 1.10. Each new feature in 1.10.1 is listed below along with the associated C functions: </p><ul>
<li><b>Metadata Cache Image:</b><br />
<ul>
<li>
<a class="el" href="group___f_a_p_l.html#gaaa18d59ee9efb12626410b1638f76f00" title="Retrieves the metadata cache image configuration values for a file access property list.">H5Pget_mdc_image_config</a> - Retrieves the metadata cache image configuration values for a file access property list. </li>
<li>
<a class="el" href="group___f_a_p_l.html#ga65cf9fea33d1324009efc2d5db848434" title="Sets the metadata cache image option for a file access property list.">H5Pset_mdc_image_config</a> - Sets the metadata cache image option for a file access property list. </li>
<li>
<a class="el" href="group___m_d_c.html#ga7b37da15ff80c4aa5c275649f1f45b0a" title="Obtains information about a cache image if it exists.">H5Fget_mdc_image_info</a> - Gets information about a metadata cache image if it exists. </li>
</ul>
</li>
<li><b>Metadata Cache Evict on Close:</b><br />
<ul>
<li>
<a class="el" href="group___f_a_p_l.html#ga465a52e20e031a604b719bbfe9883b66" title="Retrieves the file access property list setting that determines whether an HDF5 object will be evicte...">H5Pget_evict_on_close</a> - Retrieves the property list setting that determines whether an HDF5 object will be evicted from the library's metadata cache when it is closed. </li>
<li>
<a class="el" href="group___f_a_p_l.html#gaca1f462af9b441a0fdc6d0da6d4e17de" title="Controls the library&#39;s behavior of evicting metadata associated with a closed object.">H5Pset_evict_on_close</a> - Controls the library's behavior of evicting metadata associated with a closed object. </li>
</ul>
</li>
<li><b>Paged Aggregation:</b><br />
<ul>
<li>
<a class="el" href="group___f_c_p_l.html#gaab5e8c08e4f588e0af1d937fcebfc885" title="Retrieves the file space page size for a file creation property list.">H5Pget_file_space_page_size</a> - Retrieves the file space page size for a file creation property list. </li>
<li>
<a class="el" href="group___f_c_p_l.html#gad012d7f3c2f1e1999eb1770aae3a4963" title="Sets the file space page size for a file creation property list.">H5Pset_file_space_page_size</a> - Sets the file space page size (used with paged aggregation) for a file creation property list. </li>
<li>
<a class="el" href="group___f_c_p_l.html#gae43e976d78a41b3b181fa10f8c77f522" title="Retrieves the file space handling strategy, persisting free-space condition and threshold value for a...">H5Pget_file_space_strategy</a> - Retrieves the file space handling strategy for a file creation property list. </li>
<li>
<a class="el" href="group___f_c_p_l.html#gae9ed9b56f290d6d24421242f1c04914e" title="Sets the file space handling strategy and persisting free-space values for a file creation property l...">H5Pset_file_space_strategy</a> - Sets the file space allocation strategy for a file creation property list. </li>
</ul>
</li>
<li><b>Page Buffering:</b><br />
<ul>
<li>
<a class="el" href="group___f_a_p_l.html#ga0da11baf31cf424d053aa7952c933d98" title="Retrieves the maximum size for the page buffer and the minimum percentage for metadata and raw data p...">H5Pget_page_buffer_size</a> - Retrieves the maximum size for the page buffer and the minimum percentage for metadata and raw data pages. </li>
<li>
<a class="el" href="group___f_a_p_l.html#ga8008cddafa81bd1ddada23f6d9a161ca" title="Sets the maximum size for the page buffer and the minimum percentage for metadata and raw data pages.">H5Pset_page_buffer_size</a> - Sets the maximum size for the page buffer and the minimum percentage for metadata and raw data pages. </li>
<li>
<a class="el" href="group___h5_f.html#ga0663defe0143631f4292267c21e94202" title="Retrieves statistics about page access when it is enabled.">H5Fget_page_buffering_stats</a> - Retrieves statistics about page access when it is enabled. </li>
<li>
<a class="el" href="group___h5_f.html#ga7ef1c0aab9a7a9112a8d0a788ec8696c" title="Resets the page buffer statistics.">H5Freset_page_buffering_stats</a> - Resets the page buffer statistics. </li>
</ul>
</li>
</ul>
<p>New and Changed Functions, Classes, Subroutines, Wrappers, and Macros </p><h4>In the C Interface (main library)</h4>
<p>The following new C functions were added: </p><ul>
<li><a class="el" href="group___h5_p_l.html#gac74200fdc02f794f3fae753fe8b850b0" title="Inserts a plugin path at the end of the plugin search path list.">H5PLappend</a> </li>
<li><a class="el" href="group___h5_p_l.html#ga64a3c5450d91455624ecba582553d905" title="Queries the plugin search path list at the specified index.">H5PLget</a> </li>
<li><a class="el" href="group___h5_p_l.html#gacc5153b0db6b3f876c3980bf34f931fc" title="Inserts a path at the specified index in the plugin search path list.">H5PLinsert</a> </li>
<li><a class="el" href="group___h5_p_l.html#ga1f2300ef2de6e430af330de7d194576f" title="Inserts a plugin path at the beginning of the plugin search path list.">H5PLprepend</a> </li>
<li><a class="el" href="group___h5_p_l.html#gaa566196b7c6970c255feac4cf9f3bf40" title="Removes a plugin path at a specified index from the plugin search path list.">H5PLremove</a> </li>
<li><a class="el" href="group___h5_p_l.html#gab0f8d4e8d0b81cb55cf8b9de5095dc0b" title="Replaces the path at the specified index in the plugin search path list.">H5PLreplace</a> </li>
<li><a class="el" href="group___h5_p_l.html#ga30b799ad7e9645312ef8975a610b4b18" title="Retrieves the number of stored plugin paths.">H5PLsize</a></li>
</ul>
<h4>In the C++ API</h4>
<p>New member functions were added to provide const versions. For example, these methods, </p><ul>
<li><code>ArrayType::getArrayDims ( hsize_t* dims ) const</code> </li>
<li><code>ArrayType::getArrayNDims ( ) const</code></li>
</ul>
<p>replace these: </p><ul>
<li><code>ArrayType::getArrayDims(hsize_t* dims)</code> </li>
<li><code>ArrayType::getArrayNDims()</code></li>
</ul>
<p>Several functions were moved to other classes. For example, this method, </p><ul>
<li><code>H5Location::openDataSet (char const* name) const</code></li>
</ul>
<p>replaces: </p><ul>
<li><code>CommonFG::openDataSet (char const* name) const</code></li>
</ul>
<p>PLEASE review the Compatibility report below for complete information on the C++ changes in this release.</p>
<h2><a class="anchor" id="subsec_rel_spec_110_change_1versus0_compat"></a>
Compatibility Report</h2>
<p>See the [API compatibility report between 1.10.1 and 1.10.0-patch1]() for details.</p>
<h2><a class="anchor" id="subsec_rel_spec_110_change_0versus8_16"></a>
Release 1.10.0 versus Release 1.8.16</h2>
<p>This section lists interface-level changes and other user-visible changes in behavior in the transition from HDF5 Release 1.8.16 to Release 1.10.0.</p>
<p>Changed Type </p><ul>
<li><a class="el" href="_h5_ipublic_8h.html#a0045db7ff9c22ad35db6ae91662e1943">hid_t</a> - Changed from a 32-bit to a 64-bit value. <a class="el" href="_h5_ipublic_8h.html#a0045db7ff9c22ad35db6ae91662e1943">hid_t</a> is the type is used for all HDF5 identifiers. This change, which is necessary to accommodate the capacities of modern computing systems, therefore affects all HDF5 applications. If an application has been using HDF5's <a class="el" href="_h5_ipublic_8h.html#a0045db7ff9c22ad35db6ae91662e1943">hid_t</a> the type, recompilation will normally be sufficient to take advantage of HDF5 Release 1.10.0. If an application uses an integer type instead of HDF5's <a class="el" href="_h5_ipublic_8h.html#a0045db7ff9c22ad35db6ae91662e1943">hid_t</a> type, those identifiers must be changed to a 64-bit type when the application is ported to the 1.10.x series.</li>
</ul>
<h4>New Features and Feature Sets</h4>
<p>Several new features are introduced in HDF5 Release 1.10.0. </p><ul>
<li>Single-Writer / Multiple-Reader or SWMR </li>
<li>Collective Metadata I/O </li>
<li>Fine-tuning the metadata cache </li>
<li>File Space Management </li>
<li>Virtual Datasets or VDS </li>
<li>Partial Edge Chunk <a class="el" href="struct_options.html">Options</a> </li>
<li>Relative Pathnames for External Links </li>
<li>Property List Encoding and Decoding</li>
</ul>
<p>More substantial lists follow, including new and modified C functions and Fortran subroutines.</p>
<h4>New Features, including associated C Functions and Fortran Wrappers</h4>
<p>The following features are described and documented in New Features in HDF5 Release 1.10.0. On this page, we list each feature and its associated C functions and Fortran wrappers.</p>
<h4>Single-writer / Multiple-reader, commonly called SWMR:</h4>
<ul>
<li><a class="el" href="group___s_w_m_r.html#ga159be34fbe7e4a959589310ef0196dfe" title="Retrieves free-space section information for a file.">H5Fstart_swmr_write</a> - Enables SWMR writing mode for a file. </li>
<li><a class="el" href="group___h5_d_o.html#ga1fcbd6fc898ccb603e85e75f9507a76c" title="Appends data to a dataset along a specified dimension.">H5DOappend</a> - Appends data to a dataset along a specified dimension. (This is a high-level API.) </li>
<li><a class="el" href="group___d_a_p_l.html#gacd6803640eebd20e408c330192b09fa6" title="Retrieves the values of the append property that is set up in the dataset access property list.">H5Pget_append_flush</a> - Retrieves the values of the append property that is set up in the dataset access property list. </li>
<li><a class="el" href="group___d_a_p_l.html#ga2f685a7b3f3a4fa35ddcd1659ab4a835" title="Sets two actions to perform when the size of a dataset&#39;s dimension being appended reaches a specified...">H5Pset_append_flush</a> - Sets two actions to perform when the size of a dataset's dimension being appended reaches a specified boundary. </li>
<li><a class="el" href="group___f_a_p_l.html#gadb66d434fd8d2f600213b0eec539564e" title="Retrieves the object flush property values from the file access property list.">H5Pget_object_flush_cb</a> - Retrieves the object flush property values from the file access property list. </li>
<li><a class="el" href="group___f_a_p_l.html#gab4a4a788af5b6e88381dda0df2efbf19" title="Sets a callback function to invoke when an object flush occurs in the file.">H5Pset_object_flush_cb</a> - Sets a callback function to invoke when an object flush occurs in the file. </li>
<li><a class="el" href="group___h5_o.html#ga0908be309da1fb4f771c1e264fac22ae" title="Prevents metadata entries for an HDF5 object from being flushed from the metadata cache to storage.">H5Odisable_mdc_flushes</a> - Prevents metadata entries for an HDF5 object from being flushed from the metadata cache to storage. </li>
<li><a class="el" href="group___h5_o.html#ga21014920bdabf6973e233796d7174156" title="Enables flushing of dirty metadata entries from a file&#39;s metadata cache.">H5Oenable_mdc_flushes</a> - Returns the cache entries associated with an HDF5 object to the default metadata flush and eviction algorithm. </li>
<li><a class="el" href="group___h5_o.html#gac3b3b768a1c50be46e63cf5a631b30e3" title="Retrieves comment for specified object.">H5Oare_mdc_flushes_disabled</a> - Determines if an HDF5 object (dataset, group, committed datatype) has had flushes of metadata entries disabled. </li>
<li>H5Fdisable_mdc_flushes - Globally prevents dirty metadata entries from being flushed from the metadata cache to storage. </li>
<li>H5Fenable_mdc_flushes - Returns a file's metadata cache to the standard eviction and flushing algorithm. </li>
<li>H5Fare_mdc_flushes_disabled - Determines if flushes have been globally disabled for a file's metadata cache. </li>
<li>H5Fget_mdc_flush_disabled_obj_ids - Returns a list of all object identifiers for which flushes have been disabled in a file's metadata cache.</li>
</ul>
<h4>Command-line Tools:</h4>
<ul>
<li><a class="el" href="_h5_t_o_o_l__w_h__u_g.html#sec_cltools_h5watch">h5watch</a> - Allows users to output new records appended to a dataset under SWMR access as it grows. The functionality is similar to the Unix user command tail with the follow option, which outputs appended data as the file grows. </li>
<li><a class="el" href="_h5_t_o_o_l__f_c__u_g.html#sec_cltools_h5format_convert">h5format_convert</a> - This tool allows users to convert the indexing type of a chunked dataset made with a 1.10.x version of the HDF5 Library when the latest file format is used to the 1.8.x version 1 B-tree indexing type. For example, datasets created using SWMR access, can be converted to be accessed by the HDF5 1.18 library and tools. The tool does not rewrite raw data, but it does rewrite HDF5 metadata.</li>
</ul>
<h4>Collective Metadata I/O:</h4>
<ul>
<li><a class="el" href="group___f_a_p_l.html#ga0163bef7ee102029286830c2c30162ca" title="Sets metadata write mode to be collective or independent (default)">H5Pset_coll_metadata_write</a> and <a class="el" href="group___f_h5_p.html#ga6ff24389ab859314827e2dbdfae2fff5" title="Sets metadata writes to collective or independent. Default setting is independent (false).">h5p.h5pset_coll_metadata_write_f</a> - Establishes I/O mode property setting, collective or independent, for metadata writes. </li>
<li><a class="el" href="group___f_a_p_l.html#ga565428cd6c090a8c7836b7adf7720403" title="Retrieves metadata write mode setting.">H5Pget_coll_metadata_write</a> and <a class="el" href="group___f_h5_p.html#ga2b0822a557a3c71bd363b877030c1933" title="Retrieves metadata write mode from the file access property list.">h5p.h5pget_coll_metadata_write_f</a> - Retrieves I/O mode property setting for metadata writes. </li>
<li><a class="el" href="group___g_a_p_l.html#gac45976cb82e4d3f085f191e5872d0316" title="Sets metadata I/O mode for read operations to be collective or independent (default)">H5Pset_all_coll_metadata_ops</a> and <a class="el" href="group___f_h5_p.html#ga2f474900ac573840b49dc1e7c535ad57" title="Sets requirement whether HDF5 metadata read operations using the access property list are required to...">h5p.h5pset_all_coll_metadata_ops_f</a> - Establishes I/O mode, collective or independent, for metadata read operations. </li>
<li><a class="el" href="group___g_a_p_l.html#gaa278583dd1a989fa35a915def6518126" title="Retrieves metadata read mode setting.">H5Pget_all_coll_metadata_ops</a> and <a class="el" href="group___f_h5_p.html#ga2c510b552cd963653ddd278e2099324e" title="Retrieves metadata read mode from the access property list.">h5p.h5pget_all_coll_metadata_ops_f</a> - Retrieves I/O mode for metadata read operations.</li>
</ul>
<h4>Fine-tuning the Metadata Cache:</h4>
<ul>
<li><a class="el" href="group___s_w_m_r.html#gaa80bd62f19993e414e383db7d1623e5f" title="Retrieves the collection of read retries for metadata entries with checksum.">H5Fget_metadata_read_retry_info</a> - Retrieves the collection of read retries for metadata items with checksum. </li>
<li><a class="el" href="group___f_a_p_l.html#ga670948d56435920f1e1c2e88b823935e" title="Retrieves the number of read attempts from a file access property list.">H5Pget_metadata_read_attempts</a> - Retrieves the number of read attempts from a file access property list. </li>
<li><a class="el" href="group___f_a_p_l.html#gab827cef16ec569c87cec94a8b3f350c5" title="Sets the number of read attempts in a file access property list.">H5Pset_metadata_read_attempts</a> - Sets the number of read attempts in a file access property list. </li>
<li><a class="el" href="group___h5_d.html#ga4a2175a62baa1e35ad2467bb1fdff1f7" title="Flushes all buffers associated with a dataset to disk.">H5Dflush</a> - Causes all buffers associated with a dataset to be immediately written to disk without removing the data from the cache. </li>
<li><a class="el" href="group___h5_d.html#ga3c1ea7e5db3f62d9cf03dd62d1fb08da" title="Refreshes all buffers associated with a dataset.">H5Drefresh</a> - Causes all buffers associated with a dataset to be cleared and immediately re-loaded with updated contents from disk storage. </li>
<li><a class="el" href="group___h5_g.html#ga1d55dbf931f8003bb329c4340b8fe4d6" title="Flushes all buffers associated with a group to disk.">H5Gflush</a> - Causes all buffers associated with a group to be immediately flushed to disk without removing the data from the cache. </li>
<li><a class="el" href="group___h5_g.html#ga0a8bdd0eb1b001222c27d3d39a909840" title="Refreshes all buffers associated with a group.">H5Grefresh</a> - Causes all buffers associated with a group to be cleared and immediately re-loaded with updated contents from disk storage. </li>
<li><a class="el" href="group___h5_o.html#gad99f35048cba4534b6393214684f090f" title="Flushes all buffers associated with an HDF5 object to disk.">H5Oflush</a> - Causes all buffers associated with an object to be immediately flushed to disk without removing the data from the cache. </li>
<li><a class="el" href="group___h5_o.html#gaf0318b68be9ab23a92b8a6bee0af9e2f" title="Refreshes all buffers associated with an HDF5 object.">H5Orefresh</a> - Causes all buffers associated with an object to be cleared and immediately re-loaded with updated contents from disk storage. </li>
<li><a class="el" href="group___h5_t.html#gafd60389b49e1e5e6f37caffbe6cbf6e5" title="Flushes all buffers associated with a committed datatype to disk.">H5Tflush</a> - Causes all buffers associated with a committed datatype to be immediately flushed to disk without removing the data from the cache. </li>
<li><a class="el" href="group___h5_t.html#ga5bc56f6b85e114829dc12d6b18d66f4d" title="Refreshes all buffers associated with a committed datatype.">H5Trefresh</a> - Causes all buffers associated with a committed datatype to be cleared and immediately re-loaded with updated contents from disk storage. </li>
<li><a class="el" href="group___h5_f.html#ga466179d7783d256329c2e3110055a16c" title="Determines the read/write or read-only status of a file.">H5Fget_intent</a> - Determines the read/write or read-only status of a file.</li>
</ul>
<h4>Logging APIs:</h4>
<ul>
<li><a class="el" href="group___f_a_p_l.html#ga33ef5eda9cd47bfe827ea16d835a88ef" title="Sets metadata cache logging options.">H5Pset_mdc_log_options</a> - Sets metadata cache logging options. </li>
<li><a class="el" href="group___f_a_p_l.html#ga5da8039847bcbf091e92138b84c97374" title="Gets metadata cache logging options.">H5Pget_mdc_log_options</a> - Gets metadata cache logging options. </li>
<li><a class="el" href="group___m_d_c.html#ga378fb5863071278b47070cf205f53e67" title="Starts logging metadata cache events if logging was previously enabled.">H5Fstart_mdc_logging</a> - Starts logging metadata cache events if logging was previously enabled. </li>
<li><a class="el" href="group___m_d_c.html#ga78627b23010f82002b837f4d312bf234" title="Stops logging metadata cache events if logging was previously enabled and is currently ongoing.">H5Fstop_mdc_logging</a> - Stops logging metadata cache events if logging was previously enabled and is currently ongoing. </li>
<li>H5Pget_mdc_logging_status - Gets the current metadata cache logging status.</li>
</ul>
<h4>File Space Management:</h4>
<ul>
<li><a class="el" href="group___h5_f.html#gab9cbf1a45f9dcda34b43f985b7848434" title="Retrieves free-space section information for a file.">H5Fget_free_sections</a> - Retrieves free-space section information for a file. </li>
<li><a class="el" href="group___h5_f.html#ga3ef2673183567543346668a8f1eca2e9" title="Returns the amount of free space in a file (in bytes)">H5Fget_freespace</a> - Returns the amount of free space in a file. </li>
<li><a class="el" href="group___h5_f.html#gaced8c09c1559636a9c3f33dff3f4520e" title="Retrieves global file information.">H5Fget_info2</a> - Returns global information for a file. </li>
<li><a class="el" href="group___f_c_p_l.html#gad388f8cfa213762c6fc3e45619aa5db6" title="Sets the file space handling strategy and the free-space section size threshold.">H5Pset_file_space</a> - Sets the file space management strategy and/or the free-space section threshold for an HDF5 file. </li>
<li><a class="el" href="group___f_c_p_l.html#ga9873dad32f2be5b4bb41497e2fbf5619" title="Retrieves the file space handling strategy, and threshold value for a file creation property list.">H5Pget_file_space</a> - Retrieves the file space management strategy and/or the free-space section threshold for an HDF5 file.</li>
</ul>
<p>The following tool has been modified to preserve or modify file freepace information appropriately when processing files employing the VDS feature: </p><ul>
<li><a class="el" href="_h5_t_o_o_l__r_p__u_g.html#sec_cltools_h5repack">h5repack</a> - Repacks HDF5 files with various options, including the ability to change the applied filters. This version of <a class="el" href="_h5_t_o_o_l__r_p__u_g.html#sec_cltools_h5repack">h5repack</a> understands the file free space feature and handles the file and metadata appropriately.</li>
</ul>
<h4>Virtual Dataset or VDS:</h4>
<ul>
<li><a class="el" href="group___d_c_p_l.html#gadec895092dbbedb94f85d9cacf8924f5" title="Sets the mapping between virtual and source datasets.">H5Pset_virtual</a> and <a class="el" href="group___f_h5_p.html#gae79517ef6fb92e5502fe2d6e02a38055" title="Sets the mapping between virtual and source datasets.">h5p.h5pset_virtual_f</a> - Sets the mapping between virtual and source datasets. </li>
<li><a class="el" href="group___d_c_p_l.html#ga83dcce1ce110d1ff6eae0fb77d4a7c85" title="Gets the number of mappings for the virtual dataset.">H5Pget_virtual_count</a> and <a class="el" href="group___f_h5_p.html#ga7cb4df490b82b94a10a65884304bce5a" title="Gets the number of mappings for the virtual dataset.">h5p.h5pget_virtual_count_f</a> - Retrieves the number of mappings for the virtual dataset. </li>
<li><a class="el" href="group___d_c_p_l.html#ga6425cabbc055b66e218b4728d6eb911d" title="Gets a dataspace identifier for the selection within the virtual dataset used in the mapping.">H5Pget_virtual_vspace</a> and <a class="el" href="group___f_h5_p.html#ga536b63f0b4c7d36fa642896fe2649061" title="Gets a dataspace identifier for the selection within the virtual dataset used in the mapping.">h5p.h5pget_virtual_vspace_f</a> - Retrieves a dataspace identifier for the selection within the virtual dataset used in the mapping. </li>
<li><a class="el" href="group___d_c_p_l.html#ga8319e9386cdb9b3881a8b698edfc78fc" title="Gets a dataspace identifier for the selection within the source dataset used in the mapping.">H5Pget_virtual_srcspace</a> and <a class="el" href="group___f_h5_p.html#ga6f37ffbe3b61ce80c7b15d555892b29a" title="Gets a dataspace identifier for the selection within the source dataset used in the mapping.">h5p.h5pget_virtual_srcspace_f</a> - Retrieves a dataspace identifier for the selection within the source dataset used in the mapping. </li>
<li><a class="el" href="group___d_c_p_l.html#gaf50620fd5d83dc9ca1e5c3f374c5a952" title="Gets the name of a source dataset used in the mapping.">H5Pget_virtual_dsetname</a> and <a class="el" href="group___f_h5_p.html#gaa5fc72a7dcbb33b6fb6e095fabd613a5" title="Gets the name of a source dataset used in the mapping.">h5p.h5pget_virtual_dsetname_f</a> - Retrieves the name of a source dataset used in the mapping. </li>
<li><a class="el" href="group___d_c_p_l.html#ga5c17780cc9a72a0f62d70f6138510afa" title="Gets the filename of a source dataset used in the mapping.">H5Pget_virtual_filename</a> and <a class="el" href="group___f_h5_p.html#ga98ea9f23a221a8d6acff306b4d9ead57" title="Gets the filename of a source dataset used in the mapping.">h5p.h5pget_virtual_filename_f</a> - Retrieves the filename of a source dataset used in the mapping. </li>
<li><a class="el" href="group___d_a_p_l.html#ga8bb25e402e860133b8af3715e429bacf" title="Sets the maximum number of missing source files and/or datasets with the printf-style names when gett...">H5Pset_virtual_printf_gap</a> and <a class="el" href="group___f_h5_p.html#ga3dab2ea1f0db667f20264a459b29618c" title="Sets the maximum number of missing source files and/or datasets with the printf-style names when gett...">h5p.h5pset_virtual_printf_gap_f</a> - Sets maximum number of missing source files and/or datasets with printf-style names when getting the extent of an unlimited virtual dataset. </li>
<li><a class="el" href="group___d_a_p_l.html#ga833dfc6d9c87738c9d94b610e70a818f" title="Returns the maximum number of missing source files and/or datasets with the printf-style names when g...">H5Pget_virtual_printf_gap</a> and <a class="el" href="group___f_h5_p.html#gab22587e46aeb629e8cd560959add1b2a" title="Returns the maximum number of missing source files and/or datasets with the printf-style names when g...">h5p.h5pget_virtual_printf_gap_f</a> - Returns maximum number of missing source files and/or datasets with printf-style names when getting the extent for an unlimited virtual dataset. </li>
<li><a class="el" href="group___d_a_p_l.html#gac65520e7cd7748f93d94c4a42abd01b4" title="Sets the view of the virtual dataset (VDS) to include or exclude missing mapped elements.">H5Pset_virtual_view</a> and <a class="el" href="group___f_h5_p.html#ga2c419683a5fd4294c9a5609b9792302d" title="Sets the view of the virtual dataset (VDS) to include or exclude missing mapped elements.">h5p.h5pset_virtual_view_f</a> - Sets the view of the virtual dataset to include or exclude missing mapped elements. </li>
<li><a class="el" href="group___d_a_p_l.html#ga7173663654b085e8583ab609c988b47c" title="Retrieves the view of a virtual dataset accessed with dapl_id.">H5Pget_virtual_view</a> and <a class="el" href="group___f_h5_p.html#ga8be38ea17cde1d54a8ad6190b4a9d7ac" title="Retrieves the view of a virtual dataset accessed with dapl_id.">h5p.h5pget_virtual_view_f</a> - Retrieves the view of a virtual dataset.</li>
</ul>
<h4>Supporting Functions:</h4>
<ul>
<li><a class="el" href="group___h5_s.html#ga8a5bc33fae4be442093329f2cfec3f49" title="Determines if a hyperslab selection is regular.">H5Sis_regular_hyperslab</a> and <a class="el" href="group___f_h5_s.html#ga731731fa7cf01205dfebda21f345b1e9" title="Retrieves a regular hyperslab selection.">h5s.h5sis_regular_hyperslab_f</a> - Determines whether a hyperslab selection is regular. </li>
<li><a class="el" href="group___h5_s.html#gabc974bbc041538a1d3032729df2ddfc0" title="Retrieves a regular hyperslab selection.">H5Sget_regular_hyperslab</a> and <a class="el" href="group___f_h5_s.html#ga39a1446d99e209ed4b079f224877a819" title="Retrieves a regular hyperslab selection.">h5s.h5sget_regular_hyperslab_f</a> - Retrieves a regular hyperslab selection.</li>
</ul>
<h4>Modified Functions:</h4>
<p>The following pre-exising functions have been modified to understand virtual datasets. </p><ul>
<li><a class="el" href="group___d_c_p_l.html#ga75d80991a8f467e0d454c53a383ae7f9" title="Sets the type of storage used to store the raw data for a dataset.">H5Pset_layout</a> and <a class="el" href="group___f_h5_p.html#gacd1a2cc75724d9e97014d3a9fed69290" title="Sets the type of storage used store the raw data for a dataset.">h5p.h5pset_layout_f</a> - Specifies the layout to be used for a dataset. Virtual dataset, <a class="el" href="_h5_dpublic_8h.html#a57e163d4c263b585ca2d904996f5e06ea5c213e4ca5ea394669873ce66f558ad4">H5D_VIRTUAL</a>, has been added to the list of layouts available through this function. </li>
<li><a class="el" href="group___d_c_p_l.html#ga655530b0f40990507fedeef6b3068db3" title="Returns the layout of the raw data for a dataset.">H5Pget_layout</a> and <a class="el" href="group___f_h5_p.html#ga26b68df0ad3bff9f17acf95f75b212d2" title="Returns the layout of the raw data for a dataset.">h5p.h5pget_layout_f</a> - Retrieves the layout in use for a dataset. Virtual dataset, <a class="el" href="_h5_dpublic_8h.html#a57e163d4c263b585ca2d904996f5e06ea5c213e4ca5ea394669873ce66f558ad4">H5D_VIRTUAL</a>, has been added to the list of layouts.</li>
</ul>
<h4>Partial Edge Chunks:</h4>
<ul>
<li><a class="el" href="group___d_c_p_l.html#ga8e60618d9030dc1b99ad9c8ff7867873" title="Sets the edge chunk option in a dataset creation property list.">H5Pset_chunk_opts</a> - Sets a partial edge chunk option in a dataset access property list. </li>
<li><a class="el" href="group___d_c_p_l.html#ga6e8d8f6a14b79bd110e27666d95031cf" title="Retrieves the edge chunk option setting from a dataset creation property list.">H5Pget_chunk_opts</a> - Retrieves partial edge chunk option setting from a dataset access property list.</li>
</ul>
<h4>Relative Pathnames for External Links:</h4>
<ul>
<li><a class="el" href="group___l_a_p_l.html#gafa5eced13ba3a00cdd65669626dc7294" title="Sets prefix to be applied to external link paths.">H5Pset_elink_prefix</a> - Sets the prefix to be applied to external link paths. </li>
<li><a class="el" href="group___l_a_p_l.html#ga7960f746797bcf35f70746cd644f8b5a" title="Retrieves prefix applied to external link paths.">H5Pget_elink_prefix</a> - Retrieves the prefix applied to external link paths.</li>
</ul>
<p>These functions enable the user to specify the locations of external files. (These functions are not yet documented as of the time of release for 1.10.0.) </p><ul>
<li><a class="el" href="group___l_a_p_l.html#ga7960f746797bcf35f70746cd644f8b5a" title="Retrieves prefix applied to external link paths.">H5Pget_elink_prefix</a></li>
</ul>
<h4>Property List Encoding and Decoding:</h4>
<ul>
<li><a class="el" href="_h5version_8h.html#af1a9ff52a69251d57ffa686102f162a8">H5Pencode</a> </li>
<li><a class="el" href="group___p_l_c_r.html#gafd75009eb96922e72beffa78718d4bdd" title="Decodes property list received in a binary object buffer and returns a new property list identifier.">H5Pdecode</a></li>
</ul>
<h4>Additional New Functions:</h4>
<p>The following new functions appear in HDF5 Release 1.10.0 but are not yet documented: </p><ul>
<li>H5Dformat_convert </li>
<li>H5Dget_chunk_index_type </li>
<li><a class="el" href="_h5_f_ddevelop_8h.html#aa39b2020fc58111aa8e8e41b33af3406">H5FDlock</a> </li>
<li><a class="el" href="_h5_f_ddevelop_8h.html#aebafd003d12e6ec7b56548ce5c169b9d">H5FDunlock</a> </li>
<li>H5Fformat_convert </li>
<li><a class="el" href="group___h5_l_t.html#ga258e1d3f27bfc98ea9e1868f571fb76b" title="Retrieves the current dimension sizes of a dataset.">H5LDget_dset_dims</a> </li>
<li><a class="el" href="group___h5_l_t.html#gad367e75b3cde6cd3b6b372a538e0076e" title="Retrieves selected data from the dataset.">H5LDget_dset_elmts</a> </li>
<li><a class="el" href="group___h5_l_t.html#ga68f56a4c4d2e8b14407572eb2958f939" title="Returns the size in bytes of the dataset&#39;s datatype.">H5LDget_dset_type_size</a></li>
</ul>
<p>New and Changed Elements of the Packet Table (H5PT) High-level API </p><h4>In the C Interface</h4>
<p><b>Replacement functions:</b><br />
</p><ul>
<li><a class="el" href="group___h5_p_t.html#gadebf2e89c0d382bb6a97fbf3c35b3261" title="Creates a packet table to store fixed-length or variable-length packets.">H5PTcreate</a> - Takes a property list identifier to provide flexibility on creation properties. H5PTcreate_fl has been removed. </li>
<li><a class="el" href="group___h5_p_t.html#gab8a810a8ecca21eb24fe01ba142faf66" title="Releases memory allocated in the process of reading variable-length packets.">H5PTfree_vlen_buff</a> - Replaces H5PTfree_vlen_readbuff.</li>
</ul>
<p><b>New functions:</b><br />
Two accessor functions have been added. </p><ul>
<li><a class="el" href="group___h5_p_t.html#gaba97ace057d14ac0381456347bba45c0" title="Returns the backend dataset of this packet table.">H5PTget_dataset</a> - Returns the identifier of the dataset associated a packet table. </li>
<li><a class="el" href="group___h5_p_t.html#ga86cf3105b2aab245bedaa55ecd131d8d" title="Returns the backend datatype of this packet table.">H5PTget_type</a> - Returns the identifier of the datatype used by a packet table. </li>
<li><a class="el" href="group___h5_p_t.html#ga4d4d6aa197f39e07c1094363355cce50" title="Determines whether a packet table contains variable-length or fixed-length packets.">H5PTis_varlen</a> - Determines whether a type is variable-length.</li>
</ul>
<h4>In the C++ Interface</h4>
<p><b>Overloaded constructor</b><br />
An overloaded constructor has been added. </p><ul>
<li>FL_PacketTable - Takes a property list identifier to provide flexibility on creation properties. </li>
<li>H5PTfree_vlen_buff - Replaces H5PTfree_vlen_readbuff.</li>
</ul>
<p><b>Accessor wrappers</b><br />
Two accessor wrappers are added to class PacketTable. </p><ul>
<li>PacketTable::GetDataset() - Returns the identifier of the dataset associated a packet table. </li>
<li>PacketTable::GetDatatype() - Returns the identifier of the datatype used by a packet table.</li>
</ul>
<p><b>Other wrappers</b> </p><ul>
<li>PacketTable::FreeBuff() - Replaces VL_PacketTable::FreeReadBuff(). </li>
<li>PacketTable::IsVariableLength() - Replaces VL_PacketTable::IsVariableLength().</li>
</ul>
<p><b>Overloaded functions:</b><br />
Where a member functions has a char* as an argument, an overloaded functions has been added to provide the const char* argument. The existing version will be deprecated in a future release.</p>
<h4>Java Interface Changes</h4>
<ul>
<li>Integration into Main HDF5 Library - The Java HDF5 JNI library has been integrated into the HDF5 repository.</li>
</ul>
<p><b>Configure option:</b> </p><ul>
<li><code>&ndash;enable-java</code></li>
</ul>
<p><b>CMake option:</b> </p><ul>
<li><code>-DHDF5_BUILD_JAVA:BOOL=ON</code></li>
</ul>
<p>Prior to the 1.10.x series, the HDF5 Java tools were built from an independent repository and were not as fully integrated with HDF5. were built from an independent repository and were not as fully integrated with HDF5.</p>
<p><b>Package Hierarchy Change</b> </p><ul>
<li>The package hierarchy has changed to hdf.hdflib.hdf5. </li>
<li>Prior to the 1.10.x series, the hierarchy was ncsa.hdf.hdflib.hdf5.</li>
</ul>
<h4>New Java APIs</h4>
<p>A number of new APIs have been added in the Java interface, including APIs for the VDS and SWMR features.</p>
<h4>Functions with Changed Behavior</h4>
<ul>
<li><a class="el" href="group___h5_l.html#ga171be6e41dc1a464edc402df0ebdf801" title="Determines whether a link with the specified name exists in a group.">H5Lexists</a> - The behavior of this function has changed in this release. When testing the pathname / (a slash representing the root of an HDF5 file) <a class="el" href="group___h5_l.html#ga171be6e41dc1a464edc402df0ebdf801" title="Determines whether a link with the specified name exists in a group.">H5Lexists</a> now returns successfully with the value 1 (one). See the entry in the <a class="el" href="_r_m.html">HDF5 Reference Manual</a> for <a class="el" href="group___h5_l.html#ga171be6e41dc1a464edc402df0ebdf801" title="Determines whether a link with the specified name exists in a group.">H5Lexists</a> for more information.</li>
</ul>
<h2><a class="anchor" id="subsec_rel_spec_110_change_0versus8_16_apicompat"></a>
API Compatibility</h2>
<p>See <a class="el" href="api-compat-macros.html">API Compatibility Macros</a> for details on the following.</p>
<h4>New API Compatibility Flag</h4>
<p>A new v18 flag was added enabling the building of HDF5 such that the default API is compatible with the HDF5 Release 1.8.x API: </p><ul>
<li><code>&ndash;with-default-api-version=v18</code></li>
</ul>
<h4>New versioned functions and associated compatibility macros</h4>
<p>Two functions and a struct have been converted to a versioned form in this release. Compatibility macros have been created for each. </p><ul>
<li><a class="el" href="group___h5_f.html#gae17036b3e36a8777328204e8bf073144">H5Fget_info</a> - The original function is renamed to <a class="el" href="group___h5_f.html#ga660153029322fa6b77f5473cedc2d72f" title="Retrieves global file information.">H5Fget_info1</a> and deprecated. A new version of the function, <a class="el" href="group___h5_f.html#gaced8c09c1559636a9c3f33dff3f4520e" title="Retrieves global file information.">H5Fget_info2</a>, is introduced. The compatibility macro <a class="el" href="group___h5_f.html#gae17036b3e36a8777328204e8bf073144">H5Fget_info</a> is introduced. </li>
<li><a class="el" href="_h5version_8h.html#a9994ec490861defacf6aed24d12a938a">H5F_info_t</a> - This is the struct used by the <a class="el" href="group___h5_f.html#gae17036b3e36a8777328204e8bf073144">H5Fget_info</a> functions and macro. The original struct is renamed to <a class="el" href="struct_h5_f__info1__t.html">H5F_info1_t</a> and deprecated. A new version of the struct, <a class="el" href="struct_h5_f__info2__t.html">H5F_info2_t</a>, is introduced. The compatibility macro <a class="el" href="_h5version_8h.html#a9994ec490861defacf6aed24d12a938a">H5F_info_t</a> is introduced. </li>
<li><a class="el" href="group___h5_r.html#ga5dc19b9d1833af66c5e1f819f2c05c4a">H5Rdereference</a> - The original function is renamed to <a class="el" href="group___h5_r.html#gafe7bbbc168c4836949c4c0b092654c45" title="Opens the HDF5 object referenced.">H5Rdereference1</a> and deprecated. A new version of the function, <a class="el" href="group___h5_r.html#ga9b09586f7b6ec708434dd8f95f58a9b7" title="Opens the HDF5 object referenced.">H5Rdereference2</a>, is introduced. The compatibility macro <a class="el" href="group___h5_r.html#ga5dc19b9d1833af66c5e1f819f2c05c4a">H5Rdereference</a> is introduced.</li>
</ul>
<h2><a class="anchor" id="subsec_rel_spec_110_change_0versus8_16_auto"></a>
Autotools Configuration and Large File Support</h2>
<p>Autotools configuration has been extensively reworked and autotool's handling of large file support has been overhauled in this release.</p>
<p>See the following sections in RELEASE.txt: </p><ul>
<li>Autotools Configuration Has Been Extensively Reworked </li>
<li>LFS Changes</li>
</ul>
<p>RELEASE.txt can be found in the release_docs/ subdirectory at the root level of the HDF5 code distribution.</p>
<h2><a class="anchor" id="subsec_rel_spec_110_change_0versus8_16_compat"></a>
Compatibility Report and Comments</h2>
<p>[Compatibility report for Release 1.10.0 versus Release 1.8.16]()</p>
<p>Comments regarding the report</p>
<p>In the C interface, the <a class="el" href="_h5_ipublic_8h.html#a0045db7ff9c22ad35db6ae91662e1943">hid_t</a> change from 32-bit to 64-bit was made in order to address a performance problem that arose when the library "ran out" of valid object identifiers to issue and thus needed to employ an expensive algorithm to find previously issued identifiers that could be re-issued. This problem is avoided by switching the size of the <a class="el" href="_h5_ipublic_8h.html#a0045db7ff9c22ad35db6ae91662e1943">hid_t</a> type to 64-bit integers instead of 32-bit integers in order to make the pool of available integers significantly larger. (<a class="el" href="_h5_epublic_8h.html#a8b643ee74952ccb3b401eb97407070a8">H5E_major_t</a> and <a class="el" href="_h5_epublic_8h.html#a6a5b9e5fcbb4cf4cdc5d347e34d4af0a">H5E_minor_t</a> are aliased to <a class="el" href="_h5_ipublic_8h.html#a0045db7ff9c22ad35db6ae91662e1943">hid_t</a> which is why they changed size as well). (An alternate solution to this problem was applied in release HDF5 1.8.5 but this is the cleaner/preferred solution and had to wait until 1.10.0 to be included).</p>
<p><a class="el" href="_h5public_8h.html#ad470b00eccd2115c707c02de5fa1120d">hbool_t</a> will now be defined as a Bool type when configure determines that it's available.</p>
<p>Public structs that have members of type <a class="el" href="_h5_ipublic_8h.html#a0045db7ff9c22ad35db6ae91662e1943">hid_t</a> or <a class="el" href="_h5public_8h.html#ad470b00eccd2115c707c02de5fa1120d">hbool_t</a> are affected by the above changes accordingly.</p>
<p>The <a class="el" href="group___h5_f.html#gae17036b3e36a8777328204e8bf073144">H5Fget_info</a> function was renamed due to the introduction of a newer version of the function which returns additional information. The <a class="el" href="group___h5_r.html#ga5dc19b9d1833af66c5e1f819f2c05c4a">H5Rdereference</a> function was renamed due to the introduction of a newer version of the function which allows a data access property list to be passed in. Both changes are accompanied with compatibility macros, so while existing code will need to be recompiled in order to use the newer library version, these functions do not need to be changed in application code using them provided that the <a class="el" href="api-compat-macros.html">API Compatibility Macros</a> are configured appropriately.</p>
<hr />
<p> Navigate back: <a class="el" href="index.html">Main</a> / <a class="el" href="release_specific_info.html">Release Specific Information</a> / <a class="el" href="rel_spec_110.html">Release Specific Information for HDF5 1.10</a> </p>
</div></div><!-- contents -->
</div><!-- PageDoc -->
</div><!-- doc-content -->
<!-- start footer part -->
<div id="nav-path" class="navpath"><!-- id is needed for treeview function! -->
<ul>
<li class="footer">Generated by <a href="https://www.doxygen.org/index.html"><img class="footer" src="doxygen.svg" width="104" height="31" alt="doxygen"/></a> 1.13.2 </li>
</ul>
</div>
</body>
</html>