mirror of
https://github.com/HDFGroup/hdf5.git
synced 2025-01-12 15:04:59 +08:00
8253ab9ebf
* hbool_t --> bool in src * Does not remove TRUE/FALSE * Public header files are unchanged * Public API calls are unchanged * TRUE/FALSE --> true/false in src * Add deprecation notice for hbool_t
138 lines
6.8 KiB
C
138 lines
6.8 KiB
C
/* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
|
|
* Copyright by The HDF Group. *
|
|
* All rights reserved. *
|
|
* *
|
|
* This file is part of HDF5. The full HDF5 copyright notice, including *
|
|
* terms governing use, modification, and redistribution, is contained in *
|
|
* the COPYING file, which can be found at the root of the source code *
|
|
* distribution tree, or in https://www.hdfgroup.org/licenses. *
|
|
* If you do not have access to either file, you may request a copy from *
|
|
* help@hdfgroup.org. *
|
|
* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * */
|
|
|
|
/*-------------------------------------------------------------------------
|
|
*
|
|
* Created: H5HFprivate.h
|
|
*
|
|
* Purpose: Private header for library accessible fractal heap routines.
|
|
*
|
|
*-------------------------------------------------------------------------
|
|
*/
|
|
|
|
#ifndef H5HFprivate_H
|
|
#define H5HFprivate_H
|
|
|
|
/* Private headers needed by this file */
|
|
#include "H5Fprivate.h" /* File access */
|
|
#include "H5Oprivate.h" /* Object headers */
|
|
|
|
/**************************/
|
|
/* Library Private Macros */
|
|
/**************************/
|
|
|
|
/* Limit heap ID length to 4096 + 1, due to # of bits required to store
|
|
* length of 'tiny' objects (12 bits)
|
|
*/
|
|
#define H5HF_MAX_ID_LEN (4096 + 1)
|
|
|
|
/****************************/
|
|
/* Library Private Typedefs */
|
|
/****************************/
|
|
|
|
/* Creation parameters for doubling-tables */
|
|
typedef struct H5HF_dtable_cparam_t {
|
|
unsigned width; /* Number of columns in the table (must be power of 2) */
|
|
size_t start_block_size; /* Starting block size for table (must be power of 2) */
|
|
size_t max_direct_size; /* Maximum size of a direct block (must be power of 2) */
|
|
unsigned max_index; /* Maximum ID/offset for table (integer log2 of actual value, ie. the # of bits
|
|
required) */
|
|
unsigned start_root_rows; /* Starting number of rows for root indirect block */
|
|
/* 0 indicates to create the full indirect block for the root,
|
|
* right from the start. Doesn't have to be power of 2
|
|
*/
|
|
} H5HF_dtable_cparam_t;
|
|
|
|
/* Fractal heap creation parameters */
|
|
typedef struct H5HF_create_t {
|
|
H5HF_dtable_cparam_t managed; /* Mapped object doubling-table creation parameters */
|
|
bool checksum_dblocks; /* Whether the direct blocks should be checksummed */
|
|
uint32_t max_man_size; /* Max. size of object to manage in doubling table */
|
|
/* (i.e. min. size of object to store standalone) */
|
|
uint16_t id_len; /* Length of IDs to use for heap objects */
|
|
/* (0 - make ID just large enough to hold length & offset of object in the heap) */
|
|
/* (1 - make ID just large enough to allow 'huge' objects to be accessed directly) */
|
|
/* (n - make ID 'n' bytes in size) */
|
|
H5O_pline_t pline; /* I/O filter pipeline to apply to direct blocks & 'huge' objects */
|
|
} H5HF_create_t;
|
|
|
|
/* Fractal heap metadata statistics info */
|
|
typedef struct H5HF_stat_t {
|
|
/* 'Managed' object info */
|
|
hsize_t man_size; /* Size of 'managed' space in heap */
|
|
hsize_t man_alloc_size; /* Size of 'managed' space allocated in heap */
|
|
hsize_t man_iter_off; /* Offset of "new block" iterator in 'managed' heap space */
|
|
hsize_t man_free_space; /* Free space within 'managed' heap blocks */
|
|
hsize_t man_nobjs; /* Number of 'managed' objects in heap */
|
|
|
|
/* 'Huge' object info */
|
|
hsize_t huge_size; /* Size of 'huge' objects in heap */
|
|
hsize_t huge_nobjs; /* Number of 'huge' objects in heap */
|
|
|
|
/* 'Tiny' object info */
|
|
hsize_t tiny_size; /* Size of 'tiny' objects in heap */
|
|
hsize_t tiny_nobjs; /* Number of 'tiny' objects in heap */
|
|
} H5HF_stat_t;
|
|
|
|
/* Fractal heap info (forward decls - defined in H5HFpkg.h) */
|
|
typedef struct H5HF_t H5HF_t;
|
|
typedef struct H5HF_hdr_t H5HF_hdr_t;
|
|
typedef struct H5HF_indirect_t H5HF_indirect_t;
|
|
|
|
/* Typedef for 'op' operations */
|
|
typedef herr_t (*H5HF_operator_t)(const void *obj /*in*/, size_t obj_len, void *op_data /*in,out*/);
|
|
|
|
/*****************************/
|
|
/* Library-private Variables */
|
|
/*****************************/
|
|
|
|
/***************************************/
|
|
/* Library-private Function Prototypes */
|
|
/***************************************/
|
|
|
|
/* General routines for fractal heap operations */
|
|
H5_DLL H5HF_t *H5HF_create(H5F_t *f, const H5HF_create_t *cparam);
|
|
H5_DLL H5HF_t *H5HF_open(H5F_t *f, haddr_t fh_addr);
|
|
H5_DLL herr_t H5HF_get_id_len(H5HF_t *fh, size_t *id_len_p /*out*/);
|
|
H5_DLL herr_t H5HF_get_heap_addr(const H5HF_t *fh, haddr_t *heap_addr /*out*/);
|
|
H5_DLL herr_t H5HF_insert(H5HF_t *fh, size_t size, const void *obj, void *id /*out*/);
|
|
H5_DLL herr_t H5HF_get_obj_len(H5HF_t *fh, const void *id, size_t *obj_len_p /*out*/);
|
|
H5_DLL herr_t H5HF_get_obj_off(H5HF_t *fh, const void *_id, hsize_t *obj_off_p /*out*/);
|
|
H5_DLL herr_t H5HF_read(H5HF_t *fh, const void *id, void *obj /*out*/);
|
|
H5_DLL herr_t H5HF_write(H5HF_t *fh, void *id, bool *id_changed, const void *obj);
|
|
H5_DLL herr_t H5HF_op(H5HF_t *fh, const void *id, H5HF_operator_t op, void *op_data);
|
|
H5_DLL herr_t H5HF_remove(H5HF_t *fh, const void *id);
|
|
H5_DLL herr_t H5HF_close(H5HF_t *fh);
|
|
H5_DLL herr_t H5HF_delete(H5F_t *f, haddr_t fh_addr);
|
|
|
|
/* Statistics routines */
|
|
H5_DLL herr_t H5HF_stat_info(const H5HF_t *fh, H5HF_stat_t *stats);
|
|
H5_DLL herr_t H5HF_size(const H5HF_t *fh, hsize_t *heap_size /*out*/);
|
|
|
|
/* Debugging routines */
|
|
H5_DLL herr_t H5HF_id_print(H5HF_t *fh, const void *id, FILE *stream, int indent, int fwidth);
|
|
#ifdef H5HF_DEBUGGING
|
|
H5_DLL herr_t H5HF_sects_debug(H5F_t *f, haddr_t addr, FILE *stream, int indent, int fwidth);
|
|
#endif /* H5HF_DEBUGGING */
|
|
|
|
/* Debugging routines for dumping file structures */
|
|
H5_DLL void H5HF_hdr_print(const H5HF_hdr_t *hdr, bool dump_internal, FILE *stream, int indent, int fwidth);
|
|
H5_DLL herr_t H5HF_hdr_debug(H5F_t *f, haddr_t addr, FILE *stream, int indent, int fwidth);
|
|
H5_DLL herr_t H5HF_dblock_debug(H5F_t *f, haddr_t addr, FILE *stream, int indent, int fwidth,
|
|
haddr_t hdr_addr, size_t nrec);
|
|
H5_DLL void H5HF_iblock_print(const H5HF_indirect_t *iblock, bool dump_internal, FILE *stream, int indent,
|
|
int fwidth);
|
|
H5_DLL herr_t H5HF_iblock_debug(H5F_t *f, haddr_t addr, FILE *stream, int indent, int fwidth,
|
|
haddr_t hdr_addr, unsigned nrows);
|
|
|
|
#endif /* H5HFprivate_H */
|