mirror of
https://github.com/HDFGroup/hdf5.git
synced 2026-09-25 04:09:44 +03:00
bmribler
+2
-2
@@ -29,7 +29,7 @@ ALIASES += PLURL="github.com/HDFGroup/hdf5_plugins/blob/master"
|
||||
|
||||
ALIASES += Bold{1}="<b>\1</b>"
|
||||
ALIASES += Emph{1}="<em>\1</em>"
|
||||
ALIASES += Code{1}="<tt>\1</tt>"
|
||||
ALIASES += TText{1}="<tt>\1</tt>"
|
||||
|
||||
################################################################################
|
||||
# Return values
|
||||
@@ -249,7 +249,7 @@ ALIASES += es_id{1}="\param[in] \1 Event set identifier"
|
||||
# Others
|
||||
################################################################################
|
||||
|
||||
ALIASES += cpp_c_api_note="\attention \Bold{C++ Developers using HDF5 C-API functions beware:}\n Several functions in this C-API take function pointers or callbacks as arguments. Examples include H5Pset_elink_cb(), H5Pset_type_conv_cb(), H5Tconvert(), and H5Ewalk2(). Application code must ensure that those callback functions return normally such to allow the HDF5 to manage its resources and maintain a consistent state. For instance, those functions must not use the C \c setjmp / \c longjmp mechanism to leave those callback functions. Within the context of C++, any exceptions thrown within the callback function must be caught, such as with a \Code{catch(…)} statement. Any exception state can be placed within the provided user data function call arguments, and may be thrown again once the calling function has returned. Exceptions raised and not handled inside the callback are not supported as it might leave the HDF5 library in an inconsistent state. Similarly, using C++20 coroutines cannot be used as callbacks, since they do not support plain return statements. If a callback function yields execution to another C++20 coroutine calling HDF5 functions as well, this may lead to undefined behavior."
|
||||
ALIASES += cpp_c_api_note="\attention \Bold{C++ Developers using HDF5 C-API functions beware:}\n Several functions in this C-API take function pointers or callbacks as arguments. Examples include H5Pset_elink_cb(), H5Pset_type_conv_cb(), H5Tconvert(), and H5Ewalk2(). Application code must ensure that those callback functions return normally such to allow the HDF5 to manage its resources and maintain a consistent state. For instance, those functions must not use the C \c setjmp / \c longjmp mechanism to leave those callback functions. Within the context of C++, any exceptions thrown within the callback function must be caught, such as with a \TText{catch(…)} statement. Any exception state can be placed within the provided user data function call arguments, and may be thrown again once the calling function has returned. Exceptions raised and not handled inside the callback are not supported as it might leave the HDF5 library in an inconsistent state. Similarly, using C++20 coroutines cannot be used as callbacks, since they do not support plain return statements. If a callback function yields execution to another C++20 coroutine calling HDF5 functions as well, this may lead to undefined behavior."
|
||||
ALIASES += par_compr_note="\attention If you are planning to use compression with parallel HDF5, ensure that calls to H5Dwrite() occur in collective mode. In other words, all MPI ranks (in the relevant communicator) call H5Dwrite() and pass a dataset transfer property list with the MPI-IO collective option property set to #H5FD_MPIO_COLLECTIVE_IO.\n Note that data transformations are currently \Bold{not} supported when writing to datasets in parallel and with compression enabled."
|
||||
ALIASES += sa_metadata_ops="\sa \li H5Pget_all_coll_metadata_ops() \li H5Pget_coll_metadata_write() \li H5Pset_all_coll_metadata_ops() \li H5Pset_coll_metadata_write() \li \ref maybe_metadata_reads"
|
||||
|
||||
|
||||
@@ -33,8 +33,8 @@ Please refer to the \ref RMT for guidance on how to create a new reference manua
|
||||
|
||||
\subsubsection new_example Adding and Referencing API Examples
|
||||
|
||||
For each HDF5 module, such as \Code{H5F}, there is an examples source file called
|
||||
\Code{H5*_examples.c}. For example, the \Code{H5F} API examples are located in
|
||||
For each HDF5 module, such as \TText{H5F}, there is an examples source file called
|
||||
\TText{H5*_examples.c}. For example, the \TText{H5F} API examples are located in
|
||||
<a href="https://\SRCURL/doxygen/examples/H5F_examples.c">
|
||||
<code>H5F_examples.c</code></a>. Examples are code blocks marked as Doxygen
|
||||
<a href="https://www.doxygen.nl/manual/commands.html#cmdsnippet">snippets</a>.
|
||||
@@ -94,7 +94,7 @@ ask for help if unsure!
|
||||
For ease of reference, we define custom commands for each RFC in the <tt>RFCs</tt> section
|
||||
of the
|
||||
<a href="https://\SRCURL/doxygen/aliases"><tt>aliases</tt></a>
|
||||
file. For example the custom command \Code{ref_rfc20141210} can be used to insert a
|
||||
file. For example the custom command \TText{ref_rfc20141210} can be used to insert a
|
||||
reference to "RFC: Virtual Object Layer". In other words, the markup
|
||||
\verbatim
|
||||
\ref_rfc20141210
|
||||
@@ -105,8 +105,8 @@ yields a clickable link:
|
||||
|
||||
To add a new RFC, add a custom command for the RFC to the
|
||||
<a href="https://\SRCURL/doxygen/aliases"><tt>aliases</tt></a>
|
||||
file. The naming convention for the custom command is \Code{ref_rfcYYYYMMDD},
|
||||
where \Code{YYYYMMDD} is the ID of the RFC. The URL is composed of the prefix
|
||||
file. The naming convention for the custom command is \TText{ref_rfcYYYYMMDD},
|
||||
where \TText{YYYYMMDD} is the ID of the RFC. The URL is composed of the prefix
|
||||
\verbatim
|
||||
https://\RFCURL/
|
||||
\endverbatim
|
||||
@@ -116,4 +116,4 @@ be
|
||||
https://\RFCURL/my_great_rfc_name.pdf
|
||||
\endverbatim
|
||||
|
||||
*/
|
||||
*/
|
||||
|
||||
@@ -24,7 +24,7 @@
|
||||
* Boolean field indicating whether the trace_file_name
|
||||
* field should be used to open a trace file for the cache.
|
||||
*
|
||||
* \Emph{*** DEPRECATED ***} Use \Code{H5Fstart/stop} logging functions instead
|
||||
* \Emph{*** DEPRECATED ***} Use \TText{H5Fstart/stop} logging functions instead
|
||||
*
|
||||
* The trace file is a debugging feature that allow the capture of
|
||||
* top level metadata cache requests for purposes of debugging and/or
|
||||
@@ -42,7 +42,7 @@
|
||||
* Boolean field indicating whether the current trace
|
||||
* file (if any) should be closed.
|
||||
*
|
||||
* \Emph{*** DEPRECATED ***} Use \Code{H5Fstart/stop} logging functions instead
|
||||
* \Emph{*** DEPRECATED ***} Use \TText{H5Fstart/stop} logging functions instead
|
||||
*
|
||||
* See the above comments on the open_trace_file field. This field
|
||||
* should be set to \c FALSE unless there is an open trace file on the
|
||||
@@ -54,7 +54,7 @@
|
||||
* Full path of the trace file to be opened if the
|
||||
* open_trace_file field is \c TRUE.
|
||||
*
|
||||
* \Emph{*** DEPRECATED ***} Use \Code{H5Fstart/stop} logging functions instead
|
||||
* \Emph{*** DEPRECATED ***} Use \TText{H5Fstart/stop} logging functions instead
|
||||
*
|
||||
* In the parallel case, an ascii representation of the mpi rank of
|
||||
* the process will be appended to the file name to yield a unique
|
||||
@@ -78,7 +78,7 @@
|
||||
* soon as possible and monitor cache size.
|
||||
*
|
||||
* At present, evictions can only be disabled if automatic
|
||||
* cache resizing is also disabled (that is, \Code{(incr_mode ==
|
||||
* cache resizing is also disabled (that is, \TText{(incr_mode ==
|
||||
* H5C_incr__off ) && ( decr_mode == H5C_decr__off )}). There
|
||||
* is no logical reason why this should be so, but it simplifies
|
||||
* implementation and testing, and I can't think of any reason
|
||||
@@ -95,7 +95,7 @@
|
||||
* \par initial_size
|
||||
* If enabled, this field contain the size the cache is
|
||||
* to be set to upon receipt of this structure. Needless to say,
|
||||
* initial_size must lie in the closed interval \Code{[min_size, max_size]}.
|
||||
* initial_size must lie in the closed interval \TText{[min_size, max_size]}.
|
||||
*
|
||||
* \par min_clean_fraction
|
||||
* \c double in the range 0 to 1 indicating the fraction
|
||||
@@ -105,13 +105,13 @@
|
||||
* \par max_size
|
||||
* Maximum size to which the cache can be adjusted. The
|
||||
* supplied value must fall in the closed interval
|
||||
* \Code{[MIN_MAX_CACHE_SIZE, MAX_MAX_CACHE_SIZE]}. Also, \c max_size must
|
||||
* \TText{[MIN_MAX_CACHE_SIZE, MAX_MAX_CACHE_SIZE]}. Also, \c max_size must
|
||||
* be greater than or equal to \c min_size.
|
||||
*
|
||||
* \par min_size
|
||||
* Minimum size to which the cache can be adjusted. The
|
||||
* supplied value must fall in the closed interval
|
||||
* \Code{[H5C__MIN_MAX_CACHE_SIZE, H5C__MAX_MAX_CACHE_SIZE]}. Also, \c min_size
|
||||
* \TText{[H5C__MIN_MAX_CACHE_SIZE, H5C__MAX_MAX_CACHE_SIZE]}. Also, \c min_size
|
||||
* must be less than or equal to \c max_size.
|
||||
*
|
||||
* \par epoch_length
|
||||
@@ -122,7 +122,7 @@
|
||||
*
|
||||
* At the end of an epoch, we discard prior hit rate data and start
|
||||
* collecting afresh. The epoch_length must lie in the closed
|
||||
* interval \Code{[H5C__MIN_AR_EPOCH_LENGTH, H5C__MAX_AR_EPOCH_LENGTH]}.
|
||||
* interval \TText{[H5C__MIN_AR_EPOCH_LENGTH, H5C__MAX_AR_EPOCH_LENGTH]}.
|
||||
* \endparblock
|
||||
*
|
||||
*
|
||||
@@ -201,8 +201,8 @@
|
||||
* \li \c H5C_flash_incr__add_space: Let \c x be either the size of a newly
|
||||
* newly inserted entry, or the number of bytes by which the
|
||||
* size of an existing entry has been increased.\n
|
||||
* If \Code{x > flash_threshold * current max cache size},
|
||||
* increase the current maximum cache size by \Code{x * flash_multiple}
|
||||
* If \TText{x > flash_threshold * current max cache size},
|
||||
* increase the current maximum cache size by \TText{x * flash_multiple}
|
||||
* less any free space in the cache, and star a new epoch. For
|
||||
* now at least, pay no attention to the maximum increment.
|
||||
*
|
||||
@@ -213,7 +213,7 @@
|
||||
* With a little thought, it should be obvious that the above flash
|
||||
* cache size increase algorithm is not sufficient for all circumstances
|
||||
* -- for example, suppose the user round robins through
|
||||
* \Code{(1/flash_threshold) +1} groups, adding one data set to each on each
|
||||
* \TText{(1/flash_threshold) +1} groups, adding one data set to each on each
|
||||
* pass. Then all will increase in size at about the same time, requiring
|
||||
* the max cache size to at least double to maintain acceptable
|
||||
* performance, however the above flash increment algorithm will not be
|
||||
@@ -319,7 +319,7 @@
|
||||
* This field contains the number of epochs an entry must remain
|
||||
* unaccessed before it is evicted in an attempt to reduce the
|
||||
* cache size. If applicable, this field must lie in the range
|
||||
* \Code{[1, H5C__MAX_EPOCH_MARKERS]}.
|
||||
* \TText{[1, H5C__MAX_EPOCH_MARKERS]}.
|
||||
* \endparblock
|
||||
*
|
||||
* \par apply_empty_reserve
|
||||
@@ -412,4 +412,4 @@
|
||||
* received from process zero.\n
|
||||
* To avoid possible messages from the past/future, all caches must
|
||||
* wait until all caches are done before leaving the sync point.
|
||||
*/
|
||||
*/
|
||||
|
||||
@@ -508,7 +508,7 @@ The \ref H5AC_cache_config_t.min_clean_fraction "min_clean_fraction" sets the
|
||||
current minimum clean size as a fraction of the current max cache size. While
|
||||
this field was originally used only in the parallel version of the library, it
|
||||
now applies to the serial version as well. Its value must lie in the range
|
||||
\Code{[0.0, 1.0]}. 0.01 is reasonable in the serial case, and 0.3 in the
|
||||
\TText{[0.0, 1.0]}. 0.01 is reasonable in the serial case, and 0.3 in the
|
||||
parallel.
|
||||
|
||||
A potential interaction, discovered at release 1.8.3, between the enforcement of
|
||||
@@ -524,15 +524,15 @@ H5AC_cache_config_t.min_size "min_size" fields specify the range of maximum
|
||||
sizes that may be set for the cache by the automatic resize code. \ref
|
||||
H5AC_cache_config_t.min_size "min_size" must be less than or equal to
|
||||
\ref H5AC_cache_config_t.max_size "max_size", and both must lie in the range
|
||||
\Code{[H5C__MIN_MAX_CACHE_SIZE, H5C__MAX_MAX_CACHE_SIZE]} -- currently [1 KB,
|
||||
\TText{[H5C__MIN_MAX_CACHE_SIZE, H5C__MAX_MAX_CACHE_SIZE]} -- currently [1 KB,
|
||||
128 MB]. If you routinely run a cache size in the top half of this range, you
|
||||
should increase the hash table size. To do this, modify the \c
|
||||
H5C__HASH_TABLE_LEN \Code{\#define} in \c H5Cpkg.h and re-compile. At present,
|
||||
H5C__HASH_TABLE_LEN \TText{\#define} in \c H5Cpkg.h and re-compile. At present,
|
||||
\c H5C__HASH_TABLE_LEN must be a power of two.
|
||||
|
||||
The \c epoch_length is the number of cache accesses between runs of the adaptive
|
||||
cache size control algorithms. It is ignored if these algorithms are turned
|
||||
off. It must lie in the range \Code{[H5C__MIN_AR_EPOCH_LENGTH,
|
||||
off. It must lie in the range \TText{[H5C__MIN_AR_EPOCH_LENGTH,
|
||||
H5C__MAX_AR_EPOCH_LENGTH]} -- currently [100, 1000000]. The above constants are
|
||||
defined in \c H5Cprivate.h. 50000 is a reasonable value.
|
||||
|
||||
@@ -570,7 +570,7 @@ fields in the section are then used as follows:
|
||||
|
||||
\ref H5AC_cache_config_t.lower_hr_threshold "lower_hr_threshold" is the
|
||||
threshold below which the hit rate must fall to trigger an increase. The value
|
||||
must lie in the range \Code{[0.0 - 1.0]}. In my tests, a relatively high value
|
||||
must lie in the range \TText{[0.0 - 1.0]}. In my tests, a relatively high value
|
||||
seems to work best -- 0.9 for example.
|
||||
|
||||
\ref H5AC_cache_config_t.increment "increment" is the factor by which the old
|
||||
@@ -601,7 +601,7 @@ Let \c x be either the size of the newly inserted entry, the size of the newly
|
||||
loaded entry, or the number of bytes added to the size of the entry under
|
||||
consideration for triggering a flash cache size increase.
|
||||
|
||||
If \Code{t < x}, the basic condition for a flash cache size increase is met, and
|
||||
If \TText{t < x}, the basic condition for a flash cache size increase is met, and
|
||||
we proceed as follows:
|
||||
|
||||
Let \c space_needed equal \c x less the amount of free space in the cache.
|
||||
@@ -622,11 +622,11 @@ use.
|
||||
|
||||
The use of the \ref H5AC_cache_config_t.flash_threshold "flash_threshold" field
|
||||
is discussed above. It must be a floating-point value in the range of
|
||||
\Code{[0.1, 1.0]}. 0.25 is a reasonable value.
|
||||
\TText{[0.1, 1.0]}. 0.25 is a reasonable value.
|
||||
|
||||
The use of the \ref H5AC_cache_config_t.flash_multiple "flash_multiple" field is
|
||||
also discussed above. It must be a floating-point value in the range of
|
||||
\Code{[0.1, 10.0]}. 1.4 is a reasonable value.
|
||||
\TText{[0.1, 10.0]}. 1.4 is a reasonable value.
|
||||
|
||||
\subsection decrement Decrement Configuration
|
||||
|
||||
@@ -649,12 +649,12 @@ the decrement section are used as follows:
|
||||
|
||||
\ref H5AC_cache_config_t.upper_hr_threshold "upper_hr_threshold" is the
|
||||
threshold above which the hit rate must rise to trigger cache size reduction. It
|
||||
must be in the range \Code{[0.0, 1.0]}. In my synthetic tests, very high values
|
||||
must be in the range \TText{[0.0, 1.0]}. In my synthetic tests, very high values
|
||||
like .9995 or .99995 seemed to work best.
|
||||
|
||||
\ref H5AC_cache_config_t.decrement "decrement" is the factor by which the
|
||||
current maximum cache size is multiplied to obtain a tentative new maximum cache
|
||||
size. It must lie in the range \Code{[0.0, 1.0]}. Relatively large values like
|
||||
size. It must lie in the range \TText{[0.0, 1.0]}. Relatively large values like
|
||||
.9 seem to work best in my synthetic tests. Note that the actual size reduction
|
||||
may be smaller as required by \ref H5AC_cache_config_t.min_size "min_size" and
|
||||
\ref H5AC_cache_config_t.max_decrement "max_decrement" (discussed below). \ref
|
||||
@@ -676,7 +676,7 @@ decrement section are used as follows:
|
||||
|
||||
\ref H5AC_cache_config_t.epochs_before_eviction "epochs_before_eviction" is the
|
||||
number of epochs an entry must reside unaccessed in the cache before it is
|
||||
evicted. This value must lie in the range \Code{[1, H5C__MAX_EPOCH_MARKERS]}. \c
|
||||
evicted. This value must lie in the range \TText{[1, H5C__MAX_EPOCH_MARKERS]}. \c
|
||||
H5C__MAX_EPOCH_MARKERS is defined in H5Cprivate.h, and is currently set to 10.
|
||||
|
||||
\ref H5AC_cache_config_t.apply_max_decrement "apply_max_decrement" and \ref
|
||||
@@ -702,7 +702,7 @@ H5AC_cache_config_t.upper_hr_threshold "upper_hr_threshold".
|
||||
|
||||
Here, \ref H5AC_cache_config_t.upper_hr_threshold "upper_hr_threshold" is the
|
||||
threshold above which the hit rate must rise to trigger cache size reduction. It
|
||||
must be in the range \Code{[0.0, 1.0]}. In my synthetic tests, high values like
|
||||
must be in the range \TText{[0.0, 1.0]}. In my synthetic tests, high values like
|
||||
.999 seemed to work well.
|
||||
|
||||
\subsection parallel Parallel Configuration
|
||||
@@ -1017,4 +1017,4 @@ and the average successful and unsuccessful search depths in the hash table. If
|
||||
these latter figures are significantly above 1, you should increase the size of
|
||||
the hash table.
|
||||
|
||||
*/
|
||||
*/
|
||||
|
||||
@@ -151,18 +151,18 @@ Follow these simple rules and stay out of trouble:
|
||||
identifiers, which you typically obtain by creating new HDF5 items, copying
|
||||
items, or retrieving facets of items. Consequently, \Bold{and most importantly}, you are
|
||||
responsible for releasing the underlying
|
||||
resources via the matching \Code{H5*close()} call, or deal with the consequences
|
||||
resources via the matching \TText{H5*close()} call, or deal with the consequences
|
||||
of resource leakage.
|
||||
\li \Bold{Closed means closed:} Do not pass identifiers that were previously
|
||||
\Code{H5*close()}-d to other API functions! It will generate an error.
|
||||
\TText{H5*close()}-d to other API functions! It will generate an error.
|
||||
\li \Bold{Dynamic memory allocation:} The API contains a few functions in which the
|
||||
HDF5 library dynamically allocates memory on the caller's behalf. The caller owns
|
||||
this memory and eventually must free it by calling H5free_memory() and not language-explicit memory functions.
|
||||
\li \Bold{Don't modify while iterating:} Do not modify the underlying collection when an
|
||||
iteration is in progress!
|
||||
\li \Bold{Use of locations:} Certain API functions, typically called \Code{H5***_by_name}
|
||||
\li \Bold{Use of locations:} Certain API functions, typically called \TText{H5***_by_name}
|
||||
use a combination of identifiers and path names to refer to HDF5 objects.
|
||||
If the identifier fully specifies the object in question, pass \Code{'.'} (a dot)
|
||||
If the identifier fully specifies the object in question, pass \TText{'.'} (a dot)
|
||||
for the name!
|
||||
|
||||
</td>
|
||||
|
||||
+195
-195
@@ -52,36 +52,36 @@
|
||||
functions were retained and renamed to have an earlier number (for, e.g., '1')
|
||||
at the end of the original function name.
|
||||
|
||||
For example, consider the function \Code{H5Lvisit} in HDF5 release 1.10
|
||||
For example, consider the function \TText{H5Lvisit} in HDF5 release 1.10
|
||||
as compared with 1.12:
|
||||
|
||||
<table>
|
||||
<tr>
|
||||
<th>Original function name and signature in 1.10.0</th>
|
||||
<td colspan="1">
|
||||
\Code{herr_t H5Lvisit(hid_t grp_id, H5_index_t idx_type, H5_iter_order_t order, H5L_iterate_t op, void *op_data)}
|
||||
\TText{herr_t H5Lvisit(hid_t grp_id, H5_index_t idx_type, H5_iter_order_t order, H5L_iterate_t op, void *op_data)}
|
||||
</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<th>Updated function and signature, introduced in release 1.12.0</th>
|
||||
<td colspan="1">
|
||||
\Code{herr_t H5Lvisit2(hid_t group_id, H5_index_t idx_type, H5_iter_order_t order, H5L_iterate2_t op, void *op_data)}
|
||||
\TText{herr_t H5Lvisit2(hid_t group_id, H5_index_t idx_type, H5_iter_order_t order, H5L_iterate2_t op, void *op_data)}
|
||||
</td>
|
||||
</tr>
|
||||
<tr><th>Original function and signature, renamed in release 1.12.0</th>
|
||||
<td colspan="1">
|
||||
\Code{herr_t H5Lvisit1(hid_t group_id, H5_index_t idx_type, H5_iter_order_t order, H5L_iterate1_t op, void *op_data)}
|
||||
\TText{herr_t H5Lvisit1(hid_t group_id, H5_index_t idx_type, H5_iter_order_t order, H5L_iterate1_t op, void *op_data)}
|
||||
</td>
|
||||
</tr>
|
||||
<tr><th>API compatibility macro, introduced in release 1.12.0</th>
|
||||
<td colspan="1">
|
||||
\Code{H5Lvisit}
|
||||
<p>The macro, \Code{H5Lvisit}, will be mapped to either \Code{H5Lvisit1} or
|
||||
\Code{H5Lvisit2}. The mapping is determined by a combination of the
|
||||
\TText{H5Lvisit}
|
||||
<p>The macro, \TText{H5Lvisit}, will be mapped to either \TText{H5Lvisit1} or
|
||||
\TText{H5Lvisit2}. The mapping is determined by a combination of the
|
||||
configuration options use to build the HDF5 library and compile-time
|
||||
options used to build the application. The calling parameters used with the
|
||||
\Code{H5Lvisit} compatibility macro should match the number and type of the
|
||||
function the macros will be mapped to (\Code{H5Lvisit1} or \Code{H5Lvisit2}).
|
||||
\TText{H5Lvisit} compatibility macro should match the number and type of the
|
||||
function the macros will be mapped to (\TText{H5Lvisit1} or \TText{H5Lvisit2}).
|
||||
</p>
|
||||
<p>The function names ending in '1' or '2' are referred to as \Emph{versioned names},
|
||||
and the corresponding functions are referred to as \Emph{versioned functions}.
|
||||
@@ -135,7 +135,7 @@
|
||||
</table>
|
||||
|
||||
\subsection lib-options Library Mapping Options
|
||||
When the HDF5 library is built, \Code{configure} flags can be used to control the API
|
||||
When the HDF5 library is built, \TText{configure} flags can be used to control the API
|
||||
compatibility macro mapping behavior exhibited by the library. This behavior can be
|
||||
overridden by application and function mappings. One configure flag excludes deprecated
|
||||
functions from the HDF5 library, making them unavailable to applications linked with the
|
||||
@@ -144,85 +144,85 @@
|
||||
<div align="center">Table 1: Library Mapping Options
|
||||
<table border="1" cellpadding="3">
|
||||
<tr>
|
||||
<th>\Code{configure} flag</th>
|
||||
<th>Macros map to release <br/> (versioned function; \Code{H5Lvisit} shown)</th>
|
||||
<th>Deprecated functions available? <br/> (\Code{H5Lvisit1})</th>
|
||||
<th>\TText{configure} flag</th>
|
||||
<th>Macros map to release <br/> (versioned function; \TText{H5Lvisit} shown)</th>
|
||||
<th>Deprecated functions available? <br/> (\TText{H5Lvisit1})</th>
|
||||
</tr>
|
||||
<tr align="center">
|
||||
<td>\Code{--with-default-api-version=v112} <br/> (the default in 1.12)</td>
|
||||
<td>1.12.x (\Code{H5Lvisit2})</td>
|
||||
<td>\TText{--with-default-api-version=v112} <br/> (the default in 1.12)</td>
|
||||
<td>1.12.x (\TText{H5Lvisit2})</td>
|
||||
<td>yes</td>
|
||||
</tr>
|
||||
<tr align="center">
|
||||
<td align="left">\Code{--with-default-api-version=v110}</td>
|
||||
<td>1.10.x (\Code{H5Lvisit1})</td>
|
||||
<td align="left">\TText{--with-default-api-version=v110}</td>
|
||||
<td>1.10.x (\TText{H5Lvisit1})</td>
|
||||
<td>yes</td>
|
||||
</tr>
|
||||
<tr align="center">
|
||||
<td align="left">\Code{--with-default-api-version=v18}</td>
|
||||
<td>1.8.x (\Code{H5Lvisit1})</td>
|
||||
<td align="left">\TText{--with-default-api-version=v18}</td>
|
||||
<td>1.8.x (\TText{H5Lvisit1})</td>
|
||||
<td>yes</td>
|
||||
</tr>
|
||||
<tr align="center">
|
||||
<td align="left">\Code{--with-default-api-version=v16}</td>
|
||||
<td>1.6.x (\Code{H5Lvisit1})</td>
|
||||
<td align="left">\TText{--with-default-api-version=v16}</td>
|
||||
<td>1.6.x (\TText{H5Lvisit1})</td>
|
||||
<td>yes</td>
|
||||
</tr>
|
||||
<tr align="center">
|
||||
<td align="left">\Code{--disable-deprecated-symbols}</td>
|
||||
<td>1.12.x (\Code{H5Lvisit2})</td>
|
||||
<td align="left">\TText{--disable-deprecated-symbols}</td>
|
||||
<td>1.12.x (\TText{H5Lvisit2})</td>
|
||||
<td>no</td>
|
||||
</tr>
|
||||
</table>
|
||||
</div>
|
||||
Refer to the file \Code{libhdf5.settings} in the directory where the HDF5 library is
|
||||
installed to determine the \Code{configure} flags used to build the library. In particular,
|
||||
Refer to the file \TText{libhdf5.settings} in the directory where the HDF5 library is
|
||||
installed to determine the \TText{configure} flags used to build the library. In particular,
|
||||
look for the two lines shown here under \Emph{Features}:
|
||||
|
||||
\Code{Default API mapping: v112}
|
||||
\TText{Default API mapping: v112}
|
||||
|
||||
\Code{With deprecated public symbols: yes}
|
||||
\TText{With deprecated public symbols: yes}
|
||||
|
||||
\subsection app-options Application Mapping Options
|
||||
When an application using HDF5 APIs is built and linked with the HDF5 library,
|
||||
compile-time options to \Code{h5cc} can be used to control the API compatibility
|
||||
compile-time options to \TText{h5cc} can be used to control the API compatibility
|
||||
macro mapping behavior exhibited by the application. The application mapping
|
||||
overrides the behavior specified by the library mapping, and can be overridden
|
||||
on a function-by-function basis by the function mappings.
|
||||
|
||||
If the HDF5 library was configured with the \Code{--disable-deprecated-symbols} flag, then
|
||||
If the HDF5 library was configured with the \TText{--disable-deprecated-symbols} flag, then
|
||||
the deprecated functions will not be available, regardless of the application mapping options.
|
||||
|
||||
<div align="center">Table 2: Application Mapping Options
|
||||
<table border="1" cellpadding="3">
|
||||
<tr>
|
||||
<th>\Code{h5cc} option</th>
|
||||
<th>Macros map to release <br/>(versioned function; \Code{H5Lvisit} shown)</th>
|
||||
<th>Deprecated functions available? <br/>(\Code{H5Lvisit1})</th>
|
||||
<th>\TText{h5cc} option</th>
|
||||
<th>Macros map to release <br/>(versioned function; \TText{H5Lvisit} shown)</th>
|
||||
<th>Deprecated functions available? <br/>(\TText{H5Lvisit1})</th>
|
||||
</tr>
|
||||
<tr align="center">
|
||||
<td align="left">\Code{-DH5_USE_112_API} <br/> \Emph{(Default behavior if no option specified.)}</td>
|
||||
<td>1.12.x (\Code{HLvisit2})</td>
|
||||
<td align="left">\TText{-DH5_USE_112_API} <br/> \Emph{(Default behavior if no option specified.)}</td>
|
||||
<td>1.12.x (\TText{HLvisit2})</td>
|
||||
<td>yes* <br/> \Emph{*if available in library}</td>
|
||||
</tr>
|
||||
<tr align="center">
|
||||
<td align="left">\Code{-DH5_USE_110_API}</td>
|
||||
<td>1.10.x (\Code{HLvisit1})</td>
|
||||
<td align="left">\TText{-DH5_USE_110_API}</td>
|
||||
<td>1.10.x (\TText{HLvisit1})</td>
|
||||
<td>yes* <br/> \Emph{*if available in library}</td>
|
||||
</tr>
|
||||
<tr align="center">
|
||||
<td align="left">\Code{-DH5_USE_18_API}</td>
|
||||
<td>1.8.x (\Code{H5Lvisit1})</td>
|
||||
<td align="left">\TText{-DH5_USE_18_API}</td>
|
||||
<td>1.8.x (\TText{H5Lvisit1})</td>
|
||||
<td>yes* <br/> \Emph{*if available in library}</td>
|
||||
</tr>
|
||||
<tr align="center">
|
||||
<td align="left">\Code{-DH5_USE_16_API}</td>
|
||||
<td>1.6.x (\Code{H5Lvisit1})</td>
|
||||
<td align="left">\TText{-DH5_USE_16_API}</td>
|
||||
<td>1.6.x (\TText{H5Lvisit1})</td>
|
||||
<td>yes* <br/> \Emph{*if available in library}</td>
|
||||
</tr>
|
||||
<tr align="center">
|
||||
<td align="left">\Code{-DH5_NO_DEPRECATED_SYMBOLS}</td>
|
||||
<td>1.10.x (\Code{H5Lvisit1})</td>
|
||||
<td align="left">\TText{-DH5_NO_DEPRECATED_SYMBOLS}</td>
|
||||
<td>1.10.x (\TText{H5Lvisit1})</td>
|
||||
<td>no</td>
|
||||
</tr>
|
||||
</table>
|
||||
@@ -234,15 +234,15 @@
|
||||
underlying functions on a function-by-function basis. The function mappings
|
||||
override the library and application mappings discussed earlier.
|
||||
|
||||
If the HDF5 library was configured with the \Code{--disable-deprecated-symbols}
|
||||
flag, or \Code{-DH5_NO_DEPRECATED_SYMBOLS} is used to compile the application,
|
||||
If the HDF5 library was configured with the \TText{--disable-deprecated-symbols}
|
||||
flag, or \TText{-DH5_NO_DEPRECATED_SYMBOLS} is used to compile the application,
|
||||
then the deprecated functions will not be available, regardless of the function
|
||||
mapping options.
|
||||
|
||||
For every function with multiple available versions, a compile-time version flag
|
||||
can be defined to selectively map the function macro to the desired versioned
|
||||
function. The function mapping consists of the function name followed by
|
||||
"\Code{_vers}" which is mapped by number to a specific function or
|
||||
"\TText{_vers}" which is mapped by number to a specific function or
|
||||
struct:
|
||||
<table>
|
||||
<tr>
|
||||
@@ -250,33 +250,33 @@
|
||||
<th>Function Mapping</th>
|
||||
<th>Mapped to function or struct</th>
|
||||
</tr>
|
||||
<tr><td>\Code{H5xxx}</td>
|
||||
<td>\Code{H5xxx_vers=1}</td>
|
||||
<td>\Code{H5xxx1}</td>
|
||||
<tr><td>\TText{H5xxx}</td>
|
||||
<td>\TText{H5xxx_vers=1}</td>
|
||||
<td>\TText{H5xxx1}</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td> </td>
|
||||
<td>\Code{H5xxx_vers=2}</td>
|
||||
<td>\Code{H5xxx2}</td>
|
||||
<td>\TText{H5xxx_vers=2}</td>
|
||||
<td>\TText{H5xxx2}</td>
|
||||
</tr>
|
||||
</table>
|
||||
|
||||
For example, in version 1.10 the \Code{H5Rreference} macro can be mapped to
|
||||
either \Code{H5Rreference1} or \Code{H5Rreference2}. When used, the value of
|
||||
the \Code{H5Rreference_vers} compile-time version flag determines which
|
||||
For example, in version 1.10 the \TText{H5Rreference} macro can be mapped to
|
||||
either \TText{H5Rreference1} or \TText{H5Rreference2}. When used, the value of
|
||||
the \TText{H5Rreference_vers} compile-time version flag determines which
|
||||
function will be called:
|
||||
|
||||
<ul>
|
||||
<li>When \Code{H5Rreference_vers} is set to \Code{1}, the macro \Code{H5Rreference}
|
||||
will be mapped to \Code{H5Rreference1}. <br/>
|
||||
\Code{H5cc ... -DH5Rreference_vers=1 ...}</li>
|
||||
<li>When \Code{H5Rdereference_vers} is set to \Code{2}, the macro \Code{H5Rdereference}
|
||||
will be mapped to \Code{H5Rdereference2}. <br/>
|
||||
\Code{h5cc ... -DH5Rreference_vers=2 ...}</li>
|
||||
<li>When \Code{H5Rreference_vers} is not set, the macro \Code{H5Rreference} will be
|
||||
mapped to either \Code{H5Rreference1} or \Code{H5Rreference2}, based on the
|
||||
<li>When \TText{H5Rreference_vers} is set to \TText{1}, the macro \TText{H5Rreference}
|
||||
will be mapped to \TText{H5Rreference1}. <br/>
|
||||
\TText{H5cc ... -DH5Rreference_vers=1 ...}</li>
|
||||
<li>When \TText{H5Rdereference_vers} is set to \TText{2}, the macro \TText{H5Rdereference}
|
||||
will be mapped to \TText{H5Rdereference2}. <br/>
|
||||
\TText{h5cc ... -DH5Rreference_vers=2 ...}</li>
|
||||
<li>When \TText{H5Rreference_vers} is not set, the macro \TText{H5Rreference} will be
|
||||
mapped to either \TText{H5Rreference1} or \TText{H5Rreference2}, based on the
|
||||
application mapping, if one was specified, or on the library mapping. <br/>
|
||||
\Code{h5cc ... }</li>
|
||||
\TText{h5cc ... }</li>
|
||||
</ul>
|
||||
|
||||
\warning Please be aware that some function mappings use mapped structures, as
|
||||
@@ -285,10 +285,10 @@
|
||||
plus EVERY function that uses the mapped structure, whether or not that
|
||||
function is used in the application. \Emph{In 1.12, mappings of structures
|
||||
are used by the H5L and H5O function mappings.}\n\n
|
||||
For example, an application \Code{application.c} only calls \Code{H5Lvisit},
|
||||
\Code{H5Ovisit}, and \Code{H5Oget_info_by_name}. To compile this application
|
||||
For example, an application \TText{application.c} only calls \TText{H5Lvisit},
|
||||
\TText{H5Ovisit}, and \TText{H5Oget_info_by_name}. To compile this application
|
||||
with 1.10 APIs in 1.12 with the function specific mappings, then not only must
|
||||
\Code{H5Lvisit_vers}, \Code{H5Ovisit_vers}, and \Code{H5Oget_info_by_name_vers}
|
||||
\TText{H5Lvisit_vers}, \TText{H5Ovisit_vers}, and \TText{H5Oget_info_by_name_vers}
|
||||
be specified on the command line, but the mapped structures and every
|
||||
function that uses the mapped structures must be included, as well.
|
||||
The full compile line is shown below:
|
||||
@@ -303,26 +303,26 @@
|
||||
\subsubsection fun-options-112 Function Mapping Options in Releases 1.12.x
|
||||
<table>
|
||||
<tr>
|
||||
<th style="text-align: left;">Macro <br/> (\Code{H5xxx})</th>
|
||||
<th style="text-align: left;">Macro <br/> (\TText{H5xxx})</th>
|
||||
<th>Default function used if no macro specified
|
||||
<ul><li>Function/struct mapping:\Code{H5xxx_vers=N}</li></ul>
|
||||
<ul><li>Function/struct mapping:\TText{H5xxx_vers=N}</li></ul>
|
||||
</th>
|
||||
<th>Function used if specifying 1.10
|
||||
<ul><li>Function/struct mapping: \Code{H5xxx_vers=1}</li></ul>
|
||||
<ul><li>Function/struct mapping: \TText{H5xxx_vers=1}</li></ul>
|
||||
</th>
|
||||
</tr>
|
||||
<tr>
|
||||
<td>H5Lget_info()</td>
|
||||
<td>H5Lget_info2()
|
||||
<ul>
|
||||
<li>Function mapping:\Code{H5Lget_info_vers=2}</li>
|
||||
<li>Struct mapping:\Code{H5L_info_t_vers=2}</li>
|
||||
<li>Function mapping:\TText{H5Lget_info_vers=2}</li>
|
||||
<li>Struct mapping:\TText{H5L_info_t_vers=2}</li>
|
||||
</ul>
|
||||
</td>
|
||||
<td>H5Lget_info1()
|
||||
<ul>
|
||||
<li>Function mapping \Code{H5Lget_info_vers=1}</li>
|
||||
<li>Struct mapping: \Code{H5L_info_t_vers=1}</li>
|
||||
<li>Function mapping \TText{H5Lget_info_vers=1}</li>
|
||||
<li>Struct mapping: \TText{H5L_info_t_vers=1}</li>
|
||||
</ul>
|
||||
</td>
|
||||
</tr>
|
||||
@@ -330,14 +330,14 @@
|
||||
<td>H5Lget_info_by_idx()</td>
|
||||
<td>H5Lget_info_by_idx2()
|
||||
<ul>
|
||||
<li>Function mapping: \Code{H5Lget_info_by_idx_vers=2}</li>
|
||||
<li>Struct mapping: \Code{H5L_info_t_vers=2}</li>
|
||||
<li>Function mapping: \TText{H5Lget_info_by_idx_vers=2}</li>
|
||||
<li>Struct mapping: \TText{H5L_info_t_vers=2}</li>
|
||||
</ul>
|
||||
</td>
|
||||
<td>H5Lget_info_by_idx1()
|
||||
<ul>
|
||||
<li>Function mapping: \Code{H5Lget_info_by_idx_vers=1}</li>
|
||||
<li>Struct mapping: \Code{H5L_info_t_vers=1}</li>
|
||||
<li>Function mapping: \TText{H5Lget_info_by_idx_vers=1}</li>
|
||||
<li>Struct mapping: \TText{H5L_info_t_vers=1}</li>
|
||||
</ul>
|
||||
</td>
|
||||
</tr>
|
||||
@@ -345,14 +345,14 @@
|
||||
<td>H5Literate()</td>
|
||||
<td>H5Literate2()
|
||||
<ul>
|
||||
<li>Function mapping: \Code{H5Literate_vers=2}</li>
|
||||
<li>Struct mapping: \Code{H5L_iterate_t_vers=2}</li>
|
||||
<li>Function mapping: \TText{H5Literate_vers=2}</li>
|
||||
<li>Struct mapping: \TText{H5L_iterate_t_vers=2}</li>
|
||||
</ul>
|
||||
</td>
|
||||
<td>H5Literate1()
|
||||
<ul>
|
||||
<li>Function mapping: \Code{H5Literate_vers=1}</li>
|
||||
<li>Struct mapping: \Code{H5L_iterate_t_vers=1}</li>
|
||||
<li>Function mapping: \TText{H5Literate_vers=1}</li>
|
||||
<li>Struct mapping: \TText{H5L_iterate_t_vers=1}</li>
|
||||
</ul>
|
||||
</td>
|
||||
</tr>
|
||||
@@ -360,14 +360,14 @@
|
||||
<td>H5Literate_by_name()</td>
|
||||
<td>H5Literate_by_name2()
|
||||
<ul>
|
||||
<li>Function mapping: \Code{H5Literate_by_name_vers=2}</li>
|
||||
<li>Struct mapping: \Code{H5L_iterate_t_vers=2}</li>
|
||||
<li>Function mapping: \TText{H5Literate_by_name_vers=2}</li>
|
||||
<li>Struct mapping: \TText{H5L_iterate_t_vers=2}</li>
|
||||
</ul>
|
||||
</td>
|
||||
<td>H5Literate_by_name1()
|
||||
<ul>
|
||||
<li>Function mapping: \Code{H5Literate_by_name_vers=1}</li>
|
||||
<li>Struct mapping: \Code{H5L_iterate_t_vers=1}</li>
|
||||
<li>Function mapping: \TText{H5Literate_by_name_vers=1}</li>
|
||||
<li>Struct mapping: \TText{H5L_iterate_t_vers=1}</li>
|
||||
</ul>
|
||||
</td>
|
||||
</tr>
|
||||
@@ -375,14 +375,14 @@
|
||||
<td>H5Lvisit()</td>
|
||||
<td>H5Lvisit2()
|
||||
<ul>
|
||||
<li>Function mapping: \Code{H5Lvisit_vers=2}</li>
|
||||
<li>Struct mapping: \Code{H5L_iterate_t_vers=2}</li>
|
||||
<li>Function mapping: \TText{H5Lvisit_vers=2}</li>
|
||||
<li>Struct mapping: \TText{H5L_iterate_t_vers=2}</li>
|
||||
</ul>
|
||||
</td>
|
||||
<td>H5Lvisit1()
|
||||
<ul>
|
||||
<li>Function mapping: \Code{H5Lvisit_vers=1}</li>
|
||||
<li>Struct mapping: \Code{H5L_iterate_t_vers=1}</li>
|
||||
<li>Function mapping: \TText{H5Lvisit_vers=1}</li>
|
||||
<li>Struct mapping: \TText{H5L_iterate_t_vers=1}</li>
|
||||
</ul>
|
||||
</td>
|
||||
</tr>
|
||||
@@ -390,14 +390,14 @@
|
||||
<td>H5Lvisit_by_name()</td>
|
||||
<td>H5Lvisit_by_name2()
|
||||
<ul>
|
||||
<li>Function mapping: \Code{H5Lvisit_by_name_vers=2}</li>
|
||||
<li>Struct mapping: \Code{H5L_iterate_t_vers=2}</li>
|
||||
<li>Function mapping: \TText{H5Lvisit_by_name_vers=2}</li>
|
||||
<li>Struct mapping: \TText{H5L_iterate_t_vers=2}</li>
|
||||
</ul>
|
||||
</td>
|
||||
<td>H5Lvisit_by_name1()
|
||||
<ul>
|
||||
<li>Function mapping: \Code{H5Lvisit_by_name_vers=1}</li>
|
||||
<li>Struct mapping: \Code{H5L_iterate_t_vers=1}</li>
|
||||
<li>Function mapping: \TText{H5Lvisit_by_name_vers=1}</li>
|
||||
<li>Struct mapping: \TText{H5L_iterate_t_vers=1}</li>
|
||||
</ul>
|
||||
</td>
|
||||
</tr>
|
||||
@@ -405,28 +405,28 @@
|
||||
<td>H5Oget_info()</td>
|
||||
<td>H5Oget_info3()
|
||||
<ul>
|
||||
<li>Function mapping: \Code{H5Oget_info_vers=3}</li>
|
||||
<li>Struct mapping: \Code{H5O_info_t_vers=2}</li>
|
||||
<li>Function mapping: \TText{H5Oget_info_vers=3}</li>
|
||||
<li>Struct mapping: \TText{H5O_info_t_vers=2}</li>
|
||||
</ul>
|
||||
</td>
|
||||
<td>H5Oget_info1()
|
||||
<ul>
|
||||
<li>Function mapping: \Code{H5Oget_info_vers=1}</li>
|
||||
<li>Struct mapping: \Code{H5O_info_t_vers=1}</li>
|
||||
<li>Function mapping: \TText{H5Oget_info_vers=1}</li>
|
||||
<li>Struct mapping: \TText{H5O_info_t_vers=1}</li>
|
||||
</ul>
|
||||
</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td>H5Oget_info_by_idx()</td>
|
||||
<td>H5Oget_info_by_idx3()
|
||||
<ul><li>Function mapping: \Code{H5Oget_info_by_idx_vers=3}</li>
|
||||
<li>Struct mapping: \Code{H5O_info_t_vers=2}</li>
|
||||
<ul><li>Function mapping: \TText{H5Oget_info_by_idx_vers=3}</li>
|
||||
<li>Struct mapping: \TText{H5O_info_t_vers=2}</li>
|
||||
</ul>
|
||||
</td>
|
||||
<td>H5Oget_info_by_idx1()
|
||||
<ul>
|
||||
<li>Function mapping: \Code{H5Oget_info_by_idx_vers=1}</li>
|
||||
<li>Struct mapping: \Code{H5O_info_t_vers=1}</li>
|
||||
<li>Function mapping: \TText{H5Oget_info_by_idx_vers=1}</li>
|
||||
<li>Struct mapping: \TText{H5O_info_t_vers=1}</li>
|
||||
</ul>
|
||||
</td>
|
||||
</tr>
|
||||
@@ -434,14 +434,14 @@
|
||||
<td>H5Oget_info_by_name()</td>
|
||||
<td>H5Oget_info_by_name3()
|
||||
<ul>
|
||||
<li>Function mapping: \Code{H5O_get_info_by_name_vers=3}</li>
|
||||
<li>Struct mapping: \Code{H5O_info_t_vers=2}</li>
|
||||
<li>Function mapping: \TText{H5O_get_info_by_name_vers=3}</li>
|
||||
<li>Struct mapping: \TText{H5O_info_t_vers=2}</li>
|
||||
</ul>
|
||||
</td>
|
||||
<td>H5Oget_info_by_name1()
|
||||
<ul>
|
||||
<li>Function mapping: \Code{H5O_get_info_by_name_vers=1}</li>
|
||||
<li>Struct mapping: \Code{H5O_info_t_vers=1}</li>
|
||||
<li>Function mapping: \TText{H5O_get_info_by_name_vers=1}</li>
|
||||
<li>Struct mapping: \TText{H5O_info_t_vers=1}</li>
|
||||
</ul>
|
||||
</td>
|
||||
</tr>
|
||||
@@ -449,13 +449,13 @@
|
||||
<td>H5Ovisit()</td>
|
||||
<td>H5Ovisit3()
|
||||
<ul>
|
||||
<li>Function mapping: \Code{H5Ovisit_vers=3}</li>
|
||||
<li>Struct mapping: \Code{H5O_iterate_t_vers=2}</li>
|
||||
<li>Function mapping: \TText{H5Ovisit_vers=3}</li>
|
||||
<li>Struct mapping: \TText{H5O_iterate_t_vers=2}</li>
|
||||
</ul>
|
||||
</td>
|
||||
<td>H5Ovisit1()
|
||||
<ul><li>Function mapping: \Code{H5Ovisit_vers=1}</li>
|
||||
<li>Struct mapping: \Code{H5O_iterate_t_vers=1}</li>
|
||||
<ul><li>Function mapping: \TText{H5Ovisit_vers=1}</li>
|
||||
<li>Struct mapping: \TText{H5O_iterate_t_vers=1}</li>
|
||||
</ul>
|
||||
</td>
|
||||
</tr>
|
||||
@@ -463,14 +463,14 @@
|
||||
<td>H5Ovisit_by_name()</td>
|
||||
<td>H5Ovisit_by_name3()
|
||||
<ul>
|
||||
<li>Function mapping: \Code{H5Ovisit_by_name_vers=3}</li>
|
||||
<li>Struct mapping: \Code{H5O_iterate_t_vers=2}</li>
|
||||
<li>Function mapping: \TText{H5Ovisit_by_name_vers=3}</li>
|
||||
<li>Struct mapping: \TText{H5O_iterate_t_vers=2}</li>
|
||||
</ul>
|
||||
</td>
|
||||
<td>H5Ovisit_by_name1()
|
||||
<ul>
|
||||
<li>Function mapping: \Code{H5Ovisit_by_name_vers=1}</li>
|
||||
<li>Struct mapping: \Code{H5O_iterate_t_vers=1}</li>
|
||||
<li>Function mapping: \TText{H5Ovisit_by_name_vers=1}</li>
|
||||
<li>Struct mapping: \TText{H5O_iterate_t_vers=1}</li>
|
||||
</ul>
|
||||
</td>
|
||||
</tr>
|
||||
@@ -478,12 +478,12 @@
|
||||
<td>H5Pencode()</td>
|
||||
<td>H5Pencode2()
|
||||
<ul>
|
||||
<li>Function mapping: \Code{H5Pencode_vers=2}</li>
|
||||
<li>Function mapping: \TText{H5Pencode_vers=2}</li>
|
||||
</ul>
|
||||
</td>
|
||||
<td>H5Pencode1()
|
||||
<ul>
|
||||
<li>Function mapping: \Code{H5Pencode_vers=1}</li>
|
||||
<li>Function mapping: \TText{H5Pencode_vers=1}</li>
|
||||
</ul>
|
||||
</td>
|
||||
</tr>
|
||||
@@ -491,12 +491,12 @@
|
||||
<td>H5Sencode()</td>
|
||||
<td>H5Sencode2()
|
||||
<ul>
|
||||
<li>Function mapping: \Code{H5Sencode_vers=2}</li>
|
||||
<li>Function mapping: \TText{H5Sencode_vers=2}</li>
|
||||
</ul>
|
||||
</td>
|
||||
<td>H5Sencode1()
|
||||
<ul>
|
||||
<li>Function mapping: \Code{H5Sencode_vers=1}</li>
|
||||
<li>Function mapping: \TText{H5Sencode_vers=1}</li>
|
||||
</ul>
|
||||
</td>
|
||||
</tr>
|
||||
@@ -508,84 +508,84 @@
|
||||
<th>Macro</th>
|
||||
<th>Default function used <br/> <sub>(if no macro specified)</sub></th>
|
||||
<th>Introduced in</th>
|
||||
<th>\Code{h5cc} version flag and value</th>
|
||||
<th>\TText{h5cc} version flag and value</th>
|
||||
<th>Mapped to function or struct</th>
|
||||
</tr>
|
||||
<tr>
|
||||
<td rowspan="2">H5Rdereference()</td>
|
||||
<td rowspan="2">H5Rdereference2()</td>
|
||||
<td rowspan="2">HDF5-1.10.0</td>
|
||||
<td>\Code{-DH5Rdereference_vers=1}</td>
|
||||
<td>\TText{-DH5Rdereference_vers=1}</td>
|
||||
<td>H5Rdereference1()</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td>\Code{-DH5Rdereference_vers=2}</td>
|
||||
<td>\TText{-DH5Rdereference_vers=2}</td>
|
||||
<td>H5Rdereference2()</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td rowspan="2">H5Fget_info()</td>
|
||||
<td rowspan="2">H5Fget_info2()</td>
|
||||
<td rowspan="2">HDF5-1.10.0</td>
|
||||
<td>\Code{-DH5Fget_info_vers=1}</td>
|
||||
<td>\TText{-DH5Fget_info_vers=1}</td>
|
||||
<td>H5Fget_info1() with struct \ref H5F_info1_t</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td>\Code{-DH5Fget_info_vers=2}</td>
|
||||
<td>\TText{-DH5Fget_info_vers=2}</td>
|
||||
<td>H5Fget_info2() with struct \ref H5F_info2_t</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td rowspan="2">H5Oget_info()</td>
|
||||
<td rowspan="2">H5Oget_info1()</td>
|
||||
<td rowspan="2">HDF5-1.10.3</td>
|
||||
<td>\Code{-DH5Oget_info_vers=1}</td>
|
||||
<td>\TText{-DH5Oget_info_vers=1}</td>
|
||||
<td>H5Oget_info1()</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td>\Code{-DH5Oget_info_vers=2}</td>
|
||||
<td>\TText{-DH5Oget_info_vers=2}</td>
|
||||
<td>H5Oget_info2()</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td rowspan="2">H5Oget_info_by_idx()</td>
|
||||
<td rowspan="2">H5Oget_info_by_idx1()</td>
|
||||
<td rowspan="2">HDF5-1.10.3</td>
|
||||
<td>\Code{-DH5Oget_info_by_idx_vers=1}</td>
|
||||
<td>\TText{-DH5Oget_info_by_idx_vers=1}</td>
|
||||
<td>H5Oget_info_by_idx1()</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td>\Code{-DH5Oget_info_by_idx_vers=2}</td>
|
||||
<td>\TText{-DH5Oget_info_by_idx_vers=2}</td>
|
||||
<td>H5Oget_info_by_idx2()</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td rowspan="2">H5Oget_info_by_name()</td>
|
||||
<td rowspan="2">H5Oget_info_by_name1()</td>
|
||||
<td rowspan="2">HDF5-1.10.3</td>
|
||||
<td>\Code{-DH5Oget_info_by_name_vers=1}</td>
|
||||
<td>\TText{-DH5Oget_info_by_name_vers=1}</td>
|
||||
<td>H5Oget_info_by_name1()</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td>\Code{-DH5Oget_info_by_name_vers=2}</td>
|
||||
<td>\TText{-DH5Oget_info_by_name_vers=2}</td>
|
||||
<td>H5Oget_info_by_name2()</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td rowspan="2">H5Ovisit()</td>
|
||||
<td rowspan="2">H5Ovisit1()</td>
|
||||
<td rowspan="2">HDF5-1.10.3</td>
|
||||
<td>\Code{-DH5Ovisit_vers=1}</td>
|
||||
<td>\TText{-DH5Ovisit_vers=1}</td>
|
||||
<td>H5Ovisit1()</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td>\Code{-DH5Ovisit_vers=2}</td>
|
||||
<td>\TText{-DH5Ovisit_vers=2}</td>
|
||||
<td>H5Ovisit2()</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td rowspan="2">H5Ovisit_by_name()</td>
|
||||
<td rowspan="2">H5Ovisit_by_name1()</td>
|
||||
<td rowspan="2">HDF5-1.10.3</td>
|
||||
<td>\Code{-DH5Ovisit_by_name_vers=1}</td>
|
||||
<td>\TText{-DH5Ovisit_by_name_vers=1}</td>
|
||||
<td>H5Ovisit_by_name1()</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td>\Code{-DH5Ovisit_by_name_vers=2}</td>
|
||||
<td>\TText{-DH5Ovisit_by_name_vers=2}</td>
|
||||
<td>H5Ovisit_by_name2()</td>
|
||||
</tr>
|
||||
</table>
|
||||
@@ -606,208 +606,208 @@
|
||||
</tr>
|
||||
<tr>
|
||||
<td rowspan="2">H5Acreate()</td>
|
||||
<td>\Code{DH5Acreate_vers=1}</td>
|
||||
<td>\TText{DH5Acreate_vers=1}</td>
|
||||
<td>H5Acreate1()</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td>\Code{DH5Acreate_vers=2}</td>
|
||||
<td>\TText{DH5Acreate_vers=2}</td>
|
||||
<td>H5Acreate2()</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td rowspan="2">H5Aiterate()</td>
|
||||
<td>\Code{DH5Aiterate_vers=1}</td>
|
||||
<td>\TText{DH5Aiterate_vers=1}</td>
|
||||
<td>H5Aiterate1() <br/> with struct \ref H5A_operator1_t</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td>\Code{DH5Aiterate_vers=2}</td>
|
||||
<td>\TText{DH5Aiterate_vers=2}</td>
|
||||
<td>H5Aiterate2() <br/> with struct \ref H5A_operator2_t</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td rowspan="2">H5Dcreate()</td>
|
||||
<td>\Code{DH5Dcreate_vers=1}</td>
|
||||
<td>\TText{DH5Dcreate_vers=1}</td>
|
||||
<td>H5Dcreate1()</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td>\Code{DH5Dcreate_vers=2}</td>
|
||||
<td>\TText{DH5Dcreate_vers=2}</td>
|
||||
<td>H5Dcreate2()</td>
|
||||
</tr>
|
||||
<tr><td rowspan="2">H5Dopen()</td>
|
||||
<td>\Code{DH5Dopen_vers=1}</td>
|
||||
<td>\TText{DH5Dopen_vers=1}</td>
|
||||
<td>H5Dopen1()</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td>\Code{DH5Dopen_vers=2}</td>
|
||||
<td>\TText{DH5Dopen_vers=2}</td>
|
||||
<td>H5Dopen2()</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td rowspan="2">H5Eclear()</td>
|
||||
<td>\Code{DH5Eclear_vers=1}</td>
|
||||
<td>\TText{DH5Eclear_vers=1}</td>
|
||||
<td>H5Eclear1()</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td>\Code{DH5Eclear_vers=2}</td>
|
||||
<td>\TText{DH5Eclear_vers=2}</td>
|
||||
<td>H5Eclear2()</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td rowspan="2">H5Eprint()</td>
|
||||
<td>\Code{DH5Eprint_vers=1}</td>
|
||||
<td>\TText{DH5Eprint_vers=1}</td>
|
||||
<td>H5Eprint1()</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td>\Code{DH5Eprint_vers=2}</td>
|
||||
<td>\TText{DH5Eprint_vers=2}</td>
|
||||
<td>H5Eprint2()</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td rowspan="2">H5Epush()</td>
|
||||
<td>\Code{DH5Epush_vers=1}</td>
|
||||
<td>\TText{DH5Epush_vers=1}</td>
|
||||
<td>H5Epush1()</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td>\Code{DH5Epush_vers=2}</td>
|
||||
<td>\TText{DH5Epush_vers=2}</td>
|
||||
<td>H5Epush2()</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td rowspan="2">H5Eset_auto()</td>
|
||||
<td>\Code{DH5Eset_auto_vers=1}</td>
|
||||
<td>\TText{DH5Eset_auto_vers=1}</td>
|
||||
<td>H5Eset_auto1()</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td>\Code{DH5Eset_auto_vers=2}</td>
|
||||
<td>\TText{DH5Eset_auto_vers=2}</td>
|
||||
<td>H5Eset_auto2()</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td rowspan="2">H5Eget_auto()</td>
|
||||
<td>\Code{DH5Eget_auto_vers=1}</td>
|
||||
<td>\TText{DH5Eget_auto_vers=1}</td>
|
||||
<td>H5Eget_auto1()</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td>\Code{DH5Eget_auto_vers=2}</td>
|
||||
<td>\TText{DH5Eget_auto_vers=2}</td>
|
||||
<td>H5Eget_auto2()</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td rowspan="2">\ref H5E_auto_t <br/> struct for H5Eset_auto() <br/> and H5Eget_auto()</td>
|
||||
<td>\Code{DH5E_auto_t_vers=1}</td>
|
||||
<td>\TText{DH5E_auto_t_vers=1}</td>
|
||||
<td>\ref H5E_auto1_t</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td>\Code{DH5E_auto_t_vers=2}</td>
|
||||
<td>\TText{DH5E_auto_t_vers=2}</td>
|
||||
<td>\ref H5E_auto2_t</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td rowspan="2">H5Ewalk()</td>
|
||||
<td>\Code{DH5Ewalk_vers=1}</td>
|
||||
<td>\TText{DH5Ewalk_vers=1}</td>
|
||||
<td>H5Ewalk1() <br/> with callback \ref H5E_walk1_t <br/> and struct \ref H5E_error1_t</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td>\Code{DH5Ewalk_vers=2}</td>
|
||||
<td>\TText{DH5Ewalk_vers=2}</td>
|
||||
<td>H5Ewalk2() <br/> with callback \ref H5E_walk2_t <br/> and struct \ref H5E_error2_t</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td rowspan="2">H5Gcreate()</td>
|
||||
<td>\Code{DH5Gcreate_vers=1}</td>
|
||||
<td>\TText{DH5Gcreate_vers=1}</td>
|
||||
<td>H5Gcreate1()</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td>\Code{DH5Gcreate_vers=2}</td>
|
||||
<td>\TText{DH5Gcreate_vers=2}</td>
|
||||
<td>H5Gcreate2()</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td rowspan="2">H5Gopen()</td>
|
||||
<td>\Code{DH5Gopen_vers=1}</td>
|
||||
<td>\TText{DH5Gopen_vers=1}</td>
|
||||
<td>H5Gopen1()</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td>\Code{DH5Gopen_vers=2}</td>
|
||||
<td>\TText{DH5Gopen_vers=2}</td>
|
||||
<td>H5Gopen2()</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td rowspan="2">H5Pget_filter()</td>
|
||||
<td>\Code{DH5Pget_filter_vers=1}</td>
|
||||
<td>\TText{DH5Pget_filter_vers=1}</td>
|
||||
<td>H5Pget_filter1()</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td>\Code{DH5Pget_filter_vers=2}</td>
|
||||
<td>\TText{DH5Pget_filter_vers=2}</td>
|
||||
<td>H5Pget_filter2()</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td rowspan="2">H5Pget_filter_by_id()</td>
|
||||
<td>\Code{DH5Pget_filter_by_id_vers=1}</td>
|
||||
<td>\TText{DH5Pget_filter_by_id_vers=1}</td>
|
||||
<td>H5Pget_filter_by_id1()</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td>\Code{DH5Pget_filter_by_id_vers=2}</td>
|
||||
<td>\TText{DH5Pget_filter_by_id_vers=2}</td>
|
||||
<td>H5Pget_filter_by_id2()</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td rowspan="2">H5Pinsert()</td>
|
||||
<td>\Code{DH5Pinsert_vers=1}</td>
|
||||
<td>\TText{DH5Pinsert_vers=1}</td>
|
||||
<td>H5Pinsert1()</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td>\Code{DH5Pinsert_vers=2}</td>
|
||||
<td>\TText{DH5Pinsert_vers=2}</td>
|
||||
<td>H5Pinsert2()</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td rowspan="2">H5Pregister()</td>
|
||||
<td>\Code{DH5Pregister_vers=1}</td>
|
||||
<td>\TText{DH5Pregister_vers=1}</td>
|
||||
<td>H5Pregister1()</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td>\Code{DH5Pregister_vers=2}</td>
|
||||
<td>\TText{DH5Pregister_vers=2}</td>
|
||||
<td>H5Pregister2()</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td rowspan="2">H5Rget_obj_type()</td>
|
||||
<td>\Code{DH5Rget_obj_typevers=1}</td>
|
||||
<td>\TText{DH5Rget_obj_typevers=1}</td>
|
||||
<td>H5Rget_obj_type1()</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td>\Code{DH5Rget_obj_type_vers=2}</td>
|
||||
<td>\TText{DH5Rget_obj_type_vers=2}</td>
|
||||
<td>H5Rget_obj_type2()</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td rowspan="2">H5Tarray_create()</td>
|
||||
<td>\Code{DH5Tarray_create_vers=1}</td>
|
||||
<td>\TText{DH5Tarray_create_vers=1}</td>
|
||||
<td>H5Tarray_create1()</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td>\Code{DH5Tarray_create_vers=2}</td>
|
||||
<td>\TText{DH5Tarray_create_vers=2}</td>
|
||||
<td>H5Tarray_create2()</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td rowspan="2">H5Tcommit()</td>
|
||||
<td>\Code{DH5Tcommit_vers=1}</td>
|
||||
<td>\TText{DH5Tcommit_vers=1}</td>
|
||||
<td>H5Tcommit1()</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td>\Code{DH5Tcommit_vers=2}</td>
|
||||
<td>\TText{DH5Tcommit_vers=2}</td>
|
||||
<td>H5Tcommit2()</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td rowspan="2">H5Tget_array_dims()</td>
|
||||
<td>\Code{DH5Tget_array_dims_vers=1}</td>
|
||||
<td>\TText{DH5Tget_array_dims_vers=1}</td>
|
||||
<td>H5Tget_array_dims1()</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td>\Code{DH5Tget_array_dims_vers=2}</td>
|
||||
<td>\TText{DH5Tget_array_dims_vers=2}</td>
|
||||
<td>H5Tget_array_dims2()</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td rowspan="2">H5Topen()</td>
|
||||
<td>\Code{DH5Topen_vers=1}</td>
|
||||
<td>\TText{DH5Topen_vers=1}</td>
|
||||
<td>H5Topen1()</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td>\Code{DH5Topen_vers=2}</td>
|
||||
<td>\TText{DH5Topen_vers=2}</td>
|
||||
<td>H5Topen2()</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td rowspan="2">\ref H5Z_class_t struct for H5Zregister()</td>
|
||||
<td>\Code{DH5Z_class_t_vers=1}</td>
|
||||
<td>\TText{DH5Z_class_t_vers=1}</td>
|
||||
<td>\ref H5Z_class1_t</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td>\Code{DH5Z_class_t_vers=2}</td>
|
||||
<td>\TText{DH5Z_class_t_vers=2}</td>
|
||||
<td>\ref H5Z_class2_t</td>
|
||||
</tr>
|
||||
</table>
|
||||
@@ -819,8 +819,8 @@
|
||||
h5cc ... -DH5Rdereference_vers=1 -DH5Fget_info_vers=2 ...
|
||||
\endcode
|
||||
As a result of the function and struct mappings in this compile example, all
|
||||
occurrences of the macro \Code{H5Rdereference} will be mapped to \Code{H5Rdereference1}
|
||||
and all occurrences of the macro \Code{H5Fget_info} will be mapped to \Code{H5Fget_info2}
|
||||
occurrences of the macro \TText{H5Rdereference} will be mapped to \TText{H5Rdereference1}
|
||||
and all occurrences of the macro \TText{H5Fget_info} will be mapped to \TText{H5Fget_info2}
|
||||
for the application being built.
|
||||
|
||||
The function and struct mappings can be used to guarantee that a given API compatibility
|
||||
@@ -832,17 +832,17 @@
|
||||
As noted earlier, the function mappings can only reference versioned functions that are
|
||||
included in the HDF5 library, as determined by the configure flag used to build the
|
||||
library. For example, if the HDF5 library being linked with the application was built
|
||||
with the \Code{--disable-deprecated-symbols} option, version 1 of the underlying functions
|
||||
would not be available, and the example above that defined \Code{H5Rdereference_vers=1}
|
||||
with the \TText{--disable-deprecated-symbols} option, version 1 of the underlying functions
|
||||
would not be available, and the example above that defined \TText{H5Rdereference_vers=1}
|
||||
would not be supported.
|
||||
|
||||
The function mappings do not negate any available functions. If \Code{H5Rdereference1}
|
||||
The function mappings do not negate any available functions. If \TText{H5Rdereference1}
|
||||
is available in the installed version of the HDF5 library, and the application was not
|
||||
compiled with the \Code{-DH5_NO_DEPRECATED_SYMBOLS} flag, the function \Code{H5Rdereference1}
|
||||
compiled with the \TText{-DH5_NO_DEPRECATED_SYMBOLS} flag, the function \TText{H5Rdereference1}
|
||||
will remain available to the application through its versioned name. Similarly,
|
||||
\Code{H5Rdereference2} will remain available to the application as \Code{H5Rdereference2}.
|
||||
The function mapping version flag \Code{H5Rdereference_vers} only controls the mapping of
|
||||
the API compatibility macro \Code{H5Rdereference} to one of the two available functions.
|
||||
\TText{H5Rdereference2} will remain available to the application as \TText{H5Rdereference2}.
|
||||
The function mapping version flag \TText{H5Rdereference_vers} only controls the mapping of
|
||||
the API compatibility macro \TText{H5Rdereference} to one of the two available functions.
|
||||
|
||||
This can be especially useful in any case where the programmer does not have direct control
|
||||
over global macro definitions, such as when writing code meant to be copied to multiple
|
||||
@@ -857,8 +857,8 @@
|
||||
These macros were strictly a forward-looking feature at that time; they were not
|
||||
necessary for compatibility in 1.6.x. These macros were created at that time to
|
||||
enable writing code that could be used with any version of the library after 1.6.8
|
||||
and any library compilation options except \Code{H5_NO_DEPRECATED_SYMBOLS}, by always
|
||||
using the '1' version of versioned functions and types. For example, \Code{H5Dopen1}
|
||||
and any library compilation options except \TText{H5_NO_DEPRECATED_SYMBOLS}, by always
|
||||
using the '1' version of versioned functions and types. For example, \TText{H5Dopen1}
|
||||
will always be interpreted in exactly the same manner by any version of the library
|
||||
since 1.6.8.
|
||||
|
||||
@@ -867,23 +867,23 @@
|
||||
of an existing application to a new HDF5 release. An incremental migration plan is
|
||||
outlined here:
|
||||
<ol>
|
||||
<li>Build the HDF5 library without specifying any library mapping \Code{configure}
|
||||
<li>Build the HDF5 library without specifying any library mapping \TText{configure}
|
||||
flag. In this default mode, the 1.6.x, 1.8.x, and 1.10.x versions of the
|
||||
underlying functions are available, and the API compatibility macros will
|
||||
be mapped to the current HDF5 versioned functions.</li>
|
||||
<li>Compile the application with the \Code{-DH5_USE_NN_API} application mapping
|
||||
<li>Compile the application with the \TText{-DH5_USE_NN_API} application mapping
|
||||
option if it was written for use with an earlier HDF5 library. Because the
|
||||
application mapping overrides the library mapping, the macros will all be
|
||||
mapped to the earlier versions of the functions.</li>
|
||||
<li>Remap one API compatibility macro at a time (or sets of macros), to use the
|
||||
current HDF5 versions. At each stage, use the function mappings to map the macros
|
||||
being worked on to the current versions. For example, use the
|
||||
\Code{-DH5Rdereference_vers=2} version flag setting to remap the \Code{H5Rdereference}
|
||||
macro to \Code{H5Rdereference2}, the 1.10.x version.
|
||||
\TText{-DH5Rdereference_vers=2} version flag setting to remap the \TText{H5Rdereference}
|
||||
macro to \TText{H5Rdereference2}, the 1.10.x version.
|
||||
|
||||
During this step, the application code will need to be modified to change the calling
|
||||
parameters used with the API compatibility macros to match the number and type
|
||||
of the 1.10.x versioned functions. The macro name, for example \Code{H5Rdereference},
|
||||
of the 1.10.x versioned functions. The macro name, for example \TText{H5Rdereference},
|
||||
should continue to be used in the code, to allow for possible re-mappings to later
|
||||
versioned functions in a future release.</li>
|
||||
<li>After all macros have been migrated to the latest versioned functions in step 3,
|
||||
@@ -891,8 +891,8 @@
|
||||
uses the library mappings set in step 1, and maps API compatibility macros to the
|
||||
latest versions.</li>
|
||||
<li>Finally, compile the application with the application mapping
|
||||
\Code{-DH5_NO_DEPRECATED_SYMBOLS}, and address any failures to complete
|
||||
\TText{-DH5_NO_DEPRECATED_SYMBOLS}, and address any failures to complete
|
||||
the application migration process.</li>
|
||||
</ol>
|
||||
|
||||
*/
|
||||
*/
|
||||
|
||||
@@ -20,7 +20,7 @@ free space tracking information via H5Pset_file_space_strategy().
|
||||
Free space tracking is supported only in HDF5 versions 1.10.x and higher.
|
||||
This has implications for the accessibility of your HDF5 files and
|
||||
should be considered carefully. If compatibility with previous versions of
|
||||
HDF5 must be maintained, space reclamation via \Code{h5repack} might be an option.\n
|
||||
HDF5 must be maintained, space reclamation via \TText{h5repack} might be an option.\n
|
||||
The file space strategy #H5F_FSPACE_STRATEGY_FSM_AGGR is not the only option
|
||||
that supports free-space tracking. #H5F_FSPACE_STRATEGY_PAGE is another option,
|
||||
which adds paged allocation and is used most effectively with page buffering.\n
|
||||
@@ -37,7 +37,7 @@ See \ref CB_MaintainCompat for HDF5 compatibility implications.
|
||||
\subsection CB_RemoveUnusedSpace Removing Unused Space from HDF5 Files
|
||||
|
||||
\par Problem
|
||||
Based on estimates or \Code{h5stat} output you know that a large portion
|
||||
Based on estimates or \TText{h5stat} output you know that a large portion
|
||||
of an HDF5 file consists of free or unaccounted space, and you would like
|
||||
to remove it.
|
||||
|
||||
@@ -58,7 +58,7 @@ The user block begins at offset 0 and must be at least 512 bytes and a power
|
||||
of 2. The HDF5 library ignores any content between the beginning of the
|
||||
file and the end of the user block.\n
|
||||
You can add or strip a user block to/from an existing HDF5 file with the
|
||||
\Code{h5jam}/\Code{h5unjam} tool, respectively.
|
||||
\TText{h5jam}/\TText{h5unjam} tool, respectively.
|
||||
\warning
|
||||
If you try to embed content into the user block for use by other applications,
|
||||
pay close attention to how they handle space beyond the last used byte in the
|
||||
@@ -68,4 +68,4 @@ try to truncate the rest of the file and destroy the HDF5 portion of the file.
|
||||
\par See Also
|
||||
References to related recipes
|
||||
|
||||
*/
|
||||
*/
|
||||
|
||||
@@ -41,8 +41,8 @@ the <a href="https://www.oreilly.com/library/view/97-things-every/9780596809515/
|
||||
* \return Returns what you always wanted
|
||||
\endverbatim
|
||||
- Clearly indicate the parameter direction as \c in, \c out, or
|
||||
\Code{in,out}
|
||||
- Make reference to other parameters using \Code{\\p}
|
||||
\TText{in,out}
|
||||
- Make reference to other parameters using \TText{\\p}
|
||||
4. Preconditions
|
||||
- A set of preconditions that must be met.
|
||||
\verbatim
|
||||
|
||||
+1
-1
@@ -1842,7 +1842,7 @@ H5_DLL hid_t H5Dopen1(hid_t loc_id, const char *name);
|
||||
* used if the dataset dimension sizes are to be reduced.
|
||||
*
|
||||
* \version 1.8.0 Function deprecated in this release. Parameter size
|
||||
* syntax changed to \Code{const hsize_t size[]} in this release.
|
||||
* syntax changed to \TText{const hsize_t size[]} in this release.
|
||||
* \since 1.0.0
|
||||
*
|
||||
*/
|
||||
|
||||
+1
-1
@@ -533,7 +533,7 @@
|
||||
* do not clear the error stack. Otherwise, any function which does
|
||||
* not have an underscore immediately after the package name will
|
||||
* clear the error stack. For instance, H5Fopen() clears the error
|
||||
* stack while \Code{H5F_open} does not.
|
||||
* stack while \TText{H5F_open} does not.
|
||||
*
|
||||
* \internal An error stack has a fixed maximum size. If this size is exceeded
|
||||
* then the stack will be truncated and only the inner-most functions
|
||||
|
||||
+32
-32
@@ -95,7 +95,7 @@ H5_DLL hid_t H5FD_log_init(void);
|
||||
* table. Multiple flags can be set through the use of a logical \c OR
|
||||
* contained in parentheses. For example, logging read and write
|
||||
* locations would be specified as
|
||||
* \Code{(H5FD_LOG_LOC_READ|H5FD_LOG_LOC_WRITE)}.
|
||||
* \TText{(H5FD_LOG_LOC_READ|H5FD_LOG_LOC_WRITE)}.
|
||||
*
|
||||
* <table>
|
||||
* <caption>Table1: Logging Flags</caption>
|
||||
@@ -115,7 +115,7 @@ H5_DLL hid_t H5FD_log_init(void);
|
||||
* </td>
|
||||
* <td>
|
||||
* Track all I/O locations and lengths. The logical equivalent of the following:
|
||||
* \Code{(#H5FD_LOG_LOC_READ | #H5FD_LOG_LOC_WRITE | #H5FD_LOG_LOC_SEEK)}
|
||||
* \TText{(#H5FD_LOG_LOC_READ | #H5FD_LOG_LOC_WRITE | #H5FD_LOG_LOC_SEEK)}
|
||||
* </td>
|
||||
* </tr>
|
||||
* <tr>
|
||||
@@ -134,7 +134,7 @@ H5_DLL hid_t H5FD_log_init(void);
|
||||
* <td>
|
||||
* Track the number of times each byte is read and written. The logical
|
||||
* equivalent of the following:
|
||||
* \Code{(#H5FD_LOG_FILE_READ | #H5FD_LOG_FILE_WRITE)}
|
||||
* \TText{(#H5FD_LOG_FILE_READ | #H5FD_LOG_FILE_WRITE)}
|
||||
* </td>
|
||||
* </tr>
|
||||
* <tr>
|
||||
@@ -163,7 +163,7 @@ H5_DLL hid_t H5FD_log_init(void);
|
||||
* <td>
|
||||
* Track the total number of all types of I/O operations. The logical equivalent
|
||||
* of the following:
|
||||
* \Code{(#H5FD_LOG_NUM_READ | #H5FD_LOG_NUM_WRITE | #H5FD_LOG_NUM_SEEK | #H5FD_LOG_NUM_TRUNCATE)}
|
||||
* \TText{(#H5FD_LOG_NUM_READ | #H5FD_LOG_NUM_WRITE | #H5FD_LOG_NUM_SEEK | #H5FD_LOG_NUM_TRUNCATE)}
|
||||
* </td>
|
||||
* </tr>
|
||||
* <tr>
|
||||
@@ -186,7 +186,7 @@ H5_DLL hid_t H5FD_log_init(void);
|
||||
* <td>
|
||||
* Track the time spent in each of the above operations. The logical equivalent
|
||||
* of the following:
|
||||
* \Code{(#H5FD_LOG_TIME_OPEN | #H5FD_LOG_TIME_STAT | #H5FD_LOG_TIME_READ | #H5FD_LOG_TIME_WRITE |
|
||||
* \TText{(#H5FD_LOG_TIME_OPEN | #H5FD_LOG_TIME_STAT | #H5FD_LOG_TIME_READ | #H5FD_LOG_TIME_WRITE |
|
||||
* #H5FD_LOG_TIME_SEEK | #H5FD_LOG_TIME_CLOSE)}
|
||||
* </td>
|
||||
* </tr>
|
||||
@@ -204,7 +204,7 @@ H5_DLL hid_t H5FD_log_init(void);
|
||||
* </td>
|
||||
* <td>
|
||||
* Track everything. The logical equivalent of the following:
|
||||
* \Code{(#H5FD_LOG_ALLOC | #H5FD_LOG_TIME_IO | #H5FD_LOG_NUM_IO | #H5FD_LOG_FLAVOR | #H5FD_LOG_FILE_IO |
|
||||
* \TText{(#H5FD_LOG_ALLOC | #H5FD_LOG_TIME_IO | #H5FD_LOG_NUM_IO | #H5FD_LOG_FLAVOR | #H5FD_LOG_FILE_IO |
|
||||
* #H5FD_LOG_LOC_IO)}
|
||||
* </td>
|
||||
* </tr>
|
||||
@@ -234,19 +234,19 @@ H5_DLL hid_t H5FD_log_init(void);
|
||||
* <td>#H5FD_LOG_LOC_READ</td>
|
||||
* <td>Read</td>
|
||||
* <td>
|
||||
* \Code{%10a-%10a (%10Zu bytes) (%s) Read}\n\n
|
||||
* \TText{%10a-%10a (%10Zu bytes) (%s) Read}\n\n
|
||||
* Start position\n
|
||||
* End position\n
|
||||
* Number of bytes\n
|
||||
* Flavor of read\n\n
|
||||
* Adds \Code{(\%f s)} and seek time if #H5FD_LOG_TIME_SEEK is also set.
|
||||
* Adds \TText{(\%f s)} and seek time if #H5FD_LOG_TIME_SEEK is also set.
|
||||
* </td>
|
||||
* </tr>
|
||||
* <tr>
|
||||
* <td>#H5FD_LOG_LOC_READ</td>
|
||||
* <td>Read Error</td>
|
||||
* <td>
|
||||
* \Code{Error! Reading: %10a-%10a (%10Zu bytes)}\n\n
|
||||
* \TText{Error! Reading: %10a-%10a (%10Zu bytes)}\n\n
|
||||
* Same parameters as non-error entry.
|
||||
* </td>
|
||||
* </tr>
|
||||
@@ -254,19 +254,19 @@ H5_DLL hid_t H5FD_log_init(void);
|
||||
* <td>#H5FD_LOG_LOC_WRITE</td>
|
||||
* <td>Write</td>
|
||||
* <td>
|
||||
* \Code{%10a-%10a (%10Zu bytes) (%s) Written}\n\n
|
||||
* \TText{%10a-%10a (%10Zu bytes) (%s) Written}\n\n
|
||||
* Start position\n
|
||||
* End position\n
|
||||
* Number of bytes\n
|
||||
* Flavor of write\n\n
|
||||
* Adds \Code{(\%f s)} and seek time if #H5FD_LOG_TIME_SEEK is also set.
|
||||
* Adds \TText{(\%f s)} and seek time if #H5FD_LOG_TIME_SEEK is also set.
|
||||
* </td>
|
||||
* </tr>
|
||||
* <tr>
|
||||
* <td>#H5FD_LOG_LOC_WRITE</td>
|
||||
* <td>Write Error</td>
|
||||
* <td>
|
||||
* \Code{Error! Writing: %10a-%10a (%10Zu bytes)}\n\n
|
||||
* \TText{Error! Writing: %10a-%10a (%10Zu bytes)}\n\n
|
||||
* Same parameters as non-error entry.
|
||||
* </td>
|
||||
* </tr>
|
||||
@@ -274,10 +274,10 @@ H5_DLL hid_t H5FD_log_init(void);
|
||||
* <td>#H5FD_LOG_LOC_SEEK</td>
|
||||
* <td>Read, Write</td>
|
||||
* <td>
|
||||
* \Code{Seek: From %10a-%10a}\n\n
|
||||
* \TText{Seek: From %10a-%10a}\n\n
|
||||
* Start position\n
|
||||
* End position\n\n
|
||||
* Adds \Code{(\%f s)} and seek time if #H5FD_LOG_TIME_SEEK is also set.
|
||||
* Adds \TText{(\%f s)} and seek time if #H5FD_LOG_TIME_SEEK is also set.
|
||||
* </td>
|
||||
* </tr>
|
||||
* <tr>
|
||||
@@ -287,7 +287,7 @@ H5_DLL hid_t H5FD_log_init(void);
|
||||
* Begins with:\n
|
||||
* Dumping read I/O information\n\n
|
||||
* Then, for each range of identical values, there is this line:\n
|
||||
* \Code{Addr %10-%10 (%10lu bytes) read from %3d times}\n\n
|
||||
* \TText{Addr %10-%10 (%10lu bytes) read from %3d times}\n\n
|
||||
* Start address\n
|
||||
* End address\n
|
||||
* Number of bytes\n
|
||||
@@ -303,7 +303,7 @@ H5_DLL hid_t H5FD_log_init(void);
|
||||
* Begins with:\n
|
||||
* Dumping read I/O information\n\n
|
||||
* Then, for each range of identical values, there is this line:\n
|
||||
* \Code{Addr %10-%10 (%10lu bytes) written to %3d times}\n\n
|
||||
* \TText{Addr %10-%10 (%10lu bytes) written to %3d times}\n\n
|
||||
* Start address\n
|
||||
* End address\n
|
||||
* Number of bytes\n
|
||||
@@ -319,7 +319,7 @@ H5_DLL hid_t H5FD_log_init(void);
|
||||
* Begins with:\n
|
||||
* Dumping I/O flavor information\n\n
|
||||
* Then, for each range of identical values, there is this line:\n
|
||||
* \Code{Addr %10-%10 (%10lu bytes) flavor is %s}\n\n
|
||||
* \TText{Addr %10-%10 (%10lu bytes) flavor is %s}\n\n
|
||||
* Start address\n
|
||||
* End address\n
|
||||
* Number of bytes\n
|
||||
@@ -332,42 +332,42 @@ H5_DLL hid_t H5FD_log_init(void);
|
||||
* <td>#H5FD_LOG_NUM_READ</td>
|
||||
* <td>Close</td>
|
||||
* <td>
|
||||
* Total number of read operations: \Code{%11u}
|
||||
* Total number of read operations: \TText{%11u}
|
||||
* </td>
|
||||
* </tr>
|
||||
* <tr>
|
||||
* <td>#H5FD_LOG_NUM_WRITE</td>
|
||||
* <td>Close</td>
|
||||
* <td>
|
||||
* Total number of write operations: \Code{%11u}
|
||||
* Total number of write operations: \TText{%11u}
|
||||
* </td>
|
||||
* </tr>
|
||||
* <tr>
|
||||
* <td>#H5FD_LOG_NUM_SEEK</td>
|
||||
* <td>Close</td>
|
||||
* <td>
|
||||
* Total number of seek operations: \Code{%11u}
|
||||
* Total number of seek operations: \TText{%11u}
|
||||
* </td>
|
||||
* </tr>
|
||||
* <tr>
|
||||
* <td>#H5FD_LOG_NUM_TRUNCATE</td>
|
||||
* <td>Close</td>
|
||||
* <td>
|
||||
* Total number of truncate operations: \Code{%11u}
|
||||
* Total number of truncate operations: \TText{%11u}
|
||||
* </td>
|
||||
* </tr>
|
||||
* <tr>
|
||||
* <td>#H5FD_LOG_TIME_OPEN</td>
|
||||
* <td>Open</td>
|
||||
* <td>
|
||||
* Open took: \Code{(\%f s)}
|
||||
* Open took: \TText{(\%f s)}
|
||||
* </td>
|
||||
* </tr>
|
||||
* <tr>
|
||||
* <td>#H5FD_LOG_TIME_READ</td>
|
||||
* <td>Close, Read</td>
|
||||
* <td>
|
||||
* Total time in read operations: \Code{\%f s}\n\n
|
||||
* Total time in read operations: \TText{\%f s}\n\n
|
||||
* See also: #H5FD_LOG_LOC_READ
|
||||
* </td>
|
||||
* </tr>
|
||||
@@ -376,7 +376,7 @@ H5_DLL hid_t H5FD_log_init(void);
|
||||
* <td>#H5FD_LOG_TIME_WRITE</td>
|
||||
* <td>Close, Write</td>
|
||||
* <td>
|
||||
* Total time in write operations: \Code{\%f s}\n\n
|
||||
* Total time in write operations: \TText{\%f s}\n\n
|
||||
* See also: #H5FD_LOG_LOC_WRITE
|
||||
* </td>
|
||||
* </tr>
|
||||
@@ -384,7 +384,7 @@ H5_DLL hid_t H5FD_log_init(void);
|
||||
* <td>#H5FD_LOG_TIME_SEEK</td>
|
||||
* <td>Close, Read, Write</td>
|
||||
* <td>
|
||||
* Total time in write operations: \Code{\%f s}\n\n
|
||||
* Total time in write operations: \TText{\%f s}\n\n
|
||||
* See also: #H5FD_LOG_LOC_SEEK or #H5FD_LOG_LOC_WRITE
|
||||
* </td>
|
||||
* </tr>
|
||||
@@ -392,21 +392,21 @@ H5_DLL hid_t H5FD_log_init(void);
|
||||
* <td>#H5FD_LOG_TIME_CLOSE</td>
|
||||
* <td>Close</td>
|
||||
* <td>
|
||||
* Close took: \Code{(\%f s)}
|
||||
* Close took: \TText{(\%f s)}
|
||||
* </td>
|
||||
* </tr>
|
||||
* <tr>
|
||||
* <td>#H5FD_LOG_TIME_STAT</td>
|
||||
* <td>Open</td>
|
||||
* <td>
|
||||
* Stat took: \Code{(\%f s)}
|
||||
* Stat took: \TText{(\%f s)}
|
||||
* </td>
|
||||
* </tr>
|
||||
* <tr>
|
||||
* <td>#H5FD_LOG_ALLOC</td>
|
||||
* <td>Alloc</td>
|
||||
* <td>
|
||||
* \Code{%10-%10 (%10Hu bytes) (\%s) Allocated}\n\n
|
||||
* \TText{%10-%10 (%10Hu bytes) (\%s) Allocated}\n\n
|
||||
* Start of address space\n
|
||||
* End of address space\n
|
||||
* Total size allocation\n
|
||||
@@ -462,14 +462,14 @@ H5_DLL hid_t H5FD_log_init(void);
|
||||
* </tr>
|
||||
* </table>
|
||||
*
|
||||
* \version 1.8.7 The flags parameter has been changed from \Code{unsigned int}
|
||||
* to \Code{unsigned long long}.
|
||||
* \version 1.8.7 The flags parameter has been changed from \TText{unsigned int}
|
||||
* to \TText{unsigned long long}.
|
||||
* The implementation of the #H5FD_LOG_TIME_OPEN, #H5FD_LOG_TIME_READ,
|
||||
* #H5FD_LOG_TIME_WRITE, and #H5FD_LOG_TIME_SEEK flags has been finished.
|
||||
* New flags were added: #H5FD_LOG_NUM_TRUNCATE and #H5FD_LOG_TIME_STAT.
|
||||
* \version 1.6.0 The \c verbosity parameter has been removed.
|
||||
* Two new parameters have been added: \p flags of type \Code{unsigned} and
|
||||
* \p buf_size of type \Code{size_t}.
|
||||
* Two new parameters have been added: \p flags of type \TText{unsigned} and
|
||||
* \p buf_size of type \TText{size_t}.
|
||||
* \since 1.4.0
|
||||
*
|
||||
*/
|
||||
|
||||
+11
-11
@@ -67,7 +67,7 @@ H5_DLL hid_t H5FD_multi_init(void);
|
||||
* usage type that will be associated with a file.
|
||||
*
|
||||
* The array \p memb_name should be a name generator (a
|
||||
* \Code{printf}-style format with a \Code{%s} which will be replaced
|
||||
* \TText{printf}-style format with a \TText{%s} which will be replaced
|
||||
* with the name passed to H5FDopen(), usually from H5Fcreate() or
|
||||
* H5Fopen()).
|
||||
*
|
||||
@@ -99,7 +99,7 @@ H5_DLL hid_t H5FD_multi_init(void);
|
||||
* \p memb_name
|
||||
* </td>
|
||||
* <td>
|
||||
* The default string is \Code{%s-X.h5} where \c X is one of the following letters:
|
||||
* The default string is \TText{%s-X.h5} where \c X is one of the following letters:
|
||||
* - \c s for #H5FD_MEM_SUPER
|
||||
* - \c b for #H5FD_MEM_BTREE
|
||||
* - \c r for #H5FD_MEM_DRAW
|
||||
@@ -115,12 +115,12 @@ H5_DLL hid_t H5FD_multi_init(void);
|
||||
* <td>
|
||||
* The default setting is that the address space is equally divided
|
||||
* among all of the elements:
|
||||
* - #H5FD_MEM_SUPER \Code{-> 0 * (HADDR_MAX/6)}
|
||||
* - #H5FD_MEM_BTREE \Code{-> 1 * (HADDR_MAX/6)}
|
||||
* - #H5FD_MEM_DRAW \Code{-> 2 * (HADDR_MAX/6)}
|
||||
* - #H5FD_MEM_GHEAP \Code{-> 3 * (HADDR_MAX/6)}
|
||||
* - #H5FD_MEM_LHEAP \Code{-> 4 * (HADDR_MAX/6)}
|
||||
* - #H5FD_MEM_OHDR \Code{-> 5 * (HADDR_MAX/6)}
|
||||
* - #H5FD_MEM_SUPER \TText{-> 0 * (HADDR_MAX/6)}
|
||||
* - #H5FD_MEM_BTREE \TText{-> 1 * (HADDR_MAX/6)}
|
||||
* - #H5FD_MEM_DRAW \TText{-> 2 * (HADDR_MAX/6)}
|
||||
* - #H5FD_MEM_GHEAP \TText{-> 3 * (HADDR_MAX/6)}
|
||||
* - #H5FD_MEM_LHEAP \TText{-> 4 * (HADDR_MAX/6)}
|
||||
* - #H5FD_MEM_OHDR \TText{-> 5 * (HADDR_MAX/6)}
|
||||
* </td>
|
||||
* </tr>
|
||||
* </table>
|
||||
@@ -154,7 +154,7 @@ H5_DLL hid_t H5FD_multi_init(void);
|
||||
* memb_name, memb_addr, true);
|
||||
* \endcode
|
||||
*
|
||||
* \version 1.6.3 \p memb_name parameter type changed to \Code{const char* const*}.
|
||||
* \version 1.6.3 \p memb_name parameter type changed to \TText{const char* const*}.
|
||||
* \since 1.4.0
|
||||
*/
|
||||
H5_DLL herr_t H5Pset_fapl_multi(hid_t fapl_id, const H5FD_mem_t *memb_map, const hid_t *memb_fapl,
|
||||
@@ -206,7 +206,7 @@ H5_DLL herr_t H5Pget_fapl_multi(hid_t fapl_id, H5FD_mem_t *memb_map /*out*/, hid
|
||||
* \p meta_ext is the filename extension for the metadata file. The
|
||||
* extension is appended to the name passed to H5FDopen(), usually from
|
||||
* H5Fcreate() or H5Fopen(), to form the name of the metadata file. If
|
||||
* the string \Code{%s} is used in the extension, it works like the
|
||||
* the string \TText{%s} is used in the extension, it works like the
|
||||
* name generator as in H5Pset_fapl_multi().
|
||||
*
|
||||
* \p meta_plist_id is the file access property list identifier for the
|
||||
@@ -215,7 +215,7 @@ H5_DLL herr_t H5Pget_fapl_multi(hid_t fapl_id, H5FD_mem_t *memb_map /*out*/, hid
|
||||
* \p raw_ext is the filename extension for the raw data file. The
|
||||
* extension is appended to the name passed to H5FDopen(), usually from
|
||||
* H5Fcreate() or H5Fopen(), to form the name of the raw data file. If
|
||||
* the string \Code{%s} is used in the extension, it works like the
|
||||
* the string \TText{%s} is used in the extension, it works like the
|
||||
* name generator as in H5Pset_fapl_multi().
|
||||
*
|
||||
* \p raw_plist_id is the file access property list identifier for the
|
||||
|
||||
+14
-14
@@ -1113,7 +1113,7 @@ H5_DLL herr_t H5Fset_mdc_config(hid_t file_id, const H5AC_cache_config_t *config
|
||||
* \return \herr_t
|
||||
*
|
||||
* \details H5Fget_mdc_hit_rate() queries the metadata cache of the target file to obtain its hit rate
|
||||
* \Code{(cache hits / (cache hits + cache misses))} since the last time hit rate statistics
|
||||
* \TText{(cache hits / (cache hits + cache misses))} since the last time hit rate statistics
|
||||
* were reset. If the cache has not been accessed since the last time the hit rate stats were
|
||||
* reset, the hit rate is defined to be 0.0.
|
||||
*
|
||||
@@ -1293,22 +1293,22 @@ H5_DLL herr_t H5Fget_info2(hid_t obj_id, H5F_info2_t *file_info);
|
||||
* library and logarithmic base 10.
|
||||
*
|
||||
* If read retries are incurred for a metadata entry \c i, the library will
|
||||
* allocate memory for \Code{retries[i] (nbins * sizeof(uint32_t)} and store
|
||||
* allocate memory for \TText{retries[i] (nbins * sizeof(uint32_t)} and store
|
||||
* the collection of retries there. If there are no retries for a metadata entry
|
||||
* \c i, \Code{retries[i]} will be NULL. After a call to this routine, users should
|
||||
* free each \Code{retries[i]} that is non-NULL, otherwise resource leak will occur.
|
||||
* \c i, \TText{retries[i]} will be NULL. After a call to this routine, users should
|
||||
* free each \TText{retries[i]} that is non-NULL, otherwise resource leak will occur.
|
||||
*
|
||||
* For the library default read attempts of 100 for SWMR access, nbins will be 2
|
||||
* as depicted below:
|
||||
* \li \Code{retries[i][0]} is the number of 1 to 9 read retries.
|
||||
* \li \Code{retries[i][1]} is the number of 10 to 99 read retries.
|
||||
* \li \TText{retries[i][0]} is the number of 1 to 9 read retries.
|
||||
* \li \TText{retries[i][1]} is the number of 10 to 99 read retries.
|
||||
* For the library default read attempts of 1 for non-SWMR access, \c nbins will
|
||||
* be 0 and each \Code{retries[i]} will be NULL.
|
||||
* be 0 and each \TText{retries[i]} will be NULL.
|
||||
*
|
||||
* The following table lists the 21 metadata entries of \Code{retries[]}:
|
||||
* The following table lists the 21 metadata entries of \TText{retries[]}:
|
||||
* <table>
|
||||
* <tr>
|
||||
* <th>Index for \Code{retries[]}</th>
|
||||
* <th>Index for \TText{retries[]}</th>
|
||||
* <th>Metadata entries<sup>*</sup></th>
|
||||
* </tr>
|
||||
* <tr><td>0</td><td>Object header (version 2)</td></tr>
|
||||
@@ -1784,20 +1784,20 @@ H5_DLL herr_t H5Fset_dset_no_attrs_hint(hid_t file_id, hbool_t minimize);
|
||||
* pass the same values for \p file_id and \p flag.
|
||||
*
|
||||
* This function is available only when the HDF5 library is configured with parallel support
|
||||
* (\Code{--enable-parallel | HDF5_ENABLE_PARALLEL}). It is useful only when used with the #H5FD_MPIO driver
|
||||
* (\TText{--enable-parallel | HDF5_ENABLE_PARALLEL}). It is useful only when used with the #H5FD_MPIO driver
|
||||
* (see H5Pset_fapl_mpio()).
|
||||
* \endparblock
|
||||
*
|
||||
* \attention
|
||||
* \parblock
|
||||
* H5Fset_mpi_atomicity() calls \Code{MPI_File_set_atomicity} underneath and is not supported
|
||||
* if the execution platform does not support \Code{MPI_File_set_atomicity}. When it is
|
||||
* H5Fset_mpi_atomicity() calls \TText{MPI_File_set_atomicity} underneath and is not supported
|
||||
* if the execution platform does not support \TText{MPI_File_set_atomicity}. When it is
|
||||
* supported and used, the performance of data access operations may drop significantly.
|
||||
*
|
||||
* In certain scenarios, even when \Code{MPI_File_set_atomicity} is supported, setting
|
||||
* In certain scenarios, even when \TText{MPI_File_set_atomicity} is supported, setting
|
||||
* atomicity with H5Fset_mpi_atomicity() and \p flag set to 1 does not always yield
|
||||
* strictly atomic updates. For example, some H5Dwrite() calls translate to multiple
|
||||
* \Code{MPI_File_write_at} calls. This happens in all cases where the high-level file
|
||||
* \TText{MPI_File_write_at} calls. This happens in all cases where the high-level file
|
||||
* access routine translates to multiple lower level file access routines.
|
||||
* The following scenarios will raise this issue:
|
||||
* \li Non-contiguous file access using independent I/O
|
||||
|
||||
+9
-9
@@ -692,9 +692,9 @@ H5_DLL hid_t H5Gopen1(hid_t loc_id, const char *name);
|
||||
* If \p link_type is #H5G_LINK_SOFT, then \p cur_name can be anything
|
||||
* and is interpreted at lookup time relative to the group which
|
||||
* contains the final component of \p new_name. For instance, if \p
|
||||
* cur_name is \Code{./foo}, \p new_name is \Code{./x/y/bar}, and a
|
||||
* request is made for \Code{./x/y/bar}, then the actual object looked
|
||||
* up is \Code{./x/y/./foo}.
|
||||
* cur_name is \TText{./foo}, \p new_name is \TText{./x/y/bar}, and a
|
||||
* request is made for \TText{./x/y/bar}, then the actual object looked
|
||||
* up is \TText{./x/y/./foo}.
|
||||
|
||||
* \version 1.8.0 Function deprecated in this release.
|
||||
*
|
||||
@@ -730,9 +730,9 @@ H5_DLL herr_t H5Glink(hid_t cur_loc_id, H5G_link_t type, const char *cur_name, c
|
||||
* If \p link_type is #H5G_LINK_SOFT, then \p cur_name can be anything
|
||||
* and is interpreted at lookup time relative to the group which
|
||||
* contains the final component of \p new_name. For instance, if \p
|
||||
* current_name is \Code{./foo}, \p new_name is \Code{./x/y/bar}, and a
|
||||
* request is made for \Code{./x/y/bar}, then the actual object looked
|
||||
* up is \Code{./x/y/./foo}.
|
||||
* current_name is \TText{./foo}, \p new_name is \TText{./x/y/bar}, and a
|
||||
* request is made for \TText{./x/y/bar}, then the actual object looked
|
||||
* up is \TText{./x/y/./foo}.
|
||||
*
|
||||
* \version 1.8.0 Function deprecated in this release.
|
||||
*
|
||||
@@ -895,7 +895,7 @@ H5_DLL herr_t H5Gget_linkval(hid_t loc_id, const char *name, size_t size, char *
|
||||
*
|
||||
* \fgdt_loc_id
|
||||
* \param[in] name Name of the object whose comment is to be set or reset
|
||||
* name must be \Code{'.'} (dot) if \p loc_id fully specifies
|
||||
* name must be \TText{'.'} (dot) if \p loc_id fully specifies
|
||||
* the object for which the comment is to be set.
|
||||
* \param[in] comment The new comment
|
||||
*
|
||||
@@ -937,7 +937,7 @@ H5_DLL herr_t H5Gset_comment(hid_t loc_id, const char *name, const char *comment
|
||||
*
|
||||
* \fgdt_loc_id
|
||||
* \param[in] name Name of the object whose comment is to be set or reset
|
||||
* name must be \Code{'.'} (dot) if \p loc_id fully specifies
|
||||
* name must be \TText{'.'} (dot) if \p loc_id fully specifies
|
||||
* the object for which the comment is to be set.
|
||||
* \param[in] bufsize Maximum number of comment characters to be returned in \p buf.
|
||||
* \param[in] buf The comment
|
||||
@@ -1160,7 +1160,7 @@ H5_DLL herr_t H5Gget_objinfo(hid_t loc_id, const char *name, hbool_t follow_link
|
||||
*
|
||||
* If the size of the provided buffer \p name is less or equal the
|
||||
* actual object name length, the object name is truncated to
|
||||
* \Code{max_size - 1} characters.
|
||||
* \TText{max_size - 1} characters.
|
||||
*
|
||||
* Note that if the size of the object's name is unknown, a preliminary
|
||||
* call to H5Gget_objname_by_idx() with \p name set to \c NULL will
|
||||
|
||||
+2
-2
@@ -640,13 +640,13 @@ H5_DLL herr_t H5Lget_val_by_idx(hid_t loc_id, const char *group_name, H5_index_t
|
||||
* denote a valid link access property list identifier. A call to
|
||||
* H5Lexists() with arguments \c file, \c "/", and \c lapl
|
||||
* returns a positive value; in other words,
|
||||
* \Code{H5Lexists(file, "/", lapl)} returns a positive value.
|
||||
* \TText{H5Lexists(file, "/", lapl)} returns a positive value.
|
||||
* In the HDF5 1.8 release, this function returns 0.</li>
|
||||
* <li>Let \c root denote a valid HDF5 group identifier that refers to the
|
||||
* root group of an HDF5 file, and let \c lapl denote a valid link
|
||||
* access property list identifier. A call to H5Lexists() with
|
||||
* arguments c root, \c "/", and \c lapl returns a positive value;
|
||||
* in other words, \Code{H5Lexists(root, "/", lapl)} returns a positive
|
||||
* in other words, \TText{H5Lexists(root, "/", lapl)} returns a positive
|
||||
* value. In the HDF5 1.8 release, this function returns 0.</li>
|
||||
* </ol>
|
||||
* Note that the function accepts link names and path names. This is
|
||||
|
||||
+100
-100
@@ -480,7 +480,7 @@ typedef enum H5D_mpio_no_collective_cause_t {
|
||||
H5D_MPIO_DATA_TRANSFORMS = 0x04,
|
||||
/**< Collective I/O was not performed because data transforms needed to be applied */
|
||||
H5D_MPIO_MPI_OPT_TYPES_ENV_VAR_DISABLED = 0x08,
|
||||
/**< Collective I/O was disabled by environment variable (\Code{HDF5_MPI_OPT_TYPES}) */
|
||||
/**< Collective I/O was disabled by environment variable (\TText{HDF5_MPI_OPT_TYPES}) */
|
||||
H5D_MPIO_NOT_SIMPLE_OR_SCALAR_DATASPACES = 0x10,
|
||||
/**< Collective I/O was not performed because one of the dataspaces was neither simple nor scalar */
|
||||
H5D_MPIO_NOT_CONTIGUOUS_OR_CHUNKED_DATASET = 0x20,
|
||||
@@ -1350,15 +1350,15 @@ H5_DLL herr_t H5Pget_size(hid_t id, const char *name, size_t *size);
|
||||
* modified</td>
|
||||
* </tr>
|
||||
* <tr>
|
||||
* <td>\Code{const char * name}</td>
|
||||
* <td>\TText{const char * name}</td>
|
||||
* <td>IN: The name of the property being modified</td>
|
||||
* </tr>
|
||||
* <tr>
|
||||
* <td>\Code{size_t size}</td>
|
||||
* <td>\TText{size_t size}</td>
|
||||
* <td>IN: The size of the property in bytes</td>
|
||||
* </tr>
|
||||
* <tr>
|
||||
* <td>\Code{void * value}</td>
|
||||
* <td>\TText{void * value}</td>
|
||||
* <td>IN: Pointer to new value pointer for the property
|
||||
* being modified</td>
|
||||
* </tr>
|
||||
@@ -1393,15 +1393,15 @@ H5_DLL herr_t H5Pget_size(hid_t id, const char *name, size_t *size);
|
||||
* <td>IN: The identifier of the property list being queried</td>
|
||||
* </tr>
|
||||
* <tr>
|
||||
* <td>\Code{const char * name}</td>
|
||||
* <td>\TText{const char * name}</td>
|
||||
* <td>IN: The name of the property being queried</td>
|
||||
* </tr>
|
||||
* <tr>
|
||||
* <td>\Code{size_t size}</td>
|
||||
* <td>\TText{size_t size}</td>
|
||||
* <td>IN: The size of the property in bytes</td>
|
||||
* </tr>
|
||||
* <tr>
|
||||
* <td>\Code{void * value}</td>
|
||||
* <td>\TText{void * value}</td>
|
||||
* <td>IN: The value of the property being returned</td>
|
||||
* </tr>
|
||||
* </table>
|
||||
@@ -1426,15 +1426,15 @@ H5_DLL herr_t H5Pget_size(hid_t id, const char *name, size_t *size);
|
||||
* being deleted from</td>
|
||||
* </tr>
|
||||
* <tr>
|
||||
* <td>\Code{const char * name}</td>
|
||||
* <td>\TText{const char * name}</td>
|
||||
* <td>IN: The name of the property in the list</td>
|
||||
* </tr>
|
||||
* <tr>
|
||||
* <td>\Code{size_t size}</td>
|
||||
* <td>\TText{size_t size}</td>
|
||||
* <td>IN: The size of the property in bytes</td>
|
||||
* </tr>
|
||||
* <tr>
|
||||
* <td>\Code{void * value}</td>
|
||||
* <td>\TText{void * value}</td>
|
||||
* <td>IN: The value for the property being deleted</td>
|
||||
* </tr>
|
||||
* </table>
|
||||
@@ -1455,15 +1455,15 @@ H5_DLL herr_t H5Pget_size(hid_t id, const char *name, size_t *size);
|
||||
* The parameters to the above callback function are:
|
||||
* <table>
|
||||
* <tr>
|
||||
* <td>\Code{const char * name}</td>
|
||||
* <td>\TText{const char * name}</td>
|
||||
* <td>IN: The name of the property being copied</td>
|
||||
* </tr>
|
||||
* <tr>
|
||||
* <td>\Code{size_t size}</td>
|
||||
* <td>\TText{size_t size}</td>
|
||||
* <td>IN: The size of the property in bytes</td>
|
||||
* </tr>
|
||||
* <tr>
|
||||
* <td>\Code{void * value}</td>
|
||||
* <td>\TText{void * value}</td>
|
||||
* <td>IN/OUT: The value for the property being copied</td>
|
||||
* </tr>
|
||||
* </table>
|
||||
@@ -1487,15 +1487,15 @@ H5_DLL herr_t H5Pget_size(hid_t id, const char *name, size_t *size);
|
||||
*
|
||||
* <table>
|
||||
* <tr>
|
||||
* <td>\Code{const void * value1}</td>
|
||||
* <td>\TText{const void * value1}</td>
|
||||
* <td>IN: The value of the first property to compare</td>
|
||||
* </tr>
|
||||
* <tr>
|
||||
* <td>\Code{const void * value2}</td>
|
||||
* <td>\TText{const void * value2}</td>
|
||||
* <td>IN: The value of the second property to compare</td>
|
||||
* </tr>
|
||||
* <tr>
|
||||
* <td>\Code{size_t size}</td>
|
||||
* <td>\TText{size_t size}</td>
|
||||
* <td>IN: The size of the property in bytes</td>
|
||||
* </tr>
|
||||
* </table>
|
||||
@@ -1515,15 +1515,15 @@ H5_DLL herr_t H5Pget_size(hid_t id, const char *name, size_t *size);
|
||||
*
|
||||
* <table>
|
||||
* <tr>
|
||||
* <td>\Code{const char * name}</td>
|
||||
* <td>\TText{const char * name}</td>
|
||||
* <td>IN: The name of the property in the list</td>
|
||||
* </tr>
|
||||
* <tr>
|
||||
* <td>\Code{size_t size}</td>
|
||||
* <td>\TText{size_t size}</td>
|
||||
* <td>IN: The size of the property in bytes</td>
|
||||
* </tr>
|
||||
* <tr>
|
||||
* <td>\Code{void * value}</td>
|
||||
* <td>\TText{void * value}</td>
|
||||
* <td>IN: The value for the property being closed</td>
|
||||
* </tr>
|
||||
* </table>
|
||||
@@ -1667,15 +1667,15 @@ H5_DLL int H5Piterate(hid_t id, int *idx, H5P_iterate_t iter_func, void *iter_da
|
||||
*
|
||||
* <table>
|
||||
* <tr>
|
||||
* <td>\Code{const char * name}</td>
|
||||
* <td>\TText{const char * name}</td>
|
||||
* <td>IN: The name of the property being modified</td>
|
||||
* </tr>
|
||||
* <tr>
|
||||
* <td>\Code{size_t size}</td>
|
||||
* <td>\TText{size_t size}</td>
|
||||
* <td>IN: The size of the property in bytes</td>
|
||||
* </tr>
|
||||
* <tr>
|
||||
* <td>\Code{void * value}</td>
|
||||
* <td>\TText{void * value}</td>
|
||||
* <td>IN/OUT: The default value for the property being created,
|
||||
* which will be passed to H5Pregister2()</td>
|
||||
* </tr>
|
||||
@@ -1701,15 +1701,15 @@ H5_DLL int H5Piterate(hid_t id, int *idx, H5P_iterate_t iter_func, void *iter_da
|
||||
* <td>IN: The identifier of the property list being modified</td>
|
||||
* </tr>
|
||||
* <tr>
|
||||
* <td>\Code{const char * name}</td>
|
||||
* <td>\TText{const char * name}</td>
|
||||
* <td>IN: The name of the property being modified</td>
|
||||
* </tr>
|
||||
* <tr>
|
||||
* <td>\Code{size_t size}</td>
|
||||
* <td>\TText{size_t size}</td>
|
||||
* <td>IN: The size of the property in bytes</td>
|
||||
* </tr>
|
||||
* <tr>
|
||||
* <td>\Code{void *value}</td>
|
||||
* <td>\TText{void *value}</td>
|
||||
* <td>IN/OUT: Pointer to new value pointer for the property
|
||||
* being modified</td>
|
||||
* </tr>
|
||||
@@ -1745,15 +1745,15 @@ H5_DLL int H5Piterate(hid_t id, int *idx, H5P_iterate_t iter_func, void *iter_da
|
||||
* queried</td>
|
||||
* </tr>
|
||||
* <tr>
|
||||
* <td>\Code{const char * name}</td>
|
||||
* <td>\TText{const char * name}</td>
|
||||
* <td>IN: The name of the property being queried</td>
|
||||
* </tr>
|
||||
* <tr>
|
||||
* <td>\Code{size_t size}</td>
|
||||
* <td>\TText{size_t size}</td>
|
||||
* <td>IN: The size of the property in bytes</td>
|
||||
* </tr>
|
||||
* <tr>
|
||||
* <td>\Code{void * value}</td>
|
||||
* <td>\TText{void * value}</td>
|
||||
* <td>IN/OUT: The value of the property being returned</td>
|
||||
* </tr>
|
||||
* </table>
|
||||
@@ -1778,15 +1778,15 @@ H5_DLL int H5Piterate(hid_t id, int *idx, H5P_iterate_t iter_func, void *iter_da
|
||||
* being deleted from</td>
|
||||
* </tr>
|
||||
* <tr>
|
||||
* <td>\Code{const char * name}</td>
|
||||
* <td>\TText{const char * name}</td>
|
||||
* <td>IN: The name of the property in the list</td>
|
||||
* </tr>
|
||||
* <tr>
|
||||
* <td>\Code{size_t size}</td>
|
||||
* <td>\TText{size_t size}</td>
|
||||
* <td>IN: The size of the property in bytes</td>
|
||||
* </tr>
|
||||
* <tr>
|
||||
* <td>\Code{void * value}</td>
|
||||
* <td>\TText{void * value}</td>
|
||||
* <td>IN: The value for the property being deleted</td>
|
||||
* </tr>
|
||||
* </table>
|
||||
@@ -1807,15 +1807,15 @@ H5_DLL int H5Piterate(hid_t id, int *idx, H5P_iterate_t iter_func, void *iter_da
|
||||
*
|
||||
* <table>
|
||||
* <tr>
|
||||
* <td>\Code{const char * name}</td>
|
||||
* <td>\TText{const char * name}</td>
|
||||
* <td>IN: The name of the property being copied</td>
|
||||
* </tr>
|
||||
* <tr>
|
||||
* <td>\Code{size_t size}</td>
|
||||
* <td>\TText{size_t size}</td>
|
||||
* <td>IN: The size of the property in bytes</td>
|
||||
* </tr>
|
||||
* <tr>
|
||||
* <td>\Code{void * value}</td>
|
||||
* <td>\TText{void * value}</td>
|
||||
* <td>IN/OUT: The value for the property being copied</td>
|
||||
* </tr>
|
||||
* </table>
|
||||
@@ -1837,15 +1837,15 @@ H5_DLL int H5Piterate(hid_t id, int *idx, H5P_iterate_t iter_func, void *iter_da
|
||||
*
|
||||
* <table>
|
||||
* <tr>
|
||||
* <td>\Code{const void * value1}</td>
|
||||
* <td>\TText{const void * value1}</td>
|
||||
* <td>IN: The value of the first property to compare</td>
|
||||
* </tr>
|
||||
* <tr>
|
||||
* <td>\Code{const void * value2}</td>
|
||||
* <td>\TText{const void * value2}</td>
|
||||
* <td>IN: The value of the second property to compare</td>
|
||||
* </tr>
|
||||
* <tr>
|
||||
* <td>\Code{size_t size}</td>
|
||||
* <td>\TText{size_t size}</td>
|
||||
* <td>IN: The size of the property in bytes</td>
|
||||
* </tr>
|
||||
* </table>
|
||||
@@ -1865,15 +1865,15 @@ H5_DLL int H5Piterate(hid_t id, int *idx, H5P_iterate_t iter_func, void *iter_da
|
||||
*
|
||||
* <table>
|
||||
* <tr>
|
||||
* <td>\Code{const char * name}</td>
|
||||
* <td>\TText{const char * name}</td>
|
||||
* <td>IN: The name of the property in the list</td>
|
||||
* </tr>
|
||||
* <tr>
|
||||
* <td>\Code{size_t size}</td>
|
||||
* <td>\TText{size_t size}</td>
|
||||
* <td>IN: The size of the property in bytes</td>
|
||||
* </tr>
|
||||
* <tr>
|
||||
* <td>\Code{void * value}</td>
|
||||
* <td>\TText{void * value}</td>
|
||||
* <td>IN: The value for the property being closed</td>
|
||||
* </tr>
|
||||
* </table>
|
||||
@@ -2204,7 +2204,7 @@ H5_DLL herr_t H5Pget_filter_by_id2(hid_t plist_id, H5Z_filter_t filter_id, unsig
|
||||
* \details H5Pget_nfilters() returns the number of filters defined in the
|
||||
* filter pipeline associated with the property list \p plist_id.
|
||||
*
|
||||
* In each pipeline, the filters are numbered from 0 through \Code{N-1},
|
||||
* In each pipeline, the filters are numbered from 0 through \TText{N-1},
|
||||
* where \c N is the value returned by this function. During output to
|
||||
* the file, the filters are applied in increasing order; during
|
||||
* input from the file, they are applied in decreasing order.
|
||||
@@ -2821,7 +2821,7 @@ H5_DLL herr_t H5Pset_fletcher32(hid_t plist_id);
|
||||
* return it in the #H5O_info_t struct.
|
||||
*
|
||||
* If times are not tracked, they will be reported as follows when queried:
|
||||
* \Code{ 12:00 AM UDT, Jan. 1, 1970}
|
||||
* \TText{ 12:00 AM UDT, Jan. 1, 1970}
|
||||
*
|
||||
* That date and time are commonly used to represent the beginning of the UNIX epoch.
|
||||
*
|
||||
@@ -3674,17 +3674,17 @@ H5_DLL herr_t H5Pget_fclose_degree(hid_t fapl_id, H5F_close_degree_t *degree);
|
||||
* \param[in,out] buf_ptr_ptr On input, \c NULL or a pointer to a
|
||||
* pointer to a buffer that contains the
|
||||
* file image.\n On successful return, if \p buf_ptr_ptr is not
|
||||
* \c NULL, \Code{*buf_ptr_ptr} will contain a pointer to a copy
|
||||
* \c NULL, \TText{*buf_ptr_ptr} will contain a pointer to a copy
|
||||
* of the initial image provided in the last call to
|
||||
* H5Pset_file_image() for the supplied \p fapl_id. If no initial
|
||||
* image has been set, \Code{*buf_ptr_ptr} will be \c NULL.
|
||||
* image has been set, \TText{*buf_ptr_ptr} will be \c NULL.
|
||||
* \param[in,out] buf_len_ptr On input, \c NULL or a pointer to a buffer
|
||||
* specifying the required size of the buffer to hold the file
|
||||
* image.\n On successful return, if \p buf_len_ptr was not
|
||||
* passed in as \c NULL, \p buf_len_ptr will return the required
|
||||
* size in bytes of the buffer to hold the initial file image in
|
||||
* the supplied file access property list, \p fapl_id. If no
|
||||
* initial image is set, the value of \Code{*buf_len_ptr} will be
|
||||
* initial image is set, the value of \TText{*buf_len_ptr} will be
|
||||
* set to 0 (zero)
|
||||
* \return \herr_t
|
||||
*
|
||||
@@ -3850,7 +3850,7 @@ H5_DLL herr_t H5Pget_libver_bounds(hid_t plist_id, H5F_libver_t *low, H5F_libver
|
||||
* instance of #H5AC_cache_config_t pointed to by the \p config_ptr
|
||||
* parameter. This configuration is used when the file is opened.
|
||||
*
|
||||
* Note that the version field of \Code{*config_ptr} must be
|
||||
* Note that the version field of \TText{*config_ptr} must be
|
||||
* initialized; this allows the library to support earlier versions of
|
||||
* the #H5AC_cache_config_t structure.
|
||||
*
|
||||
@@ -5232,7 +5232,7 @@ H5_DLL herr_t H5Pset_mdc_log_options(hid_t plist_id, hbool_t is_enabled, const c
|
||||
*
|
||||
* The default setting is 2048 bytes, meaning that the library will
|
||||
* attempt to aggregate metadata in at least 2K blocks in the file.
|
||||
* Setting the value to zero (\Code{0}) with this function will turn
|
||||
* Setting the value to zero (\TText{0}) with this function will turn
|
||||
* off metadata aggregation, even if the VFL driver attempts to use the
|
||||
* metadata aggregation strategy.
|
||||
*
|
||||
@@ -5250,12 +5250,12 @@ H5_DLL herr_t H5Pset_meta_block_size(hid_t fapl_id, hsize_t size);
|
||||
* \brief Sets the number of read attempts in a file access property list
|
||||
*
|
||||
* \fapl_id{plist_id}
|
||||
* \param[in] attempts The number of read attempts. Must be a value greater than \Code{0}
|
||||
* \param[in] attempts The number of read attempts. Must be a value greater than \TText{0}
|
||||
*
|
||||
* \return \herr_t
|
||||
*
|
||||
* \return Failure Modes:
|
||||
* - When the user sets the number of read attempts to \Code{0}.
|
||||
* - When the user sets the number of read attempts to \TText{0}.
|
||||
* - When the input property list is not a file access property list.
|
||||
* - When the library is unable to set the number of read attempts in the file access property list.
|
||||
*
|
||||
@@ -5273,11 +5273,11 @@ H5_DLL herr_t H5Pset_meta_block_size(hid_t fapl_id, hsize_t size);
|
||||
* opened and whether the user sets the number of read attempts via this routine:
|
||||
|
||||
* - For a file opened with SWMR access:
|
||||
* - If the user sets the number of attempts to \Code{N}, the library will use \Code{N}.
|
||||
* - If the user sets the number of attempts to \TText{N}, the library will use \TText{N}.
|
||||
* - If the user does not set the number of attempts, the library will use the
|
||||
* default for SWMR access (\Code{100}).
|
||||
* default for SWMR access (\TText{100}).
|
||||
* - For a file opened with non-SWMR access, the library will always use the default
|
||||
* for non-SWMR access (\Code{1}). The value set via this routine does not have any effect
|
||||
* for non-SWMR access (\TText{1}). The value set via this routine does not have any effect
|
||||
* during non-SWMR access.
|
||||
*
|
||||
* \b Example: The first example illustrates the case in setting the number of read attempts for a file
|
||||
@@ -5304,7 +5304,7 @@ H5_DLL herr_t H5Pset_metadata_read_attempts(hid_t plist_id, unsigned attempts);
|
||||
/**
|
||||
* \ingroup FAPL
|
||||
*
|
||||
* \brief Specifies type of data to be accessed via the \Code{MULTI} driver,
|
||||
* \brief Specifies type of data to be accessed via the \TText{MULTI} driver,
|
||||
* enabling more direct access
|
||||
*
|
||||
* \fapl_id{fapl_id}
|
||||
@@ -5316,7 +5316,7 @@ H5_DLL herr_t H5Pset_metadata_read_attempts(hid_t plist_id, unsigned attempts);
|
||||
* access property list \p fapl_id. This setting enables a user
|
||||
* application to specify the type of data the application wishes to
|
||||
* access so that the application can retrieve a file handle for
|
||||
* low-level access to the particular member of a set of \Code{MULTI}
|
||||
* low-level access to the particular member of a set of \TText{MULTI}
|
||||
* files in which that type of data is stored. The file handle is
|
||||
* retrieved with a separate call to H5Fget_vfd_handle() (or, in special
|
||||
* circumstances, to H5FDget_vfd_handle(); see \ref VFL.
|
||||
@@ -5345,7 +5345,7 @@ H5_DLL herr_t H5Pset_metadata_read_attempts(hid_t plist_id, unsigned attempts);
|
||||
* </table>
|
||||
*
|
||||
* This function is for use only when accessing an HDF5 file written as a set of
|
||||
* files with the \Code{MULTI} file driver.
|
||||
* files with the \TText{MULTI} file driver.
|
||||
*
|
||||
* \since 1.6.0
|
||||
*/
|
||||
@@ -5372,8 +5372,8 @@ H5_DLL herr_t H5Pset_multi_type(hid_t fapl_id, H5FD_mem_t type);
|
||||
* \endcode
|
||||
*
|
||||
* The parameters of the callback function, per the above prototypes, are defined as follows:
|
||||
* - \Code{object_id} is the identifier of the object which has just been flushed.
|
||||
* - \Code{user_data} is the user-defined input data for the callback function.
|
||||
* - \TText{object_id} is the identifier of the object which has just been flushed.
|
||||
* - \TText{user_data} is the user-defined input data for the callback function.
|
||||
*
|
||||
* \b Example: The example below illustrates the usage of this routine to set
|
||||
* the callback function to invoke when an object flush occurs.
|
||||
@@ -5404,7 +5404,7 @@ H5_DLL herr_t H5Pset_object_flush_cb(hid_t plist_id, H5F_flush_cb_t func, void *
|
||||
*
|
||||
* The default value is set to 64KB, indicating that file I/O for raw
|
||||
* data reads and writes will occur in at least 64KB blocks. Setting
|
||||
* the value to zero (\Code{0}) with this API function will turn off
|
||||
* the value to zero (\TText{0}) with this API function will turn off
|
||||
* the data sieving, even if the VFL driver attempts to use that
|
||||
* strategy.
|
||||
*
|
||||
@@ -5413,7 +5413,7 @@ H5_DLL herr_t H5Pset_object_flush_cb(hid_t plist_id, H5F_flush_cb_t func, void *
|
||||
* access property and the size of the dataset to allocate the sieve
|
||||
* buffer for the dataset in order to save memory usage.
|
||||
*
|
||||
* \version 1.6.0 The \p size parameter has changed from type \Code{hsize_t} to \Code{size_t}.
|
||||
* \version 1.6.0 The \p size parameter has changed from type \TText{hsize_t} to \TText{size_t}.
|
||||
*
|
||||
* \since 1.4.0
|
||||
*/
|
||||
@@ -5425,7 +5425,7 @@ H5_DLL herr_t H5Pset_sieve_buf_size(hid_t fapl_id, size_t size);
|
||||
*
|
||||
* \fapl_id{fapl_id}
|
||||
* \param[in] size Maximum size, in bytes, of the small data block.
|
||||
The default size is \Code{2048}.
|
||||
The default size is \TText{2048}.
|
||||
*
|
||||
* \return \herr_t
|
||||
*
|
||||
@@ -5451,7 +5451,7 @@ H5_DLL herr_t H5Pset_sieve_buf_size(hid_t fapl_id, size_t size);
|
||||
* The small data block size is set as an allocation property in the
|
||||
* file access property list identified by \p fapl_id.
|
||||
*
|
||||
* Setting \p size to zero (\Code{0}) disables the small data block mechanism.
|
||||
* Setting \p size to zero (\TText{0}) disables the small data block mechanism.
|
||||
*
|
||||
* \since 1.4.4
|
||||
*/
|
||||
@@ -5512,8 +5512,8 @@ H5_DLL herr_t H5Pget_vol_cap_flags(hid_t plist_id, uint64_t *cap_flags);
|
||||
*
|
||||
* \gacpl_id
|
||||
* \param[in] is_collective Boolean value indicating whether metadata reads are collective
|
||||
* (\Code{1}) or independent (\Code{0}).
|
||||
* Default mode: Independent (\Code{0})
|
||||
* (\TText{1}) or independent (\TText{0}).
|
||||
* Default mode: Independent (\TText{0})
|
||||
*
|
||||
* \return \herr_t
|
||||
*
|
||||
@@ -5521,9 +5521,9 @@ H5_DLL herr_t H5Pget_vol_cap_flags(hid_t plist_id, uint64_t *cap_flags);
|
||||
* operations in the access property list \p plist_id.
|
||||
*
|
||||
* When engaging in parallel I/O, all metadata write operations must be
|
||||
* collective. If \p is_collective is \Code{1}, this property specifies
|
||||
* collective. If \p is_collective is \TText{1}, this property specifies
|
||||
* that the HDF5 library will perform all metadata read operations
|
||||
* collectively; if \p is_collective is \Code{0}, such operations may
|
||||
* collectively; if \p is_collective is \TText{0}, such operations may
|
||||
* be performed independently.
|
||||
*
|
||||
* Users must be aware that several HDF5 operations can potentially
|
||||
@@ -5563,7 +5563,7 @@ H5_DLL herr_t H5Pget_vol_cap_flags(hid_t plist_id, uint64_t *cap_flags);
|
||||
* cache and HDF5 library behavior will be undefined when both of the following
|
||||
* conditions exist:
|
||||
* - A file is created or opened with a file access property list in which the
|
||||
* collective metadata I/O property is set to \Code{1}.
|
||||
* collective metadata I/O property is set to \TText{1}.
|
||||
* - Any function is called that triggers an independent metadata read while the
|
||||
* file remains open with that file access property list.
|
||||
*
|
||||
@@ -5581,8 +5581,8 @@ H5_DLL herr_t H5Pset_all_coll_metadata_ops(hid_t plist_id, hbool_t is_collective
|
||||
*
|
||||
* \gacpl_id
|
||||
* \param[out] is_collective Pointer to a buffer containing the Boolean value indicating whether metadata
|
||||
* reads are collective (\Code{>0}) or independent (\Code{0}).
|
||||
* Default mode: Independent (\Code{0})
|
||||
* reads are collective (\TText{>0}) or independent (\TText{0}).
|
||||
* Default mode: Independent (\TText{0})
|
||||
*
|
||||
* \return \herr_t
|
||||
*
|
||||
@@ -5601,8 +5601,8 @@ H5_DLL herr_t H5Pget_all_coll_metadata_ops(hid_t plist_id, hbool_t *is_collectiv
|
||||
*
|
||||
* \fapl_id{plist_id}
|
||||
* \param[out] is_collective Boolean value indicating whether metadata
|
||||
* writes are collective (\Code{>0}) or independent (\Code{0}).
|
||||
* \Emph{Default mode:} Independent (\Code{0})
|
||||
* writes are collective (\TText{>0}) or independent (\TText{0}).
|
||||
* \Emph{Default mode:} Independent (\TText{0})
|
||||
* \return \herr_t
|
||||
*
|
||||
* \details H5Pset_coll_metadata_write() tells the HDF5 library whether to
|
||||
@@ -5630,8 +5630,8 @@ H5_DLL herr_t H5Pset_coll_metadata_write(hid_t plist_id, hbool_t is_collective);
|
||||
*
|
||||
* \fapl_id{plist_id}
|
||||
* \param[out] is_collective Pointer to a boolean value indicating whether
|
||||
* metadata writes are collective (\Code{>0}) or independent (\Code{0}).
|
||||
* \Emph{Default mode:} Independent (\Code{0})
|
||||
* metadata writes are collective (\TText{>0}) or independent (\TText{0}).
|
||||
* \Emph{Default mode:} Independent (\TText{0})
|
||||
* \return \herr_t
|
||||
*
|
||||
* \details H5Pget_coll_metadata_write() retrieves the collective metadata write
|
||||
@@ -5721,7 +5721,7 @@ H5_DLL herr_t H5Pset_mpi_params(hid_t fapl_id, MPI_Comm comm, MPI_Info info);
|
||||
* #H5AC_cache_image_config_t::entry_ageout should address this problem. In
|
||||
* the interim, not requesting a cache image every n file close/open cycles
|
||||
* may be an acceptable work around. The choice of \c n will be driven by
|
||||
* application behavior, but \Code{n = 10} seems a good starting point.
|
||||
* application behavior, but \TText{n = 10} seems a good starting point.
|
||||
*
|
||||
* \since 1.10.1
|
||||
*/
|
||||
@@ -7073,7 +7073,7 @@ H5_DLL herr_t H5Pset_szip(hid_t plist_id, unsigned options_mask, unsigned pixels
|
||||
* \param[in] vspace_id The dataspace identifier with the selection within the
|
||||
* virtual dataset applied, possibly an unlimited selection
|
||||
* \param[in] src_file_name The name of the HDF5 file where the source dataset is
|
||||
* located or a \Code{"."} (period) for a source dataset in the same
|
||||
* located or a \TText{"."} (period) for a source dataset in the same
|
||||
* file. The file might not exist yet. The name can be specified using
|
||||
* a C-style \c printf statement as described below.
|
||||
* \param[in] src_dset_name The path to the HDF5 dataset in the file specified by
|
||||
@@ -7096,14 +7096,14 @@ H5_DLL herr_t H5Pset_szip(hid_t plist_id, unsigned options_mask, unsigned pixels
|
||||
* treated as literals except for the following substitutions:
|
||||
* <table>
|
||||
* <tr>
|
||||
* <td>\Code{"%%"}</td>
|
||||
* <td>Replaced with a single \Code{"%"} (percent) character.</td>
|
||||
* <td>\TText{"%%"}</td>
|
||||
* <td>Replaced with a single \TText{"%"} (percent) character.</td>
|
||||
* </tr>
|
||||
* <tr>
|
||||
* <td><code>"%<d>b"</code></td>
|
||||
* <td>Where <code>"<d>"</code> is the virtual dataset dimension axis (0-based)
|
||||
* and \Code{"b"} indicates that the block count of the selection in that
|
||||
* dimension should be used. The full expression (for example, \Code{"%0b"})
|
||||
* and \TText{"b"} indicates that the block count of the selection in that
|
||||
* dimension should be used. The full expression (for example, \TText{"%0b"})
|
||||
* is replaced with a single numeric value when the mapping is evaluated at
|
||||
* VDS access time. Example code for many source and virtual dataset mappings
|
||||
* is available in the "Examples of Source to Virtual Dataset Mapping"
|
||||
@@ -7120,7 +7120,7 @@ H5_DLL herr_t H5Pset_szip(hid_t plist_id, unsigned options_mask, unsigned pixels
|
||||
* When a source dataset residing in a different file is accessed, the
|
||||
* library will search for the source file \p src_file_name as described
|
||||
* below:
|
||||
* \li If \p src_file_name is a \Code{"."} (period) then it refers to the
|
||||
* \li If \p src_file_name is a \TText{"."} (period) then it refers to the
|
||||
* file containing the virtual dataset.
|
||||
* \li If \p src_file_name is a relative pathname, the following steps are
|
||||
* performed:
|
||||
@@ -7149,37 +7149,37 @@ H5_DLL herr_t H5Pset_szip(hid_t plist_id, unsigned options_mask, unsigned pixels
|
||||
* Note that \p src_file_name is considered to be an absolute pathname when
|
||||
* the following condition is true:
|
||||
* \li For Unix, the first character of \p src_file_name is a slash
|
||||
* (\Code{/}).\n For example, consider a \p src_file_name of
|
||||
* \Code{/tmp/A.h5}. If that source file does not exist, the new
|
||||
* \p src_file_name after stripping will be \Code{A.h5}.
|
||||
* (\TText{/}).\n For example, consider a \p src_file_name of
|
||||
* \TText{/tmp/A.h5}. If that source file does not exist, the new
|
||||
* \p src_file_name after stripping will be \TText{A.h5}.
|
||||
* \li For Windows, there are 6 cases:
|
||||
* 1. \p src_file_name is an absolute drive with absolute pathname.\n
|
||||
* For example, consider a \p src_file_name of \Code{/tmp/A.h5}.
|
||||
* For example, consider a \p src_file_name of \TText{/tmp/A.h5}.
|
||||
* If that source file does not exist, the new \p src_file_name
|
||||
* after stripping will be \Code{A.h5}.
|
||||
* after stripping will be \TText{A.h5}.
|
||||
* 2. \p src_file_name is an absolute pathname without specifying
|
||||
* drive name.\n For example, consider a \p src_file_name of
|
||||
* \Code{/tmp/A.h5}. If that source file does not exist, the new
|
||||
* \p src_file_name after stripping will be \Code{A.h5}.
|
||||
* \TText{/tmp/A.h5}. If that source file does not exist, the new
|
||||
* \p src_file_name after stripping will be \TText{A.h5}.
|
||||
* 3. \p src_file_name is an absolute drive with relative pathname.\n
|
||||
* For example, consider a \p src_file_name of \Code{/tmp/A.h5}.
|
||||
* For example, consider a \p src_file_name of \TText{/tmp/A.h5}.
|
||||
* If that source file does not exist, the new \p src_file_name
|
||||
* after stripping will be \Code{tmp/A.h5}.
|
||||
* after stripping will be \TText{tmp/A.h5}.
|
||||
* 4. \p src_file_name is in UNC (Uniform Naming Convention) format
|
||||
* with server name, share name, and pathname.\n
|
||||
* For example, consider a \p src_file_name of \Code{/tmp/A.h5}.
|
||||
* For example, consider a \p src_file_name of \TText{/tmp/A.h5}.
|
||||
* If that source file does not exist, the new \p src_file_name
|
||||
* after stripping will be \Code{A.h5}.
|
||||
* after stripping will be \TText{A.h5}.
|
||||
* 5. \p src_file_name is in Long UNC (Uniform Naming Convention)
|
||||
* format with server name, share name, and pathname.\n
|
||||
* For example, consider a \p src_file_name of \Code{/tmp/A.h5}.
|
||||
* For example, consider a \p src_file_name of \TText{/tmp/A.h5}.
|
||||
* If that source file does not exist, the new \p src_file_name
|
||||
* after stripping will be \Code{A.h5}.
|
||||
* after stripping will be \TText{A.h5}.
|
||||
* 6. \p src_file_name is in Long UNC (Uniform Naming Convention)
|
||||
* format with an absolute drive and an absolute pathname.\n
|
||||
* For example, consider a \p src_file_name of \Code{/tmp/A.h5}.
|
||||
* For example, consider a \p src_file_name of \TText{/tmp/A.h5}.
|
||||
* If that source file does not exist, the new \p src_file_name
|
||||
* after stripping will be \Code{A.h5}
|
||||
* after stripping will be \TText{A.h5}
|
||||
*
|
||||
* \see <a href="https://\RFCURL/HDF5-VDS-requirements-use-cases-2014-12-10.pdf">
|
||||
* Virtual Dataset Overview</a>
|
||||
@@ -7538,7 +7538,7 @@ H5_DLL herr_t H5Pset_append_flush(hid_t dapl_id, unsigned ndims, const hsize_t b
|
||||
* use a hash table with 12421 elements and a maximum size of
|
||||
* 16 MB, while using the preemption policy specified for the
|
||||
* entire file:
|
||||
* \Code{
|
||||
* \TText{
|
||||
* H5Pset_chunk_cache(dapl_id, 12421, 16*1024*1024,
|
||||
* H5D_CHUNK_CACHE_W0_DEFAULT);}
|
||||
*
|
||||
@@ -8012,11 +8012,11 @@ H5_DLL herr_t H5Pset_btree_ratios(hid_t plist_id, double left, double middle, do
|
||||
* mining can only break the data up along the first dimension, so the
|
||||
* buffer must be large enough to accommodate a complete slice that
|
||||
* encompasses all of the remaining dimensions. For example, when strip
|
||||
* mining a \Code{100x200x300} hyperslab of a simple data space, the
|
||||
* buffer must be large enough to hold \Code{1x200x300} data
|
||||
* elements. When strip mining a \Code{100x200x300x150} hyperslab of a
|
||||
* mining a \TText{100x200x300} hyperslab of a simple data space, the
|
||||
* buffer must be large enough to hold \TText{1x200x300} data
|
||||
* elements. When strip mining a \TText{100x200x300x150} hyperslab of a
|
||||
* simple data space, the buffer must be large enough to hold
|
||||
* \Code{1x200x300x150} data elements.
|
||||
* \TText{1x200x300x150} data elements.
|
||||
*
|
||||
* If \p tconv and/or \p bkg are null pointers, then buffers will be
|
||||
* allocated and freed during the data transfer.
|
||||
@@ -8046,7 +8046,7 @@ H5_DLL herr_t H5Pset_buffer(hid_t plist_id, size_t size, void *tconv, void *bkg)
|
||||
* transfer property list \p plist_id.
|
||||
*
|
||||
* The \p expression parameter is a string containing an algebraic
|
||||
* expression, such as \Code{(5/9.0)*(x-32)} or \Code{x*(x-5)}. When a
|
||||
* expression, such as \TText{(5/9.0)*(x-32)} or \TText{x*(x-5)}. When a
|
||||
* dataset is read or written with this property list, the transform
|
||||
* expression is applied with the \c x being replaced by the values in
|
||||
* the dataset. When reading data, the values in the file are not
|
||||
|
||||
+3
-3
@@ -2019,7 +2019,7 @@ filled according to the value of this property. The padding can be:
|
||||
* </tr>
|
||||
* </table>
|
||||
*
|
||||
* <em>Code for a compound datatype nested in a compound datatype</em>
|
||||
* <em>TText for a compound datatype nested in a compound datatype</em>
|
||||
* \code
|
||||
* typedef struct {
|
||||
* complex_t x;
|
||||
@@ -4006,8 +4006,8 @@ filled according to the value of this property. The padding can be:
|
||||
* component, they have a C-like type name.
|
||||
* \li If the type begins with \c U then it is the unsigned version of
|
||||
* the integer type; other integer types are signed.
|
||||
* \li The datatype \c LLONG corresponds C's \Code{long long} and
|
||||
* \c LDOUBLE is \Code{long double}. These types might be the same
|
||||
* \li The datatype \c LLONG corresponds C's \TText{long long} and
|
||||
* \c LDOUBLE is \TText{long double}. These types might be the same
|
||||
* as \c LONG and \c DOUBLE, respectively.
|
||||
* <div>
|
||||
* \snippet{doc} tables/predefinedDatatypes.dox predefined_native_datatypes_table
|
||||
|
||||
+14
-14
@@ -755,72 +755,72 @@ H5_DLLVAR hid_t H5T_VAX_F64_g;
|
||||
#define H5T_NATIVE_CHAR (CHAR_MIN ? H5T_NATIVE_SCHAR : H5T_NATIVE_UCHAR)
|
||||
/**
|
||||
* \ingroup PDTNAT
|
||||
* C-style \Code{signed char}
|
||||
* C-style \TText{signed char}
|
||||
*/
|
||||
#define H5T_NATIVE_SCHAR (H5OPEN H5T_NATIVE_SCHAR_g)
|
||||
/**
|
||||
* \ingroup PDTNAT
|
||||
* C-style \Code{unsigned char}
|
||||
* C-style \TText{unsigned char}
|
||||
*/
|
||||
#define H5T_NATIVE_UCHAR (H5OPEN H5T_NATIVE_UCHAR_g)
|
||||
/**
|
||||
* \ingroup PDTNAT
|
||||
* C-style \Code{short}
|
||||
* C-style \TText{short}
|
||||
*/
|
||||
#define H5T_NATIVE_SHORT (H5OPEN H5T_NATIVE_SHORT_g)
|
||||
/**
|
||||
* \ingroup PDTNAT
|
||||
* C-style \Code{unsigned short}
|
||||
* C-style \TText{unsigned short}
|
||||
*/
|
||||
#define H5T_NATIVE_USHORT (H5OPEN H5T_NATIVE_USHORT_g)
|
||||
/**
|
||||
* \ingroup PDTNAT
|
||||
* C-style \Code{int}
|
||||
* C-style \TText{int}
|
||||
*/
|
||||
#define H5T_NATIVE_INT (H5OPEN H5T_NATIVE_INT_g)
|
||||
/**
|
||||
* \ingroup PDTNAT
|
||||
* C-style \Code{unsigned int}
|
||||
* C-style \TText{unsigned int}
|
||||
*/
|
||||
#define H5T_NATIVE_UINT (H5OPEN H5T_NATIVE_UINT_g)
|
||||
/**
|
||||
* \ingroup PDTNAT
|
||||
* C-style \Code{long}
|
||||
* C-style \TText{long}
|
||||
*/
|
||||
#define H5T_NATIVE_LONG (H5OPEN H5T_NATIVE_LONG_g)
|
||||
/**
|
||||
* \ingroup PDTNAT
|
||||
* C-style \Code{unsigned long}
|
||||
* C-style \TText{unsigned long}
|
||||
*/
|
||||
#define H5T_NATIVE_ULONG (H5OPEN H5T_NATIVE_ULONG_g)
|
||||
/**
|
||||
* \ingroup PDTNAT
|
||||
* C-style \Code{long long}
|
||||
* C-style \TText{long long}
|
||||
*/
|
||||
#define H5T_NATIVE_LLONG (H5OPEN H5T_NATIVE_LLONG_g)
|
||||
/**
|
||||
* \ingroup PDTNAT
|
||||
* C-style \Code{unsigned long long}
|
||||
* C-style \TText{unsigned long long}
|
||||
*/
|
||||
#define H5T_NATIVE_ULLONG (H5OPEN H5T_NATIVE_ULLONG_g)
|
||||
/**
|
||||
* \ingroup PDTNAT
|
||||
* C-style \Code{_Float16}
|
||||
* C-style \TText{_Float16}
|
||||
*/
|
||||
#define H5T_NATIVE_FLOAT16 (H5OPEN H5T_NATIVE_FLOAT16_g)
|
||||
/**
|
||||
* \ingroup PDTNAT
|
||||
* C-style \Code{float}
|
||||
* C-style \TText{float}
|
||||
*/
|
||||
#define H5T_NATIVE_FLOAT (H5OPEN H5T_NATIVE_FLOAT_g)
|
||||
/**
|
||||
* \ingroup PDTNAT
|
||||
* C-style \Code{double}
|
||||
* C-style \TText{double}
|
||||
*/
|
||||
#define H5T_NATIVE_DOUBLE (H5OPEN H5T_NATIVE_DOUBLE_g)
|
||||
/**
|
||||
* \ingroup PDTNAT
|
||||
* C-style \Code{long double}
|
||||
* C-style \TText{long double}
|
||||
*/
|
||||
#define H5T_NATIVE_LDOUBLE (H5OPEN H5T_NATIVE_LDOUBLE_g)
|
||||
/**
|
||||
|
||||
+5
-5
@@ -651,7 +651,7 @@ H5_DLL herr_t H5get_libversion(unsigned *majnum, unsigned *minnum, unsigned *rel
|
||||
* example:
|
||||
*
|
||||
* An official HDF5 release is labelled as follows:
|
||||
* HDF5 Release \Code{\<majnum\>.\<minnum\>.\<relnum\>}\n
|
||||
* HDF5 Release \TText{\<majnum\>.\<minnum\>.\<relnum\>}\n
|
||||
* For example, in HDF5 Release 1.8.5:
|
||||
* \li 1 is the major version number, \p majnum.
|
||||
* \li 8 is the minor version number, \p minnum.
|
||||
@@ -835,15 +835,15 @@ H5_DLL void *H5allocate_memory(size_t size, hbool_t clear);
|
||||
* This function is intended to have the semantics of realloc():
|
||||
*
|
||||
* <table>
|
||||
* <tr><td>\Code{H5resize_memory(buffer, size)}</td>
|
||||
* <tr><td>\TText{H5resize_memory(buffer, size)}</td>
|
||||
* <td>Resizes buffer. Returns pointer to resized buffer.</td></tr>
|
||||
* <tr><td>\Code{H5resize_memory(NULL, size)}</td>
|
||||
* <tr><td>\TText{H5resize_memory(NULL, size)}</td>
|
||||
* <td>Allocates memory using HDF5 Library allocator.
|
||||
* Returns pointer to new buffer</td></tr>
|
||||
* <tr><td>\Code{H5resize_memory(buffer, 0)}</td>
|
||||
* <tr><td>\TText{H5resize_memory(buffer, 0)}</td>
|
||||
* <td>Frees memory using HDF5 Library allocator.
|
||||
* Returns NULL.</td></tr>
|
||||
* <tr><td>\Code{H5resize_memory(NULL, 0)}</td>
|
||||
* <tr><td>\TText{H5resize_memory(NULL, 0)}</td>
|
||||
* <td>Returns NULL (undefined in C standard).</td></tr>
|
||||
* </table>
|
||||
*
|
||||
|
||||
Reference in New Issue
Block a user