mirror/hdf5
2
0
Fork 0
mirror of https://github.com/HDFGroup/hdf5.git synced 2024-12-27 08:01:04 +08:00
Code Issues Packages Projects Releases Wiki Activity

Document that fileno is same for all handles (#3963)

Browse Source
This commit is contained in:
mattjala 2024-01-26 14:30:12 -06:00 committed by GitHub
parent a1d3e486e6
commit 1bea9e6100
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194
2 changed files with 19 additions and 10 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

7
src/H5Fpublic.h
View File

@ -741,6 +741,13 @@ H5_DLL herr_t H5Fget_intent(hid_t file_id, unsigned *intent);
* file identifier \p file_id and the pointer \p fnumber to the file * file identifier \p file_id and the pointer \p fnumber to the file
* number. * number.
* *
* This file number is the same for all open instances of the same
* file, as long as 1. The active VFD implements the file comparison operator,
* and 2. The current filesystem is able to determine if the same file is opened more
* than once. If these conditions are not met, it is the application's
* responsibility to avoid opening multiple handles into the same file,
* which results in undefined behavior.
*
* \since 1.12.0 * \since 1.12.0
* *
*/ */

22
src/H5Opublic.h
View File

@ -143,15 +143,16 @@ typedef struct H5O_hdr_info_t {
* (For H5Oget_info(), H5Oget_info_by_name(), H5Oget_info_by_idx() version 3) * (For H5Oget_info(), H5Oget_info_by_name(), H5Oget_info_by_idx() version 3)
*/ */
typedef struct H5O_info2_t { typedef struct H5O_info2_t {
unsigned long fileno; /**< File number that object is located in */ unsigned long
H5O_token_t token; /**< Token representing the object */ fileno; /**< File number that object is located in. Constant across multiple opens of the same file */
H5O_type_t type; /**< Basic object type (group, dataset, etc.) */ H5O_token_t token; /**< Token representing the object */
unsigned rc; /**< Reference count of object */ H5O_type_t type; /**< Basic object type (group, dataset, etc.) */
time_t atime; /**< Access time */ unsigned rc; /**< Reference count of object */
time_t mtime; /**< Modification time */ time_t atime; /**< Access time */
time_t ctime; /**< Change time */ time_t mtime; /**< Modification time */
time_t btime; /**< Birth time */ time_t ctime; /**< Change time */
hsize_t num_attrs; /**< Number of attributes attached to object */ time_t btime; /**< Birth time */
hsize_t num_attrs; /**< Number of attributes attached to object */
} H5O_info2_t; } H5O_info2_t;
//! <!-- [H5O_info2_t_snip] --> //! <!-- [H5O_info2_t_snip] -->
@ -1717,7 +1718,8 @@ typedef struct H5O_stat_t {
* H5Oget_info_by_idx() versions 1 & 2.) * H5Oget_info_by_idx() versions 1 & 2.)
*/ */
typedef struct H5O_info1_t { typedef struct H5O_info1_t {
unsigned long fileno; /**< File number that object is located in */ unsigned long
fileno; /**< File number that object is located in. Constant across multiple opens of the same file */
haddr_t addr; /**< Object address in file */ haddr_t addr; /**< Object address in file */
H5O_type_t type; /**< Basic object type (group, dataset, etc.) */ H5O_type_t type; /**< Basic object type (group, dataset, etc.) */
unsigned rc; /**< Reference count of object */ unsigned rc; /**< Reference count of object */