summaryrefslogtreecommitdiffstats
path: root/src/H5PLpublic.h
blob: 0b8d713a2d1964f6b6d1b20783a73116e12a30f5 (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
/* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
 * 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.                                                        *
 * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * */

/*
 * This file contains public declarations for the H5PL module.
 */

#ifndef H5PLpublic_H
#define H5PLpublic_H

/* Public headers needed by this file */
#include "H5public.h" /* Generic Functions                    */

/*******************/
/* Public Typedefs */
/*******************/

/* Special string to indicate no plugin loading.
 */
#define H5PL_NO_PLUGIN "::"

/* Plugin type used by the plugin library */
typedef enum H5PL_type_t {
    H5PL_TYPE_ERROR  = -1, /* Error                */
    H5PL_TYPE_FILTER = 0,  /* Filter               */
    H5PL_TYPE_VOL    = 1,  /* VOL driver           */
    H5PL_TYPE_NONE   = 2   /* This must be last!   */
} H5PL_type_t;

/* Common dynamic plugin type flags used by the set/get_loading_state functions */
#define H5PL_FILTER_PLUGIN 0x0001
#define H5PL_VOL_PLUGIN    0x0002
#define H5PL_ALL_PLUGIN    0xFFFF

#ifdef __cplusplus
extern "C" {
#endif

/* plugin state */
H5_DLL herr_t  H5PLset_loading_state(unsigned int plugin_control_mask);
H5_DLL herr_t  H5PLget_loading_state(unsigned int *plugin_control_mask /*out*/);
H5_DLL herr_t  H5PLappend(const char *search_path);
H5_DLL herr_t  H5PLprepend(const char *search_path);
H5_DLL herr_t  H5PLreplace(const char *search_path, unsigned int index);
H5_DLL herr_t  H5PLinsert(const char *search_path, unsigned int index);
H5_DLL herr_t  H5PLremove(unsigned int index);
H5_DLL ssize_t H5PLget(unsigned int index, char *path_buf /*out*/, size_t buf_size);
H5_DLL herr_t  H5PLsize(unsigned int *num_paths /*out*/);

#ifdef __cplusplus
}
#endif

#endif /* H5PLpublic_H */