1998-02-26 03:13:49 +08:00
|
|
|
/****************************************************************************
|
|
|
|
* NCSA HDF *
|
|
|
|
* Software Development Group *
|
|
|
|
* National Center for Supercomputing Applications *
|
|
|
|
* University of Illinois at Urbana-Champaign *
|
|
|
|
* 605 E. Springfield, Champaign IL 61820 *
|
|
|
|
* *
|
|
|
|
* For conditions of distribution and use, see the accompanying *
|
|
|
|
* hdf/COPYING file. *
|
|
|
|
* *
|
|
|
|
****************************************************************************/
|
|
|
|
|
|
|
|
/*
|
|
|
|
* This file contains function prototypes for each exported function in the
|
|
|
|
* H5P module.
|
|
|
|
*/
|
|
|
|
#ifndef _H5Ppublic_H
|
|
|
|
#define _H5Ppublic_H
|
|
|
|
|
|
|
|
/* Default Template for creation, access, etc. templates */
|
2000-11-29 00:18:42 +08:00
|
|
|
#define H5P_DEFAULT 0
|
1998-02-26 03:13:49 +08:00
|
|
|
|
|
|
|
/* Public headers needed by this file */
|
2001-04-06 01:29:14 +08:00
|
|
|
#include "H5public.h"
|
|
|
|
#include "H5Ipublic.h"
|
|
|
|
#include "H5Dpublic.h"
|
|
|
|
#include "H5Fpublic.h"
|
|
|
|
#include "H5MMpublic.h"
|
|
|
|
#include "H5Zpublic.h"
|
1998-02-26 03:13:49 +08:00
|
|
|
|
2001-07-03 22:49:03 +08:00
|
|
|
/* Metroworks <sys/types.h> doesn't define off_t. */
|
|
|
|
#ifdef __MWERKS__
|
|
|
|
typedef long off_t;
|
|
|
|
/* Metroworks does not define EINTR in <errno.h> */
|
|
|
|
# define EINTR 4
|
|
|
|
#endif
|
|
|
|
/*__MWERKS__*/
|
|
|
|
|
1998-10-09 01:13:14 +08:00
|
|
|
/* Property list classes */
|
2001-09-27 04:29:35 +08:00
|
|
|
typedef enum H5P_class_t_old {
|
|
|
|
H5P_NO_CLASS_OLD = -1, /*error return value */
|
2001-10-25 02:02:27 +08:00
|
|
|
H5P_MOUNT_OLD = 0, /*file mounting properties */
|
2001-09-27 04:29:35 +08:00
|
|
|
H5P_NCLASSES_OLD /*this must be last! */
|
|
|
|
} H5P_class_t_old;
|
|
|
|
|
|
|
|
/* This typedef should go in the v1.4 compat section when all the internal */
|
|
|
|
/* property lists are switched to generic property lists - QAK */
|
|
|
|
typedef hid_t H5P_class_t; /* Alias H5P_class_t to hid_t */
|
|
|
|
/* hid_t aliases for old H5P_class_t enum values */
|
|
|
|
/* These go away as each old-style property list is converted to a generic */
|
|
|
|
/* property list -QAK */
|
|
|
|
/* Also - merge/delete H5Pcreate and H5Pcreate_list */
|
|
|
|
/* - merge/delete H5Pget_class and H5Pget_class_new */
|
|
|
|
/* - merge/delete H5Pcopy and H5Pcopy_new */
|
|
|
|
/* - merge/delete H5Pclose and H5Pclose_list */
|
|
|
|
__DLLVAR__ hid_t H5P_NO_CLASS;
|
|
|
|
__DLLVAR__ hid_t H5P_MOUNT;
|
1998-02-26 03:13:49 +08:00
|
|
|
|
2001-01-06 23:45:01 +08:00
|
|
|
/* H5P_DATASET_XFER was the name from the beginning through 1.2. It was
|
|
|
|
* changed to H5P_DATA_XFER on v1.3.0. Then it was changed back to
|
|
|
|
* H5P_DATASET_XFER right before the release of v1.4.0-beta2.
|
|
|
|
* Define an alias here to help applications that had ported to v1.3.
|
|
|
|
* Should be removed in later version.
|
|
|
|
*/
|
2000-11-28 07:01:48 +08:00
|
|
|
#define H5P_DATA_XFER H5P_DATASET_XFER
|
1999-10-07 02:11:46 +08:00
|
|
|
|
2000-07-26 01:35:17 +08:00
|
|
|
/* Define property list class callback function pointer types */
|
|
|
|
typedef herr_t (*H5P_cls_create_func_t)(hid_t prop_id, void *create_data);
|
2001-10-04 01:57:56 +08:00
|
|
|
typedef herr_t (*H5P_cls_copy_func_t)(hid_t new_prop_id, hid_t old_prop_id,
|
|
|
|
void *copy_data);
|
2000-07-26 01:35:17 +08:00
|
|
|
typedef herr_t (*H5P_cls_close_func_t)(hid_t prop_id, void *close_data);
|
|
|
|
|
|
|
|
/* Define property list callback function pointer types */
|
2001-08-11 04:47:05 +08:00
|
|
|
typedef herr_t (*H5P_prp_create_func_t)(const char *name, size_t size, void *def_value);
|
|
|
|
typedef herr_t (*H5P_prp_set_func_t)(hid_t prop_id, const char *name, size_t size, void *value);
|
|
|
|
typedef herr_t (*H5P_prp_get_func_t)(hid_t prop_id, const char *name, size_t size, void *value);
|
|
|
|
typedef herr_t (*H5P_prp_delete_func_t)(hid_t prop_id, const char *name, size_t size, void *value);
|
|
|
|
typedef herr_t (*H5P_prp_copy_func_t)(const char *name, size_t size, void *value);
|
|
|
|
typedef herr_t (*H5P_prp_close_func_t)(const char *name, size_t size, void *value);
|
2000-07-26 01:35:17 +08:00
|
|
|
|
2000-11-15 23:32:47 +08:00
|
|
|
/* Define property list iteration function type */
|
|
|
|
typedef herr_t (*H5P_iterate_t)(hid_t id, const char *name, void *iter_data);
|
|
|
|
|
1998-02-26 03:13:49 +08:00
|
|
|
#ifdef __cplusplus
|
|
|
|
extern "C" {
|
|
|
|
#endif
|
|
|
|
|
2000-07-26 01:35:17 +08:00
|
|
|
/*
|
|
|
|
* The library created property list classes
|
|
|
|
*/
|
2001-08-11 04:47:05 +08:00
|
|
|
#define H5P_NO_CLASS_NEW (H5open(), H5P_CLS_NO_CLASS_g)
|
2000-09-06 23:34:30 +08:00
|
|
|
#define H5P_NO_CLASS_HASH_SIZE 1 /* 1, not 0, otherwise allocations get weird */
|
2001-10-25 02:02:27 +08:00
|
|
|
#define H5P_FILE_CREATE (H5open(), H5P_CLS_FILE_CREATE_g)
|
|
|
|
#define H5P_FILE_CREATE_HASH_SIZE 17
|
|
|
|
#define H5P_FILE_ACCESS (H5open(), H5P_CLS_FILE_ACCESS_g)
|
|
|
|
#define H5P_FILE_ACCESS_HASH_SIZE 17
|
|
|
|
#define H5P_DATASET_CREATE (H5open(), H5P_CLS_DATASET_CREATE_g)
|
|
|
|
#define H5P_DATASET_CREATE_HASH_SIZE 17
|
|
|
|
#define H5P_DATASET_XFER (H5open(), H5P_CLS_DATASET_XFER_g)
|
|
|
|
#define H5P_DATASET_XFER_HASH_SIZE 17
|
|
|
|
#define H5P_MOUNT_NEW (H5open(), H5P_CLS_MOUNT_g)
|
|
|
|
#define H5P_MOUNT_HASH_SIZE 17
|
2001-08-11 04:47:05 +08:00
|
|
|
__DLLVAR__ hid_t H5P_CLS_NO_CLASS_g;
|
|
|
|
__DLLVAR__ hid_t H5P_CLS_FILE_CREATE_g;
|
|
|
|
__DLLVAR__ hid_t H5P_CLS_FILE_ACCESS_g;
|
|
|
|
__DLLVAR__ hid_t H5P_CLS_DATASET_CREATE_g;
|
|
|
|
__DLLVAR__ hid_t H5P_CLS_DATASET_XFER_g;
|
|
|
|
__DLLVAR__ hid_t H5P_CLS_MOUNT_g;
|
|
|
|
/*
|
|
|
|
* The library created default property lists
|
|
|
|
*/
|
2001-10-25 02:02:27 +08:00
|
|
|
#define H5P_NO_CLASS_DEFAULT (H5open(), H5P_LST_NO_CLASS_g)
|
|
|
|
#define H5P_FILE_CREATE_DEFAULT (H5open(), H5P_LST_FILE_CREATE_g)
|
|
|
|
#define H5P_FILE_ACCESS_DEFAULT (H5open(), H5P_LST_FILE_ACCESS_g)
|
|
|
|
#define H5P_DATASET_CREATE_DEFAULT (H5open(), H5P_LST_DATASET_CREATE_g)
|
|
|
|
#define H5P_DATASET_XFER_DEFAULT (H5open(), H5P_LST_DATASET_XFER_g)
|
|
|
|
#define H5P_MOUNT_DEFAULT (H5open(), H5P_LST_MOUNT_g)
|
2001-08-11 04:47:05 +08:00
|
|
|
__DLLVAR__ hid_t H5P_LST_NO_CLASS_g;
|
|
|
|
__DLLVAR__ hid_t H5P_LST_FILE_CREATE_g;
|
|
|
|
__DLLVAR__ hid_t H5P_LST_FILE_ACCESS_g;
|
|
|
|
__DLLVAR__ hid_t H5P_LST_DATASET_CREATE_g;
|
|
|
|
__DLLVAR__ hid_t H5P_LST_DATASET_XFER_g;
|
|
|
|
__DLLVAR__ hid_t H5P_LST_MOUNT_g;
|
2000-07-26 01:35:17 +08:00
|
|
|
|
1998-02-26 03:13:49 +08:00
|
|
|
/* Public functions */
|
2000-07-26 01:35:17 +08:00
|
|
|
__DLL__ hid_t H5Pcreate_class(hid_t parent, const char *name, unsigned hashsize,
|
|
|
|
H5P_cls_create_func_t cls_create, void *create_data,
|
2001-08-11 04:47:05 +08:00
|
|
|
H5P_cls_copy_func_t cls_copy, void *copy_data,
|
2000-07-26 01:35:17 +08:00
|
|
|
H5P_cls_close_func_t cls_close, void *close_data);
|
2000-11-14 08:05:51 +08:00
|
|
|
__DLL__ char *H5Pget_class_name(hid_t pclass_id);
|
2000-07-26 01:35:17 +08:00
|
|
|
__DLL__ hid_t H5Pcreate_list(hid_t cls_id);
|
2000-09-22 23:29:47 +08:00
|
|
|
__DLL__ herr_t H5Pregister(hid_t cls_id, const char *name, size_t size,
|
2000-07-26 01:35:17 +08:00
|
|
|
void *def_value, H5P_prp_create_func_t prp_create,
|
|
|
|
H5P_prp_set_func_t prp_set, H5P_prp_get_func_t prp_get,
|
2001-08-11 04:47:05 +08:00
|
|
|
H5P_prp_delete_func_t prp_del,
|
|
|
|
H5P_prp_copy_func_t prp_copy,
|
|
|
|
H5P_prp_close_func_t prp_close);
|
2000-07-26 01:35:17 +08:00
|
|
|
__DLL__ herr_t H5Pinsert(hid_t plist_id, const char *name, size_t size,
|
|
|
|
void *value, H5P_prp_set_func_t prp_set, H5P_prp_get_func_t prp_get,
|
2001-08-11 04:47:05 +08:00
|
|
|
H5P_prp_delete_func_t prp_delete,
|
|
|
|
H5P_prp_copy_func_t prp_copy,
|
|
|
|
H5P_prp_close_func_t prp_close);
|
2000-07-26 01:35:17 +08:00
|
|
|
__DLL__ herr_t H5Pset(hid_t plist_id, const char *name, void *value);
|
2000-11-12 08:09:36 +08:00
|
|
|
__DLL__ htri_t H5Pexist(hid_t plist_id, const char *name);
|
2000-11-15 10:27:03 +08:00
|
|
|
__DLL__ herr_t H5Pget_size(hid_t id, const char *name, size_t *size);
|
|
|
|
__DLL__ herr_t H5Pget_nprops(hid_t id, size_t *nprops);
|
2000-11-14 08:05:51 +08:00
|
|
|
__DLL__ hid_t H5Pget_class_new(hid_t plist_id);
|
2000-11-15 07:13:17 +08:00
|
|
|
__DLL__ hid_t H5Pget_class_parent(hid_t pclass_id);
|
2000-07-26 01:35:17 +08:00
|
|
|
__DLL__ herr_t H5Pget(hid_t plist_id, const char *name, void * value);
|
2000-11-15 07:13:17 +08:00
|
|
|
__DLL__ htri_t H5Pequal(hid_t id1, hid_t id2);
|
2001-08-11 04:47:05 +08:00
|
|
|
__DLL__ htri_t H5Pisa_class(hid_t plist_id, hid_t pclass_id);
|
2000-11-15 23:32:47 +08:00
|
|
|
__DLL__ int H5Piterate(hid_t id, int *idx, H5P_iterate_t iter_func,
|
|
|
|
void *iter_data);
|
2001-09-13 02:26:59 +08:00
|
|
|
__DLL__ herr_t H5Pcopy_prop(hid_t dst_id, hid_t src_id, const char *name);
|
2000-07-26 01:35:17 +08:00
|
|
|
__DLL__ herr_t H5Premove(hid_t plist_id, const char *name);
|
|
|
|
__DLL__ herr_t H5Punregister(hid_t pclass_id, const char *name);
|
|
|
|
__DLL__ herr_t H5Pclose_list(hid_t plist_id);
|
|
|
|
__DLL__ herr_t H5Pclose_class(hid_t plist_id);
|
2001-09-27 04:29:35 +08:00
|
|
|
__DLL__ hid_t H5Pcreate(hid_t type);
|
1999-02-19 00:21:34 +08:00
|
|
|
__DLL__ herr_t H5Pclose(hid_t plist_id);
|
|
|
|
__DLL__ hid_t H5Pcopy(hid_t plist_id);
|
2001-09-27 04:29:35 +08:00
|
|
|
__DLL__ hid_t H5Pget_class(hid_t plist_id);
|
1999-02-19 00:21:34 +08:00
|
|
|
__DLL__ herr_t H5Pget_version(hid_t plist_id, int *boot/*out*/,
|
2001-06-09 13:05:30 +08:00
|
|
|
int *freelist/*out*/, int *stab/*out*/,
|
|
|
|
int *shhdr/*out*/);
|
1999-02-19 00:21:34 +08:00
|
|
|
__DLL__ herr_t H5Pset_userblock(hid_t plist_id, hsize_t size);
|
|
|
|
__DLL__ herr_t H5Pget_userblock(hid_t plist_id, hsize_t *size);
|
|
|
|
__DLL__ herr_t H5Pset_alignment(hid_t fapl_id, hsize_t threshold,
|
2001-06-09 13:05:30 +08:00
|
|
|
hsize_t alignment);
|
1999-02-19 00:21:34 +08:00
|
|
|
__DLL__ herr_t H5Pget_alignment(hid_t fapl_id, hsize_t *threshold/*out*/,
|
2001-06-09 13:05:30 +08:00
|
|
|
hsize_t *alignment/*out*/);
|
1999-02-19 00:21:34 +08:00
|
|
|
__DLL__ herr_t H5Pset_sizes(hid_t plist_id, size_t sizeof_addr,
|
2001-06-09 13:05:30 +08:00
|
|
|
size_t sizeof_size);
|
1999-02-19 00:21:34 +08:00
|
|
|
__DLL__ herr_t H5Pget_sizes(hid_t plist_id, size_t *sizeof_addr/*out*/,
|
2001-06-09 13:05:30 +08:00
|
|
|
size_t *sizeof_size/*out*/);
|
2001-10-17 02:19:06 +08:00
|
|
|
__DLL__ herr_t H5Pset_sym_k(hid_t plist_id, int ik, unsigned lk);
|
|
|
|
__DLL__ herr_t H5Pget_sym_k(hid_t plist_id, int *ik/*out*/, unsigned *lk/*out*/);
|
1999-02-19 00:21:34 +08:00
|
|
|
__DLL__ herr_t H5Pset_istore_k(hid_t plist_id, int ik);
|
|
|
|
__DLL__ herr_t H5Pget_istore_k(hid_t plist_id, int *ik/*out*/);
|
|
|
|
__DLL__ herr_t H5Pset_layout(hid_t plist_id, H5D_layout_t layout);
|
|
|
|
__DLL__ H5D_layout_t H5Pget_layout(hid_t plist_id);
|
|
|
|
__DLL__ herr_t H5Pset_chunk(hid_t plist_id, int ndims, const hsize_t dim[]);
|
|
|
|
__DLL__ int H5Pget_chunk(hid_t plist_id, int max_ndims, hsize_t dim[]/*out*/);
|
|
|
|
__DLL__ herr_t H5Pset_external(hid_t plist_id, const char *name, off_t offset,
|
2001-06-09 13:05:30 +08:00
|
|
|
hsize_t size);
|
1999-02-19 00:21:34 +08:00
|
|
|
__DLL__ int H5Pget_external_count(hid_t plist_id);
|
|
|
|
__DLL__ herr_t H5Pget_external(hid_t plist_id, int idx, size_t name_size,
|
2001-06-09 13:05:30 +08:00
|
|
|
char *name/*out*/, off_t *offset/*out*/,
|
|
|
|
hsize_t *size/*out*/);
|
1999-08-11 04:21:32 +08:00
|
|
|
__DLL__ herr_t H5Pset_driver(hid_t plist_id, hid_t driver_id,
|
2001-06-09 13:05:30 +08:00
|
|
|
const void *driver_info);
|
1999-08-11 04:21:32 +08:00
|
|
|
__DLL__ hid_t H5Pget_driver(hid_t plist_id);
|
|
|
|
__DLL__ void *H5Pget_driver_info(hid_t plist_id);
|
2001-07-11 05:19:18 +08:00
|
|
|
__DLL__ herr_t H5Pset_buffer(hid_t plist_id, size_t size, void *tconv,
|
2001-06-09 13:05:30 +08:00
|
|
|
void *bkg);
|
2001-08-12 11:56:45 +08:00
|
|
|
__DLL__ size_t H5Pget_buffer(hid_t plist_id, void **tconv/*out*/,
|
2001-06-09 13:05:30 +08:00
|
|
|
void **bkg/*out*/);
|
1999-02-19 00:21:34 +08:00
|
|
|
__DLL__ herr_t H5Pset_preserve(hid_t plist_id, hbool_t status);
|
|
|
|
__DLL__ int H5Pget_preserve(hid_t plist_id);
|
|
|
|
__DLL__ herr_t H5Pset_filter(hid_t plist_id, H5Z_filter_t filter,
|
2001-06-09 13:05:30 +08:00
|
|
|
unsigned int flags, size_t cd_nelmts,
|
|
|
|
const unsigned int c_values[]);
|
1999-02-02 23:47:34 +08:00
|
|
|
__DLL__ int H5Pget_nfilters(hid_t plist_id);
|
|
|
|
__DLL__ H5Z_filter_t H5Pget_filter(hid_t plist_id, int filter,
|
2001-06-09 13:05:30 +08:00
|
|
|
unsigned int *flags/*out*/,
|
|
|
|
size_t *cd_nelmts/*out*/,
|
|
|
|
unsigned cd_values[]/*out*/,
|
|
|
|
size_t namelen, char name[]);
|
1999-02-19 00:21:34 +08:00
|
|
|
__DLL__ herr_t H5Pset_deflate(hid_t plist_id, unsigned aggression);
|
2001-07-11 05:19:18 +08:00
|
|
|
__DLL__ herr_t H5Pset_cache(hid_t plist_id, int mdc_nelmts, size_t rdcc_nelmts,
|
2001-06-09 13:05:30 +08:00
|
|
|
size_t rdcc_nbytes, double rdcc_w0);
|
1999-02-19 00:21:34 +08:00
|
|
|
__DLL__ herr_t H5Pget_cache(hid_t plist_id, int *mdc_nelmts/*out*/,
|
2001-07-11 05:19:18 +08:00
|
|
|
size_t *rdcc_nelmts/*out*/,
|
2001-06-09 13:05:30 +08:00
|
|
|
size_t *rdcc_nbytes/*out*/, double *rdcc_w0);
|
1999-02-02 23:47:34 +08:00
|
|
|
__DLL__ herr_t H5Pset_hyper_cache(hid_t plist_id, unsigned cache,
|
2001-06-09 13:05:30 +08:00
|
|
|
unsigned limit);
|
1999-02-02 23:47:34 +08:00
|
|
|
__DLL__ herr_t H5Pget_hyper_cache(hid_t plist_id, unsigned *cache,
|
2001-06-09 13:05:30 +08:00
|
|
|
unsigned *limit);
|
1999-02-02 23:47:34 +08:00
|
|
|
__DLL__ herr_t H5Pset_btree_ratios(hid_t plist_id, double left, double middle,
|
2001-06-09 13:05:30 +08:00
|
|
|
double right);
|
1999-02-02 23:47:34 +08:00
|
|
|
__DLL__ herr_t H5Pget_btree_ratios(hid_t plist_id, double *left/*out*/,
|
2001-06-09 13:05:30 +08:00
|
|
|
double *middle/*out*/,
|
|
|
|
double *right/*out*/);
|
1999-02-02 23:47:34 +08:00
|
|
|
__DLL__ herr_t H5Pset_fill_value(hid_t plist_id, hid_t type_id,
|
2001-06-09 13:05:30 +08:00
|
|
|
const void *value);
|
1999-02-02 23:47:34 +08:00
|
|
|
__DLL__ herr_t H5Pget_fill_value(hid_t plist_id, hid_t type_id,
|
2001-06-09 13:05:30 +08:00
|
|
|
void *value/*out*/);
|
1999-02-02 23:47:34 +08:00
|
|
|
__DLL__ herr_t H5Pset_gc_references(hid_t fapl_id, unsigned gc_ref);
|
2000-05-19 00:40:20 +08:00
|
|
|
__DLL__ herr_t H5Pget_gc_references(hid_t fapl_id, unsigned *gc_ref/*out*/);
|
1999-07-03 18:31:26 +08:00
|
|
|
__DLL__ herr_t H5Pset_vlen_mem_manager(hid_t plist_id,
|
2000-05-19 00:40:20 +08:00
|
|
|
H5MM_allocate_t alloc_func,
|
|
|
|
void *alloc_info, H5MM_free_t free_func,
|
|
|
|
void *free_info);
|
1999-07-03 18:31:26 +08:00
|
|
|
__DLL__ herr_t H5Pget_vlen_mem_manager(hid_t plist_id,
|
2000-05-19 00:40:20 +08:00
|
|
|
H5MM_allocate_t *alloc_func,
|
|
|
|
void **alloc_info,
|
|
|
|
H5MM_free_t *free_func,
|
|
|
|
void **free_info);
|
2001-07-11 05:19:18 +08:00
|
|
|
__DLL__ herr_t H5Pset_meta_block_size(hid_t fapl_id, size_t size);
|
|
|
|
__DLL__ herr_t H5Pget_meta_block_size(hid_t fapl_id, size_t *size/*out*/);
|
|
|
|
__DLL__ herr_t H5Pset_sieve_buf_size(hid_t fapl_id, size_t size);
|
|
|
|
__DLL__ herr_t H5Pget_sieve_buf_size(hid_t fapl_id, size_t *size/*out*/);
|
|
|
|
__DLL__ herr_t H5Pset_hyper_vector_size(hid_t fapl_id, size_t size);
|
|
|
|
__DLL__ herr_t H5Pget_hyper_vector_size(hid_t fapl_id, size_t *size/*out*/);
|
1998-11-25 08:29:09 +08:00
|
|
|
|
1998-02-26 03:13:49 +08:00
|
|
|
#ifdef __cplusplus
|
|
|
|
}
|
|
|
|
#endif
|
|
|
|
#endif
|