1 /* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * 2 * Copyright by The HDF Group. * 3 * Copyright by the Board of Trustees of the University of Illinois. * 4 * All rights reserved. * 5 * * 6 * This file is part of HDF5. The full HDF5 copyright notice, including * 7 * terms governing use, modification, and redistribution, is contained in * 8 * the COPYING file, which can be found at the root of the source code * 9 * distribution tree, or in https://support.hdfgroup.org/ftp/HDF5/releases. * 10 * If you do not have access to either file, you may request a copy from * 11 * help@hdfgroup.org. * 12 * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * */ 13 14 /* 15 * This file contains function prototypes for each exported function in the 16 * H5P module. 17 */ 18 #ifndef _H5Ppublic_H 19 #define _H5Ppublic_H 20 21 /* System headers needed by this file */ 22 23 /* Public headers needed by this file */ 24 #include "H5public.h" 25 #include "H5ACpublic.h" 26 #include "H5Dpublic.h" 27 #include "H5Fpublic.h" 28 #include "H5FDpublic.h" 29 #include "H5Ipublic.h" 30 #include "H5Lpublic.h" 31 #include "H5Opublic.h" 32 #include "H5MMpublic.h" 33 #include "H5Tpublic.h" 34 #include "H5Zpublic.h" 35 36 37 /*****************/ 38 /* Public Macros */ 39 /*****************/ 40 41 /* When this header is included from a private HDF5 header, don't make calls to H5open() */ 42 #undef H5OPEN 43 #ifndef _H5private_H 44 #define H5OPEN H5open(), 45 #else /* _H5private_H */ 46 #define H5OPEN 47 #endif /* _H5private_H */ 48 49 /* 50 * The library's property list classes 51 */ 52 53 #define H5P_ROOT (H5OPEN H5P_CLS_ROOT_ID_g) 54 #define H5P_OBJECT_CREATE (H5OPEN H5P_CLS_OBJECT_CREATE_ID_g) 55 #define H5P_FILE_CREATE (H5OPEN H5P_CLS_FILE_CREATE_ID_g) 56 #define H5P_FILE_ACCESS (H5OPEN H5P_CLS_FILE_ACCESS_ID_g) 57 #define H5P_DATASET_CREATE (H5OPEN H5P_CLS_DATASET_CREATE_ID_g) 58 #define H5P_DATASET_ACCESS (H5OPEN H5P_CLS_DATASET_ACCESS_ID_g) 59 #define H5P_DATASET_XFER (H5OPEN H5P_CLS_DATASET_XFER_ID_g) 60 #define H5P_FILE_MOUNT (H5OPEN H5P_CLS_FILE_MOUNT_ID_g) 61 #define H5P_GROUP_CREATE (H5OPEN H5P_CLS_GROUP_CREATE_ID_g) 62 #define H5P_GROUP_ACCESS (H5OPEN H5P_CLS_GROUP_ACCESS_ID_g) 63 #define H5P_DATATYPE_CREATE (H5OPEN H5P_CLS_DATATYPE_CREATE_ID_g) 64 #define H5P_DATATYPE_ACCESS (H5OPEN H5P_CLS_DATATYPE_ACCESS_ID_g) 65 #define H5P_STRING_CREATE (H5OPEN H5P_CLS_STRING_CREATE_ID_g) 66 #define H5P_ATTRIBUTE_CREATE (H5OPEN H5P_CLS_ATTRIBUTE_CREATE_ID_g) 67 #define H5P_ATTRIBUTE_ACCESS (H5OPEN H5P_CLS_ATTRIBUTE_ACCESS_ID_g) 68 #define H5P_OBJECT_COPY (H5OPEN H5P_CLS_OBJECT_COPY_ID_g) 69 #define H5P_LINK_CREATE (H5OPEN H5P_CLS_LINK_CREATE_ID_g) 70 #define H5P_LINK_ACCESS (H5OPEN H5P_CLS_LINK_ACCESS_ID_g) 71 72 /* 73 * The library's default property lists 74 */ 75 #define H5P_FILE_CREATE_DEFAULT (H5OPEN H5P_LST_FILE_CREATE_ID_g) 76 #define H5P_FILE_ACCESS_DEFAULT (H5OPEN H5P_LST_FILE_ACCESS_ID_g) 77 #define H5P_DATASET_CREATE_DEFAULT (H5OPEN H5P_LST_DATASET_CREATE_ID_g) 78 #define H5P_DATASET_ACCESS_DEFAULT (H5OPEN H5P_LST_DATASET_ACCESS_ID_g) 79 #define H5P_DATASET_XFER_DEFAULT (H5OPEN H5P_LST_DATASET_XFER_ID_g) 80 #define H5P_FILE_MOUNT_DEFAULT (H5OPEN H5P_LST_FILE_MOUNT_ID_g) 81 #define H5P_GROUP_CREATE_DEFAULT (H5OPEN H5P_LST_GROUP_CREATE_ID_g) 82 #define H5P_GROUP_ACCESS_DEFAULT (H5OPEN H5P_LST_GROUP_ACCESS_ID_g) 83 #define H5P_DATATYPE_CREATE_DEFAULT (H5OPEN H5P_LST_DATATYPE_CREATE_ID_g) 84 #define H5P_DATATYPE_ACCESS_DEFAULT (H5OPEN H5P_LST_DATATYPE_ACCESS_ID_g) 85 #define H5P_ATTRIBUTE_CREATE_DEFAULT (H5OPEN H5P_LST_ATTRIBUTE_CREATE_ID_g) 86 #define H5P_ATTRIBUTE_ACCESS_DEFAULT (H5OPEN H5P_LST_ATTRIBUTE_ACCESS_ID_g) 87 #define H5P_OBJECT_COPY_DEFAULT (H5OPEN H5P_LST_OBJECT_COPY_ID_g) 88 #define H5P_LINK_CREATE_DEFAULT (H5OPEN H5P_LST_LINK_CREATE_ID_g) 89 #define H5P_LINK_ACCESS_DEFAULT (H5OPEN H5P_LST_LINK_ACCESS_ID_g) 90 91 /* Common creation order flags (for links in groups and attributes on objects) */ 92 #define H5P_CRT_ORDER_TRACKED 0x0001 93 #define H5P_CRT_ORDER_INDEXED 0x0002 94 95 /* Default value for all property list classes */ 96 #define H5P_DEFAULT (hid_t)0 97 98 #ifdef __cplusplus 99 extern "C" { 100 #endif 101 102 /*******************/ 103 /* Public Typedefs */ 104 /*******************/ 105 106 107 /* Define property list class callback function pointer types */ 108 typedef herr_t (*H5P_cls_create_func_t)(hid_t prop_id, void *create_data); 109 typedef herr_t (*H5P_cls_copy_func_t)(hid_t new_prop_id, hid_t old_prop_id, 110 void *copy_data); 111 typedef herr_t (*H5P_cls_close_func_t)(hid_t prop_id, void *close_data); 112 113 /* Define property list callback function pointer types */ 114 typedef herr_t (*H5P_prp_cb1_t)(const char *name, size_t size, void *value); 115 typedef herr_t (*H5P_prp_cb2_t)(hid_t prop_id, const char *name, size_t size, void *value); 116 typedef H5P_prp_cb1_t H5P_prp_create_func_t; 117 typedef H5P_prp_cb2_t H5P_prp_set_func_t; 118 typedef H5P_prp_cb2_t H5P_prp_get_func_t; 119 typedef H5P_prp_cb2_t H5P_prp_delete_func_t; 120 typedef H5P_prp_cb1_t H5P_prp_copy_func_t; 121 typedef int (*H5P_prp_compare_func_t)(const void *value1, const void *value2, size_t size); 122 typedef H5P_prp_cb1_t H5P_prp_close_func_t; 123 124 /* Define property list iteration function type */ 125 typedef herr_t (*H5P_iterate_t)(hid_t id, const char *name, void *iter_data); 126 127 /* Actual IO mode property */ 128 typedef enum H5D_mpio_actual_chunk_opt_mode_t { 129 /* The default value, H5D_MPIO_NO_CHUNK_OPTIMIZATION, is used for all I/O 130 * operations that do not use chunk optimizations, including non-collective 131 * I/O and contiguous collective I/O. 132 */ 133 H5D_MPIO_NO_CHUNK_OPTIMIZATION = 0, 134 H5D_MPIO_LINK_CHUNK, 135 H5D_MPIO_MULTI_CHUNK 136 } H5D_mpio_actual_chunk_opt_mode_t; 137 138 typedef enum H5D_mpio_actual_io_mode_t { 139 /* The following four values are conveniently defined as a bit field so that 140 * we can switch from the default to independent or collective and then to 141 * mixed without having to check the original value. 142 * 143 * NO_COLLECTIVE means that either collective I/O wasn't requested or that 144 * no I/O took place. 145 * 146 * CHUNK_INDEPENDENT means that collective I/O was requested, but the 147 * chunk optimization scheme chose independent I/O for each chunk. 148 */ 149 H5D_MPIO_NO_COLLECTIVE = 0x0, 150 H5D_MPIO_CHUNK_INDEPENDENT = 0x1, 151 H5D_MPIO_CHUNK_COLLECTIVE = 0x2, 152 H5D_MPIO_CHUNK_MIXED = 0x1 | 0x2, 153 154 /* The contiguous case is separate from the bit field. */ 155 H5D_MPIO_CONTIGUOUS_COLLECTIVE = 0x4 156 } H5D_mpio_actual_io_mode_t; 157 158 /* Broken collective IO property */ 159 typedef enum H5D_mpio_no_collective_cause_t { 160 H5D_MPIO_COLLECTIVE = 0x00, 161 H5D_MPIO_SET_INDEPENDENT = 0x01, 162 H5D_MPIO_DATATYPE_CONVERSION = 0x02, 163 H5D_MPIO_DATA_TRANSFORMS = 0x04, 164 H5D_MPIO_MPI_OPT_TYPES_ENV_VAR_DISABLED = 0x08, 165 H5D_MPIO_NOT_SIMPLE_OR_SCALAR_DATASPACES = 0x10, 166 H5D_MPIO_NOT_CONTIGUOUS_OR_CHUNKED_DATASET = 0x20, 167 H5D_MPIO_PARALLEL_FILTERED_WRITES_DISABLED = 0x40, 168 H5D_MPIO_NO_COLLECTIVE_MAX_CAUSE = 0x80 169 } H5D_mpio_no_collective_cause_t; 170 171 /********************/ 172 /* Public Variables */ 173 /********************/ 174 175 /* Property list class IDs */ 176 /* (Internal to library, do not use! Use macros above) */ 177 H5_DLLVAR hid_t H5P_CLS_ROOT_ID_g; 178 H5_DLLVAR hid_t H5P_CLS_OBJECT_CREATE_ID_g; 179 H5_DLLVAR hid_t H5P_CLS_FILE_CREATE_ID_g; 180 H5_DLLVAR hid_t H5P_CLS_FILE_ACCESS_ID_g; 181 H5_DLLVAR hid_t H5P_CLS_DATASET_CREATE_ID_g; 182 H5_DLLVAR hid_t H5P_CLS_DATASET_ACCESS_ID_g; 183 H5_DLLVAR hid_t H5P_CLS_DATASET_XFER_ID_g; 184 H5_DLLVAR hid_t H5P_CLS_FILE_MOUNT_ID_g; 185 H5_DLLVAR hid_t H5P_CLS_GROUP_CREATE_ID_g; 186 H5_DLLVAR hid_t H5P_CLS_GROUP_ACCESS_ID_g; 187 H5_DLLVAR hid_t H5P_CLS_DATATYPE_CREATE_ID_g; 188 H5_DLLVAR hid_t H5P_CLS_DATATYPE_ACCESS_ID_g; 189 H5_DLLVAR hid_t H5P_CLS_STRING_CREATE_ID_g; 190 H5_DLLVAR hid_t H5P_CLS_ATTRIBUTE_CREATE_ID_g; 191 H5_DLLVAR hid_t H5P_CLS_ATTRIBUTE_ACCESS_ID_g; 192 H5_DLLVAR hid_t H5P_CLS_OBJECT_COPY_ID_g; 193 H5_DLLVAR hid_t H5P_CLS_LINK_CREATE_ID_g; 194 H5_DLLVAR hid_t H5P_CLS_LINK_ACCESS_ID_g; 195 196 /* Default roperty list IDs */ 197 /* (Internal to library, do not use! Use macros above) */ 198 H5_DLLVAR hid_t H5P_LST_FILE_CREATE_ID_g; 199 H5_DLLVAR hid_t H5P_LST_FILE_ACCESS_ID_g; 200 H5_DLLVAR hid_t H5P_LST_DATASET_CREATE_ID_g; 201 H5_DLLVAR hid_t H5P_LST_DATASET_ACCESS_ID_g; 202 H5_DLLVAR hid_t H5P_LST_DATASET_XFER_ID_g; 203 H5_DLLVAR hid_t H5P_LST_FILE_MOUNT_ID_g; 204 H5_DLLVAR hid_t H5P_LST_GROUP_CREATE_ID_g; 205 H5_DLLVAR hid_t H5P_LST_GROUP_ACCESS_ID_g; 206 H5_DLLVAR hid_t H5P_LST_DATATYPE_CREATE_ID_g; 207 H5_DLLVAR hid_t H5P_LST_DATATYPE_ACCESS_ID_g; 208 H5_DLLVAR hid_t H5P_LST_ATTRIBUTE_CREATE_ID_g; 209 H5_DLLVAR hid_t H5P_LST_ATTRIBUTE_ACCESS_ID_g; 210 H5_DLLVAR hid_t H5P_LST_OBJECT_COPY_ID_g; 211 H5_DLLVAR hid_t H5P_LST_LINK_CREATE_ID_g; 212 H5_DLLVAR hid_t H5P_LST_LINK_ACCESS_ID_g; 213 214 /*********************/ 215 /* Public Prototypes */ 216 /*********************/ 217 218 /* Generic property list routines */ 219 H5_DLL hid_t H5Pcreate_class(hid_t parent, const char *name, 220 H5P_cls_create_func_t cls_create, void *create_data, 221 H5P_cls_copy_func_t cls_copy, void *copy_data, 222 H5P_cls_close_func_t cls_close, void *close_data); 223 H5_DLL char *H5Pget_class_name(hid_t pclass_id); 224 H5_DLL hid_t H5Pcreate(hid_t cls_id); 225 H5_DLL herr_t H5Pregister2(hid_t cls_id, const char *name, size_t size, 226 void *def_value, H5P_prp_create_func_t prp_create, 227 H5P_prp_set_func_t prp_set, H5P_prp_get_func_t prp_get, 228 H5P_prp_delete_func_t prp_del, H5P_prp_copy_func_t prp_copy, 229 H5P_prp_compare_func_t prp_cmp, H5P_prp_close_func_t prp_close); 230 H5_DLL herr_t H5Pinsert2(hid_t plist_id, const char *name, size_t size, 231 void *value, H5P_prp_set_func_t prp_set, H5P_prp_get_func_t prp_get, 232 H5P_prp_delete_func_t prp_delete, H5P_prp_copy_func_t prp_copy, 233 H5P_prp_compare_func_t prp_cmp, H5P_prp_close_func_t prp_close); 234 H5_DLL herr_t H5Pset(hid_t plist_id, const char *name, const void *value); 235 H5_DLL htri_t H5Pexist(hid_t plist_id, const char *name); 236 H5_DLL herr_t H5Pencode(hid_t plist_id, void *buf, size_t *nalloc); 237 H5_DLL hid_t H5Pdecode(const void *buf); 238 H5_DLL herr_t H5Pget_size(hid_t id, const char *name, size_t *size); 239 H5_DLL herr_t H5Pget_nprops(hid_t id, size_t *nprops); 240 H5_DLL hid_t H5Pget_class(hid_t plist_id); 241 H5_DLL hid_t H5Pget_class_parent(hid_t pclass_id); 242 H5_DLL herr_t H5Pget(hid_t plist_id, const char *name, void * value); 243 H5_DLL htri_t H5Pequal(hid_t id1, hid_t id2); 244 H5_DLL htri_t H5Pisa_class(hid_t plist_id, hid_t pclass_id); 245 H5_DLL int H5Piterate(hid_t id, int *idx, H5P_iterate_t iter_func, 246 void *iter_data); 247 H5_DLL herr_t H5Pcopy_prop(hid_t dst_id, hid_t src_id, const char *name); 248 H5_DLL herr_t H5Premove(hid_t plist_id, const char *name); 249 H5_DLL herr_t H5Punregister(hid_t pclass_id, const char *name); 250 H5_DLL herr_t H5Pclose_class(hid_t plist_id); 251 H5_DLL herr_t H5Pclose(hid_t plist_id); 252 H5_DLL hid_t H5Pcopy(hid_t plist_id); 253 254 /* Object creation property list (OCPL) routines */ 255 H5_DLL herr_t H5Pset_attr_phase_change(hid_t plist_id, unsigned max_compact, unsigned min_dense); 256 H5_DLL herr_t H5Pget_attr_phase_change(hid_t plist_id, unsigned *max_compact, unsigned *min_dense); 257 H5_DLL herr_t H5Pset_attr_creation_order(hid_t plist_id, unsigned crt_order_flags); 258 H5_DLL herr_t H5Pget_attr_creation_order(hid_t plist_id, unsigned *crt_order_flags); 259 H5_DLL herr_t H5Pset_obj_track_times(hid_t plist_id, hbool_t track_times); 260 H5_DLL herr_t H5Pget_obj_track_times(hid_t plist_id, hbool_t *track_times); 261 H5_DLL herr_t H5Pmodify_filter(hid_t plist_id, H5Z_filter_t filter, 262 unsigned int flags, size_t cd_nelmts, 263 const unsigned int cd_values[/*cd_nelmts*/]); 264 H5_DLL herr_t H5Pset_filter(hid_t plist_id, H5Z_filter_t filter, 265 unsigned int flags, size_t cd_nelmts, 266 const unsigned int c_values[]); 267 H5_DLL int H5Pget_nfilters(hid_t plist_id); 268 H5_DLL H5Z_filter_t H5Pget_filter2(hid_t plist_id, unsigned filter, 269 unsigned int *flags/*out*/, 270 size_t *cd_nelmts/*out*/, 271 unsigned cd_values[]/*out*/, 272 size_t namelen, char name[], 273 unsigned *filter_config /*out*/); 274 H5_DLL herr_t H5Pget_filter_by_id2(hid_t plist_id, H5Z_filter_t id, 275 unsigned int *flags/*out*/, size_t *cd_nelmts/*out*/, 276 unsigned cd_values[]/*out*/, size_t namelen, char name[]/*out*/, 277 unsigned *filter_config/*out*/); 278 H5_DLL htri_t H5Pall_filters_avail(hid_t plist_id); 279 H5_DLL herr_t H5Premove_filter(hid_t plist_id, H5Z_filter_t filter); 280 H5_DLL herr_t H5Pset_deflate(hid_t plist_id, unsigned aggression); 281 H5_DLL herr_t H5Pset_fletcher32(hid_t plist_id); 282 283 /* File creation property list (FCPL) routines */ 284 H5_DLL herr_t H5Pset_userblock(hid_t plist_id, hsize_t size); 285 H5_DLL herr_t H5Pget_userblock(hid_t plist_id, hsize_t *size); 286 H5_DLL herr_t H5Pset_sizes(hid_t plist_id, size_t sizeof_addr, 287 size_t sizeof_size); 288 H5_DLL herr_t H5Pget_sizes(hid_t plist_id, size_t *sizeof_addr/*out*/, 289 size_t *sizeof_size/*out*/); 290 H5_DLL herr_t H5Pset_sym_k(hid_t plist_id, unsigned ik, unsigned lk); 291 H5_DLL herr_t H5Pget_sym_k(hid_t plist_id, unsigned *ik/*out*/, unsigned *lk/*out*/); 292 H5_DLL herr_t H5Pset_istore_k(hid_t plist_id, unsigned ik); 293 H5_DLL herr_t H5Pget_istore_k(hid_t plist_id, unsigned *ik/*out*/); 294 H5_DLL herr_t H5Pset_shared_mesg_nindexes(hid_t plist_id, unsigned nindexes); 295 H5_DLL herr_t H5Pget_shared_mesg_nindexes(hid_t plist_id, unsigned *nindexes); 296 H5_DLL herr_t H5Pset_shared_mesg_index(hid_t plist_id, unsigned index_num, unsigned mesg_type_flags, unsigned min_mesg_size); 297 H5_DLL herr_t H5Pget_shared_mesg_index(hid_t plist_id, unsigned index_num, unsigned *mesg_type_flags, unsigned *min_mesg_size); 298 H5_DLL herr_t H5Pset_shared_mesg_phase_change(hid_t plist_id, unsigned max_list, unsigned min_btree); 299 H5_DLL herr_t H5Pget_shared_mesg_phase_change(hid_t plist_id, unsigned *max_list, unsigned *min_btree); 300 H5_DLL herr_t H5Pset_file_space_strategy(hid_t plist_id, H5F_fspace_strategy_t strategy, hbool_t persist, hsize_t threshold); 301 H5_DLL herr_t H5Pget_file_space_strategy(hid_t plist_id, H5F_fspace_strategy_t *strategy, hbool_t *persist, hsize_t *threshold); 302 H5_DLL herr_t H5Pset_file_space_page_size(hid_t plist_id, hsize_t fsp_size); 303 H5_DLL herr_t H5Pget_file_space_page_size(hid_t plist_id, hsize_t *fsp_size); 304 305 /* File access property list (FAPL) routines */ 306 H5_DLL herr_t H5Pset_alignment(hid_t fapl_id, hsize_t threshold, 307 hsize_t alignment); 308 H5_DLL herr_t H5Pget_alignment(hid_t fapl_id, hsize_t *threshold/*out*/, 309 hsize_t *alignment/*out*/); 310 H5_DLL herr_t H5Pset_driver(hid_t plist_id, hid_t driver_id, 311 const void *driver_info); 312 H5_DLL hid_t H5Pget_driver(hid_t plist_id); 313 H5_DLL const void *H5Pget_driver_info(hid_t plist_id); 314 H5_DLL herr_t H5Pset_family_offset(hid_t fapl_id, hsize_t offset); 315 H5_DLL herr_t H5Pget_family_offset(hid_t fapl_id, hsize_t *offset); 316 H5_DLL herr_t H5Pset_multi_type(hid_t fapl_id, H5FD_mem_t type); 317 H5_DLL herr_t H5Pget_multi_type(hid_t fapl_id, H5FD_mem_t *type); 318 H5_DLL herr_t H5Pset_cache(hid_t plist_id, int mdc_nelmts, 319 size_t rdcc_nslots, size_t rdcc_nbytes, 320 double rdcc_w0); 321 H5_DLL herr_t H5Pget_cache(hid_t plist_id, 322 int *mdc_nelmts, /* out */ 323 size_t *rdcc_nslots/*out*/, 324 size_t *rdcc_nbytes/*out*/, double *rdcc_w0); 325 H5_DLL herr_t H5Pset_mdc_config(hid_t plist_id, 326 H5AC_cache_config_t * config_ptr); 327 H5_DLL herr_t H5Pget_mdc_config(hid_t plist_id, 328 H5AC_cache_config_t * config_ptr); /* out */ 329 H5_DLL herr_t H5Pset_gc_references(hid_t fapl_id, unsigned gc_ref); 330 H5_DLL herr_t H5Pget_gc_references(hid_t fapl_id, unsigned *gc_ref/*out*/); 331 H5_DLL herr_t H5Pset_fclose_degree(hid_t fapl_id, H5F_close_degree_t degree); 332 H5_DLL herr_t H5Pget_fclose_degree(hid_t fapl_id, H5F_close_degree_t *degree); 333 H5_DLL herr_t H5Pset_meta_block_size(hid_t fapl_id, hsize_t size); 334 H5_DLL herr_t H5Pget_meta_block_size(hid_t fapl_id, hsize_t *size/*out*/); 335 H5_DLL herr_t H5Pset_sieve_buf_size(hid_t fapl_id, size_t size); 336 H5_DLL herr_t H5Pget_sieve_buf_size(hid_t fapl_id, size_t *size/*out*/); 337 H5_DLL herr_t H5Pset_small_data_block_size(hid_t fapl_id, hsize_t size); 338 H5_DLL herr_t H5Pget_small_data_block_size(hid_t fapl_id, hsize_t *size/*out*/); 339 H5_DLL herr_t H5Pset_libver_bounds(hid_t plist_id, H5F_libver_t low, 340 H5F_libver_t high); 341 H5_DLL herr_t H5Pget_libver_bounds(hid_t plist_id, H5F_libver_t *low, 342 H5F_libver_t *high); 343 H5_DLL herr_t H5Pset_elink_file_cache_size(hid_t plist_id, unsigned efc_size); 344 H5_DLL herr_t H5Pget_elink_file_cache_size(hid_t plist_id, unsigned *efc_size); 345 H5_DLL herr_t H5Pset_file_image(hid_t fapl_id, void *buf_ptr, size_t buf_len); 346 H5_DLL herr_t H5Pget_file_image(hid_t fapl_id, void **buf_ptr_ptr, size_t *buf_len_ptr); 347 H5_DLL herr_t H5Pset_file_image_callbacks(hid_t fapl_id, 348 H5FD_file_image_callbacks_t *callbacks_ptr); 349 H5_DLL herr_t H5Pget_file_image_callbacks(hid_t fapl_id, 350 H5FD_file_image_callbacks_t *callbacks_ptr); 351 H5_DLL herr_t H5Pset_core_write_tracking(hid_t fapl_id, hbool_t is_enabled, size_t page_size); 352 H5_DLL herr_t H5Pget_core_write_tracking(hid_t fapl_id, hbool_t *is_enabled, size_t *page_size); 353 H5_DLL herr_t H5Pset_metadata_read_attempts(hid_t plist_id, unsigned attempts); 354 H5_DLL herr_t H5Pget_metadata_read_attempts(hid_t plist_id, unsigned *attempts); 355 H5_DLL herr_t H5Pset_object_flush_cb(hid_t plist_id, H5F_flush_cb_t func, void *udata); 356 H5_DLL herr_t H5Pget_object_flush_cb(hid_t plist_id, H5F_flush_cb_t *func, void **udata); 357 H5_DLL herr_t H5Pset_mdc_log_options(hid_t plist_id, hbool_t is_enabled, const char *location, hbool_t start_on_access); 358 H5_DLL herr_t H5Pget_mdc_log_options(hid_t plist_id, hbool_t *is_enabled, char *location, size_t *location_size, hbool_t *start_on_access); 359 H5_DLL herr_t H5Pset_evict_on_close(hid_t fapl_id, hbool_t evict_on_close); 360 H5_DLL herr_t H5Pget_evict_on_close(hid_t fapl_id, hbool_t *evict_on_close); 361 #ifdef H5_HAVE_PARALLEL 362 H5_DLL herr_t H5Pset_all_coll_metadata_ops(hid_t plist_id, hbool_t is_collective); 363 H5_DLL herr_t H5Pget_all_coll_metadata_ops(hid_t plist_id, hbool_t *is_collective); 364 H5_DLL herr_t H5Pset_coll_metadata_write(hid_t plist_id, hbool_t is_collective); 365 H5_DLL herr_t H5Pget_coll_metadata_write(hid_t plist_id, hbool_t *is_collective); 366 #endif /* H5_HAVE_PARALLEL */ 367 H5_DLL herr_t H5Pset_mdc_image_config(hid_t plist_id, H5AC_cache_image_config_t *config_ptr); 368 H5_DLL herr_t H5Pget_mdc_image_config(hid_t plist_id, H5AC_cache_image_config_t *config_ptr /*out*/); 369 H5_DLL herr_t H5Pset_page_buffer_size(hid_t plist_id, size_t buf_size, unsigned min_meta_per, unsigned min_raw_per); 370 H5_DLL herr_t H5Pget_page_buffer_size(hid_t plist_id, size_t *buf_size, unsigned *min_meta_per, unsigned *min_raw_per); 371 372 /* Dataset creation property list (DCPL) routines */ 373 H5_DLL herr_t H5Pset_layout(hid_t plist_id, H5D_layout_t layout); 374 H5_DLL H5D_layout_t H5Pget_layout(hid_t plist_id); 375 H5_DLL herr_t H5Pset_chunk(hid_t plist_id, int ndims, const hsize_t dim[/*ndims*/]); 376 H5_DLL int H5Pget_chunk(hid_t plist_id, int max_ndims, hsize_t dim[]/*out*/); 377 H5_DLL herr_t H5Pset_virtual(hid_t dcpl_id, hid_t vspace_id, 378 const char *src_file_name, const char *src_dset_name, hid_t src_space_id); 379 H5_DLL herr_t H5Pget_virtual_count(hid_t dcpl_id, size_t *count/*out*/); 380 H5_DLL hid_t H5Pget_virtual_vspace(hid_t dcpl_id, size_t index); 381 H5_DLL hid_t H5Pget_virtual_srcspace(hid_t dcpl_id, size_t index); 382 H5_DLL ssize_t H5Pget_virtual_filename(hid_t dcpl_id, size_t index, 383 char *name/*out*/, size_t size); 384 H5_DLL ssize_t H5Pget_virtual_dsetname(hid_t dcpl_id, size_t index, 385 char *name/*out*/, size_t size); 386 H5_DLL herr_t H5Pset_external(hid_t plist_id, const char *name, off_t offset, 387 hsize_t size); 388 H5_DLL herr_t H5Pset_chunk_opts(hid_t plist_id, unsigned opts); 389 H5_DLL herr_t H5Pget_chunk_opts(hid_t plist_id, unsigned *opts); 390 H5_DLL int H5Pget_external_count(hid_t plist_id); 391 H5_DLL herr_t H5Pget_external(hid_t plist_id, unsigned idx, size_t name_size, 392 char *name/*out*/, off_t *offset/*out*/, 393 hsize_t *size/*out*/); 394 H5_DLL herr_t H5Pset_szip(hid_t plist_id, unsigned options_mask, unsigned pixels_per_block); 395 H5_DLL herr_t H5Pset_shuffle(hid_t plist_id); 396 H5_DLL herr_t H5Pset_nbit(hid_t plist_id); 397 H5_DLL herr_t H5Pset_scaleoffset(hid_t plist_id, H5Z_SO_scale_type_t scale_type, int scale_factor); 398 H5_DLL herr_t H5Pset_fill_value(hid_t plist_id, hid_t type_id, 399 const void *value); 400 H5_DLL herr_t H5Pget_fill_value(hid_t plist_id, hid_t type_id, 401 void *value/*out*/); 402 H5_DLL herr_t H5Pfill_value_defined(hid_t plist, H5D_fill_value_t *status); 403 H5_DLL herr_t H5Pset_alloc_time(hid_t plist_id, H5D_alloc_time_t 404 alloc_time); 405 H5_DLL herr_t H5Pget_alloc_time(hid_t plist_id, H5D_alloc_time_t 406 *alloc_time/*out*/); 407 H5_DLL herr_t H5Pset_fill_time(hid_t plist_id, H5D_fill_time_t fill_time); 408 H5_DLL herr_t H5Pget_fill_time(hid_t plist_id, H5D_fill_time_t 409 *fill_time/*out*/); 410 411 /* Dataset access property list (DAPL) routines */ 412 H5_DLL herr_t H5Pset_chunk_cache(hid_t dapl_id, size_t rdcc_nslots, 413 size_t rdcc_nbytes, double rdcc_w0); 414 H5_DLL herr_t H5Pget_chunk_cache(hid_t dapl_id, 415 size_t *rdcc_nslots/*out*/, 416 size_t *rdcc_nbytes/*out*/, 417 double *rdcc_w0/*out*/); 418 H5_DLL herr_t H5Pset_virtual_view(hid_t plist_id, H5D_vds_view_t view); 419 H5_DLL herr_t H5Pget_virtual_view(hid_t plist_id, H5D_vds_view_t *view); 420 H5_DLL herr_t H5Pset_virtual_printf_gap(hid_t plist_id, hsize_t gap_size); 421 H5_DLL herr_t H5Pget_virtual_printf_gap(hid_t plist_id, hsize_t *gap_size); 422 H5_DLL herr_t H5Pset_virtual_prefix(hid_t dapl_id, const char* prefix); 423 H5_DLL ssize_t H5Pget_virtual_prefix(hid_t dapl_id, char* prefix /*out*/, size_t size); 424 H5_DLL herr_t H5Pset_append_flush(hid_t plist_id, unsigned ndims, 425 const hsize_t boundary[], H5D_append_cb_t func, void *udata); 426 H5_DLL herr_t H5Pget_append_flush(hid_t plist_id, unsigned dims, 427 hsize_t boundary[], H5D_append_cb_t *func, void **udata); 428 H5_DLL herr_t H5Pset_efile_prefix(hid_t dapl_id, const char* prefix); 429 H5_DLL ssize_t H5Pget_efile_prefix(hid_t dapl_id, char* prefix /*out*/, size_t size); 430 431 /* Dataset xfer property list (DXPL) routines */ 432 H5_DLL herr_t H5Pset_data_transform(hid_t plist_id, const char* expression); 433 H5_DLL ssize_t H5Pget_data_transform(hid_t plist_id, char* expression /*out*/, size_t size); 434 H5_DLL herr_t H5Pset_buffer(hid_t plist_id, size_t size, void *tconv, 435 void *bkg); 436 H5_DLL size_t H5Pget_buffer(hid_t plist_id, void **tconv/*out*/, 437 void **bkg/*out*/); 438 H5_DLL herr_t H5Pset_preserve(hid_t plist_id, hbool_t status); 439 H5_DLL int H5Pget_preserve(hid_t plist_id); 440 H5_DLL herr_t H5Pset_edc_check(hid_t plist_id, H5Z_EDC_t check); 441 H5_DLL H5Z_EDC_t H5Pget_edc_check(hid_t plist_id); 442 H5_DLL herr_t H5Pset_filter_callback(hid_t plist_id, H5Z_filter_func_t func, 443 void* op_data); 444 H5_DLL herr_t H5Pset_btree_ratios(hid_t plist_id, double left, double middle, 445 double right); 446 H5_DLL herr_t H5Pget_btree_ratios(hid_t plist_id, double *left/*out*/, 447 double *middle/*out*/, 448 double *right/*out*/); 449 H5_DLL herr_t H5Pset_vlen_mem_manager(hid_t plist_id, 450 H5MM_allocate_t alloc_func, 451 void *alloc_info, H5MM_free_t free_func, 452 void *free_info); 453 H5_DLL herr_t H5Pget_vlen_mem_manager(hid_t plist_id, 454 H5MM_allocate_t *alloc_func, 455 void **alloc_info, 456 H5MM_free_t *free_func, 457 void **free_info); 458 H5_DLL herr_t H5Pset_hyper_vector_size(hid_t fapl_id, size_t size); 459 H5_DLL herr_t H5Pget_hyper_vector_size(hid_t fapl_id, size_t *size/*out*/); 460 H5_DLL herr_t H5Pset_type_conv_cb(hid_t dxpl_id, H5T_conv_except_func_t op, void* operate_data); 461 H5_DLL herr_t H5Pget_type_conv_cb(hid_t dxpl_id, H5T_conv_except_func_t *op, void** operate_data); 462 #ifdef H5_HAVE_PARALLEL 463 H5_DLL herr_t H5Pget_mpio_actual_chunk_opt_mode(hid_t plist_id, H5D_mpio_actual_chunk_opt_mode_t *actual_chunk_opt_mode); 464 H5_DLL herr_t H5Pget_mpio_actual_io_mode(hid_t plist_id, H5D_mpio_actual_io_mode_t *actual_io_mode); 465 H5_DLL herr_t H5Pget_mpio_no_collective_cause(hid_t plist_id, uint32_t *local_no_collective_cause, uint32_t *global_no_collective_cause); 466 #endif /* H5_HAVE_PARALLEL */ 467 468 /* Link creation property list (LCPL) routines */ 469 H5_DLL herr_t H5Pset_create_intermediate_group(hid_t plist_id, unsigned crt_intmd); 470 H5_DLL herr_t H5Pget_create_intermediate_group(hid_t plist_id, unsigned *crt_intmd /*out*/); 471 472 /* Group creation property list (GCPL) routines */ 473 H5_DLL herr_t H5Pset_local_heap_size_hint(hid_t plist_id, size_t size_hint); 474 H5_DLL herr_t H5Pget_local_heap_size_hint(hid_t plist_id, size_t *size_hint /*out*/); 475 H5_DLL herr_t H5Pset_link_phase_change(hid_t plist_id, unsigned max_compact, unsigned min_dense); 476 H5_DLL herr_t H5Pget_link_phase_change(hid_t plist_id, unsigned *max_compact /*out*/, unsigned *min_dense /*out*/); 477 H5_DLL herr_t H5Pset_est_link_info(hid_t plist_id, unsigned est_num_entries, unsigned est_name_len); 478 H5_DLL herr_t H5Pget_est_link_info(hid_t plist_id, unsigned *est_num_entries /* out */, unsigned *est_name_len /* out */); 479 H5_DLL herr_t H5Pset_link_creation_order(hid_t plist_id, unsigned crt_order_flags); 480 H5_DLL herr_t H5Pget_link_creation_order(hid_t plist_id, unsigned *crt_order_flags /* out */); 481 482 /* String creation property list (STRCPL) routines */ 483 H5_DLL herr_t H5Pset_char_encoding(hid_t plist_id, H5T_cset_t encoding); 484 H5_DLL herr_t H5Pget_char_encoding(hid_t plist_id, H5T_cset_t *encoding /*out*/); 485 486 /* Link access property list (LAPL) routines */ 487 H5_DLL herr_t H5Pset_nlinks(hid_t plist_id, size_t nlinks); 488 H5_DLL herr_t H5Pget_nlinks(hid_t plist_id, size_t *nlinks); 489 H5_DLL herr_t H5Pset_elink_prefix(hid_t plist_id, const char *prefix); 490 H5_DLL ssize_t H5Pget_elink_prefix(hid_t plist_id, char *prefix, size_t size); 491 H5_DLL hid_t H5Pget_elink_fapl(hid_t lapl_id); 492 H5_DLL herr_t H5Pset_elink_fapl(hid_t lapl_id, hid_t fapl_id); 493 H5_DLL herr_t H5Pset_elink_acc_flags(hid_t lapl_id, unsigned flags); 494 H5_DLL herr_t H5Pget_elink_acc_flags(hid_t lapl_id, unsigned *flags); 495 H5_DLL herr_t H5Pset_elink_cb(hid_t lapl_id, H5L_elink_traverse_t func, void *op_data); 496 H5_DLL herr_t H5Pget_elink_cb(hid_t lapl_id, H5L_elink_traverse_t *func, void **op_data); 497 498 /* Object copy property list (OCPYPL) routines */ 499 H5_DLL herr_t H5Pset_copy_object(hid_t plist_id, unsigned crt_intmd); 500 H5_DLL herr_t H5Pget_copy_object(hid_t plist_id, unsigned *crt_intmd /*out*/); 501 H5_DLL herr_t H5Padd_merge_committed_dtype_path(hid_t plist_id, const char *path); 502 H5_DLL herr_t H5Pfree_merge_committed_dtype_paths(hid_t plist_id); 503 H5_DLL herr_t H5Pset_mcdt_search_cb(hid_t plist_id, H5O_mcdt_search_cb_t func, void *op_data); 504 H5_DLL herr_t H5Pget_mcdt_search_cb(hid_t plist_id, H5O_mcdt_search_cb_t *func, void **op_data); 505 506 /* Symbols defined for compatibility with previous versions of the HDF5 API. 507 * 508 * Use of these symbols is deprecated. 509 */ 510 #ifndef H5_NO_DEPRECATED_SYMBOLS 511 512 /* Macros */ 513 514 /* We renamed the "root" of the property list class hierarchy */ 515 #define H5P_NO_CLASS H5P_ROOT 516 517 518 /* Typedefs */ 519 520 521 /* Function prototypes */ 522 H5_DLL herr_t H5Pregister1(hid_t cls_id, const char *name, size_t size, 523 void *def_value, H5P_prp_create_func_t prp_create, 524 H5P_prp_set_func_t prp_set, H5P_prp_get_func_t prp_get, 525 H5P_prp_delete_func_t prp_del, H5P_prp_copy_func_t prp_copy, 526 H5P_prp_close_func_t prp_close); 527 H5_DLL herr_t H5Pinsert1(hid_t plist_id, const char *name, size_t size, 528 void *value, H5P_prp_set_func_t prp_set, H5P_prp_get_func_t prp_get, 529 H5P_prp_delete_func_t prp_delete, H5P_prp_copy_func_t prp_copy, 530 H5P_prp_close_func_t prp_close); 531 H5_DLL H5Z_filter_t H5Pget_filter1(hid_t plist_id, unsigned filter, 532 unsigned int *flags/*out*/, size_t *cd_nelmts/*out*/, 533 unsigned cd_values[]/*out*/, size_t namelen, char name[]); 534 H5_DLL herr_t H5Pget_filter_by_id1(hid_t plist_id, H5Z_filter_t id, 535 unsigned int *flags/*out*/, size_t *cd_nelmts/*out*/, 536 unsigned cd_values[]/*out*/, size_t namelen, char name[]/*out*/); 537 H5_DLL herr_t H5Pget_version(hid_t plist_id, unsigned *boot/*out*/, 538 unsigned *freelist/*out*/, unsigned *stab/*out*/, 539 unsigned *shhdr/*out*/); 540 H5_DLL herr_t H5Pset_file_space(hid_t plist_id, H5F_file_space_type_t strategy, hsize_t threshold); 541 H5_DLL herr_t H5Pget_file_space(hid_t plist_id, H5F_file_space_type_t *strategy, hsize_t *threshold); 542 #endif /* H5_NO_DEPRECATED_SYMBOLS */ 543 544 #ifdef __cplusplus 545 } 546 #endif 547 #endif /* _H5Ppublic_H */ 548 549