summaryrefslogtreecommitdiffstats
path: root/src/H5Oprivate.h
blob: b570b30acd6435a0124b8918a4dbb0b2be7014a8 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
/*-------------------------------------------------------------------------
 * Copyright (C) 1997   National Center for Supercomputing Applications.
 *                      All rights reserved.
 *
 *-------------------------------------------------------------------------
 *
 * Created:             H5Oprivate.h
 *                      Aug  5 1997
 *                      Robb Matzke <matzke@llnl.gov>
 *
 * Purpose:             Object header private include file.
 *
 * Modifications:       
 *
 *-------------------------------------------------------------------------
 */
#ifndef _H5Oprivate_H
#define _H5Oprivate_H
#include <H5Opublic.h>

/* Private headers neede by this file */
#include <H5private.h>
#include <H5Fprivate.h>
#include <H5Gprivate.h>
#include <H5Tprivate.h>
#include <H5Pprivate.h>

#define H5O_MIN_SIZE    32      /*min obj header data size        */
#define H5O_NMESGS      32      /*initial number of messages      */
#define H5O_NCHUNKS     8       /*initial number of chunks        */
#define H5O_NEW_MESG    (-1)    /*new message                     */
#define H5O_ALL         (-1)    /*delete all messages of type     */

/* Flags which are part of the message id */
#define H5O_FLAG_CONSTANT       0x8000
#define H5O_FLAG_BITS           0x8000

#define H5O_VERSION     1
#define H5O_ALIGNMENT   4
#define H5O_ALIGN(X,A)  ((X)=(A)*(((X)+(A)-1)/(A)))

#define H5O_SIZEOF_HDR(F)                                                     \
   (1 +         /*version number        */                                    \
    1 +         /*alignment             */                                    \
    2 +         /*number of messages    */                                    \
    4 +         /*reference count       */                                    \
    4)                          /*header data size        */

typedef struct H5O_class_t {
    intn                    id; /*message type ID on disk       */
    const char             *name;       /*message name for debugging    */
    size_t                  native_size;        /*size of native message        */
    void                   *(*decode) (H5F_t *, size_t, const uint8 *);
    herr_t                  (*encode) (H5F_t *, size_t, uint8 *, const void *);
    void                   *(*copy) (const void *, void *);     /*copy native value        */
    size_t                  (*raw_size) (H5F_t *, const void *);        /*sizeof raw val       */
    herr_t                  (*reset) (void *);  /*free nested data structures          */
    herr_t                  (*debug) (H5F_t *, const void *, FILE *, intn, intn);
} H5O_class_t;

typedef struct H5O_mesg_t {
    const H5O_class_t      *type;       /*type of message               */
    hbool_t                 dirty;      /*raw out of date wrt native    */
    hbool_t                 constant;   /*is message constant?          */
    void                   *native;     /*native format message         */
    uint8                  *raw;        /*ptr to raw data               */
    size_t                  raw_size;   /*size with alignment           */
    intn                    chunkno;    /*chunk number for this mesg    */
} H5O_mesg_t;

typedef struct H5O_chunk_t {
    hbool_t                 dirty;      /*dirty flag                    */
    haddr_t                 addr;       /*chunk file address            */
    size_t                  size;       /*chunk size                    */
    uint8                  *image;      /*image of file                 */
} H5O_chunk_t;

typedef struct H5O_t {
    hbool_t                 dirty;      /*out of data wrt disk          */
    intn                    version;    /*version number                */
    intn                    alignment;  /*message alignment             */
    intn                    nlink;      /*link count                    */
    intn                    nmesgs;     /*number of messages            */
    intn                    alloc_nmesgs;       /*number of message slots       */
    H5O_mesg_t             *mesg;       /*array of messages             */
    intn                    nchunks;    /*number of chunks              */
    intn                    alloc_nchunks;      /*chunks allocated              */
    H5O_chunk_t            *chunk;      /*array of chunks               */
} H5O_t;

/*
 * Null Message.
 */
#define H5O_NULL_ID     0x0000
extern const H5O_class_t H5O_NULL[1];

/*
 * Simple Data Space Message.
 */
#define H5O_SDSPACE_ID  0x0001
extern const H5O_class_t H5O_SDSPACE[1];
/* operates on an H5P_simple_t struct */

/*
 * Data Type Message.
 */
#define H5O_DTYPE_ID    0x0003
extern const H5O_class_t H5O_DTYPE[1];
/* operates on an H5T_t struct */

/*
 * Data Layout Message
 */
#define H5O_LAYOUT_ID           0x0008
#define H5O_LAYOUT_NDIMS        32
extern const H5O_class_t H5O_LAYOUT[1];

typedef struct H5O_layout_t {
    int                     type;       /*type of layout, H5D_layout_t  */
    haddr_t                 addr;       /*file address of data or B-tree */
    uintn                   ndims;      /*num dimensions in stored data */
    size_t                  dim[H5O_LAYOUT_NDIMS];      /*size of data or chunk         */
} H5O_layout_t;

/*
 * External File List Message
 */
#define H5O_EFL_ID              0x0009
extern const H5O_class_t H5O_EFL[1];

typedef struct H5O_efl_t {
    haddr_t                 heap_addr;  /*Address of name heap          */
    uintn                   nalloc;     /*Number of slots allocated     */
    uintn                   nused;      /*Number of slots used          */
    size_t                 *offset;     /*Array of name offsets in heap */
} H5O_efl_t;

/*
 * Object name message.
 */
#define H5O_NAME_ID     0x000d
extern const H5O_class_t H5O_NAME[1];

typedef struct H5O_name_t {
    const char             *s;  /*ptr to malloc'd memory        */
} H5O_name_t;

/*
 * Object header continuation message.
 */
#define H5O_CONT_ID     0x0010
extern const H5O_class_t H5O_CONT[1];

typedef struct H5O_cont_t {
    haddr_t                 addr;       /*address of continuation block */
    size_t                  size;       /*size of continuation block    */

    /* the following field(s) do not appear on disk */
    intn                    chunkno;    /*chunk this mesg refers to     */
} H5O_cont_t;

/*
 * Symbol table message.
 */
#define H5O_STAB_ID     0x0011
extern const H5O_class_t H5O_STAB[1];
void                   *H5O_stab_fast(const H5G_cache_t *cache, const H5O_class_t *type,
                                      void *_mesg);

typedef struct H5O_stab_t {
    haddr_t                 btree_addr;         /*address of B-tree             */
    haddr_t                 heap_addr;  /*address of name heap          */
} H5O_stab_t;

herr_t                  H5O_create(H5F_t *f, size_t size_hint, H5G_entry_t *ent /*out */ );
herr_t                  H5O_open(H5F_t *f, H5G_entry_t *ent);
herr_t                  H5O_close(H5G_entry_t *ent);
intn                    H5O_link(H5G_entry_t *ent, intn adjust);
void                   *H5O_read(H5G_entry_t *ent, const H5O_class_t *type, intn sequence,
                                 void *mesg);
intn                    H5O_modify(H5G_entry_t *ent, const H5O_class_t *type, intn overwrite,
                                   uintn flags, const void *mesg);
herr_t                  H5O_remove(H5G_entry_t *ent, const H5O_class_t *type, intn sequence);
herr_t                  H5O_reset(const H5O_class_t *type, void *native);
herr_t                  H5O_debug(H5F_t *f, const haddr_t *addr, FILE * stream,
                                  intn indent, intn fwidth);

#endif