herr_t H5Pget_mdc_image_config(
hid_t plist_id,
H5AC_cache_image_config_t * config_ptr);
H5Pget_mdc_image_config
retrieves the metadata cache image values into config_ptr
for the file access property list specified in plist_id.
H5AC_cache_image_config_t is defined as follows:
typedef struct H5AC_cache_image_config_t {
int32_t version;
hbool_t generate_image;
hbool_t save_resize_status;
int32_t entry_ageout;
} H5AC_cache_image_config_t;
Where the fields of the instance of H5AC_cache_image_config_t
passed into the function will be set as follows:
version: |
|
Must be set to H5AC__CURR_CACHE_IMAGE_CONFIG_VERSION prior to the call to H5Pget_mdc_image_config().
|
generate_image: |
|
Will be set to either TRUE or FALSE, depending on whether a cache image will be requested.
|
save_resize_status: |
|
Will be set to either TRUE or FALSE, depending on whether inclusion of the metadata cache
resize configuration is to be included in the cache image. Note that this field is not supported at present.
|
entry_ageout: |
|
Will be set to an integer in the range of -1 to 100. Non negative values
indicate the number of close/open cycles a metadata cache can remain in the cache image without being accessed. -1
indicates no limit on the number of such cycles. Note: this field is not supported at present -- thus in effect it is always
set to -1.
|
hid_t
plist_id |
|
IN: File access property list identifier |
H5AC_cache_image_config_t * config_ptr |
|
OUT: Pointer to metadata cache image configuration values
|
| Release | Change |
| 1.10.1 | C function introduced with this release. |