Name: H5Oget_info
Signature:
herr_t H5Oget_info( hid_t object_id, H5O_info_t *object_info )

Purpose:
Retrieves the metadata for an object specified by an identifier.

Description:
H5Oget_info specifies an object by its identifier, object_id, and retrieves the metadata describing that object in object_info, an H5O_info_t struct.

An H5O_info_t struct is defined (in H5Opublic.h) as follows :

typedef struct H5O_info_t {
    unsigned long       fileno;         /* File number that object is         */
                                        /*    located in                      */
    haddr_t             addr;           /* Object address in file             */
    H5O_type_t          type;           /* Basic object type (group,          */
                                        /*    dataset, etc.)                  */
    unsigned            rc;             /* Reference count of object          */
    time_t              atime;          /* Access time                        */
    time_t              mtime;          /* Modification time                  */
    time_t              ctime;          /* Change time                        */
    time_t              btime;          /* Birth time                         */
    hsize_t             num_attrs;      /* # of attributes attached to object */
    struct {
        unsigned version;               /* Version number of header format in */
                                        /*    file                            */
        unsigned nmesgs;                /* Number of object header messages   */
        unsigned nchunks;               /* Number of object header chunks     */
        unsigned flags;                 /* Object header status flags         */
        struct {
            hsize_t total;              /* Total space for storing object     */
                                        /*    header in file                  */
            hsize_t meta;               /* Space within header for object     */
                                        /*    header metadata information     */
            hsize_t mesg;               /* Space within header for actual     */
                                        /*    message information             */
            hsize_t free;               /* Free space within object header    */
        } space;
        struct {
            uint64_t present;           /* Flags to indicate presence of      */
                                        /*    message type in header          */
            uint64_t shared;            /* Flags to indicate message type is  */
                                        /*    shared in header                */
        } mesg;     
    } hdr;
    /* Extra metadata storage for obj & attributes */
    struct {
        H5_ih_info_t   obj;             /* v1/v2 B-tree & local/fractal heap  */
                                        /*    for groups, B-tree for chunked  */
                                        /*    datasets                        */
        H5_ih_info_t   attr;            /* v2 B-tree & heap for attributes    */
    } meta_size;
} H5O_info_t;
    

Parameters:
hid_t object_id IN: Identifier for target object
H5O_info_t *object_info     OUT: Buffer in which to return object information

Returns:
Returns a non-negative value if successful; otherwise returns a negative value.

Fortran90 Interface:
None.

History:
Release     C
1.8.0 Function introduced in this release.