![]() |
HDF5
1.15.0.f61522e
API Reference
|
Use the functions in this module to manage the loading behavior of HDF5 plugins.
Create | Read |
---|---|
{
__label__ fail_set;
// enable ONLY filter plugins
ret_val = EXIT_FAILURE;
goto fail_set;
}
// ensure that "/tmp" is at the front of the search path list
ret_val = EXIT_FAILURE;
}
fail_set:;
}
herr_t H5PLprepend(const char *search_path) Inserts a plugin path at the beginning of the plugin search path list. herr_t H5PLset_loading_state(unsigned int plugin_control_mask) Controls the loadability of dynamic plugin types. | {
__label__ fail_read;
unsigned size, mask;
char buf[255];
// retrieve the number of entries in the plugin path list
if (H5PLsize(&size) < 0) {
ret_val = EXIT_FAILURE;
goto fail_read;
}
printf("Number of stored plugin paths: %d\n", size);
// check the plugin state mask
if (H5PLget_loading_state(&mask) < 0) {
ret_val = EXIT_FAILURE;
goto fail_read;
}
// print the paths in the plugin path list
for (unsigned i = 0; i < size; ++i) {
if (H5PLget(i, buf, 255) < 0) {
ret_val = EXIT_FAILURE;
break;
}
printf("%s\n", buf);
}
fail_read:;
}
ssize_t H5PLget(unsigned int index, char *path_buf, size_t buf_size) Queries the plugin search path list at the specified index. herr_t H5PLget_loading_state(unsigned int *plugin_control_mask) Queries the loadability of dynamic plugin types. |
Update | Delete |
{
// replace "/tmp" with something more sensible
ret_val = EXIT_FAILURE;
}
}
herr_t H5PLreplace(const char *search_path, unsigned int index) Replaces the path at the specified index in the plugin search path list. | {
__label__ fail_delete;
unsigned size;
if (H5PLsize(&size) < 0) {
ret_val = EXIT_FAILURE;
goto fail_delete;
}
// clean out the list of plugin paths
for (int i = size - 1; i >= 0; --i) {
if (H5PLremove(i) < 0) {
ret_val = EXIT_FAILURE;
break;
}
}
fail_delete:;
}
herr_t H5PLremove(unsigned int index) Removes a plugin path at a specified index from the plugin search path list. |
HDF5_PLUGIN_PRELOAD
and HDF5_PLUGIN_PATH
. Functions | |
herr_t | H5PLset_loading_state (unsigned int plugin_control_mask) |
Controls the loadability of dynamic plugin types. More... | |
herr_t | H5PLget_loading_state (unsigned int *plugin_control_mask) |
Queries the loadability of dynamic plugin types. More... | |
herr_t | H5PLappend (const char *search_path) |
Inserts a plugin path at the end of the plugin search path list. More... | |
herr_t | H5PLprepend (const char *search_path) |
Inserts a plugin path at the beginning of the plugin search path list. More... | |
herr_t | H5PLreplace (const char *search_path, unsigned int index) |
Replaces the path at the specified index in the plugin search path list. More... | |
herr_t | H5PLinsert (const char *search_path, unsigned int index) |
Inserts a path at the specified index in the plugin search path list. More... | |
herr_t | H5PLremove (unsigned int index) |
Removes a plugin path at a specified index from the plugin search path list. More... | |
ssize_t | H5PLget (unsigned int index, char *path_buf, size_t buf_size) |
Queries the plugin search path list at the specified index. More... | |
herr_t | H5PLsize (unsigned int *num_paths) |
Retrieves the number of stored plugin paths. More... | |
herr_t H5PLappend | ( | const char * | search_path | ) |
Inserts a plugin path at the end of the plugin search path list.
[in] | search_path | A plugin path |
H5PLappend() inserts a plugin path at the end of the plugin search path list.
ssize_t H5PLget | ( | unsigned int | index, |
char * | path_buf, | ||
size_t | buf_size | ||
) |
Queries the plugin search path list at the specified index.
[in] | index | Index |
[out] | path_buf | Pathname |
[in] | buf_size | Size of path_buf |
H5PLget() queries the plugin path at a specified index. If path_buf
is non-NULL then it writes up to buf_size
bytes into that buffer and always returns the length of the path name.
If path_buf
is NULL, this function will simply return the number of characters required to store the path name, ignoring path_buf
and buf_size
.
If an error occurs then the buffer pointed to by path_buf
(NULL or non-NULL) is unchanged and the function returns a negative value. If a zero is returned for the name's length, then there is no path name associated with the index. and the path_buf
buffer will be unchanged.
herr_t H5PLget_loading_state | ( | unsigned int * | plugin_control_mask | ) |
Queries the loadability of dynamic plugin types.
[out] | plugin_control_mask | List of dynamic plugin types that are enabled or disabled. A plugin bit set to 0 (zero) indicates that the dynamic plugin type is disabled. A plugin bit set to 1 (one) indicates that the dynamic plugin type is enabled. If the value of plugin_control_mask is negative, all dynamic plugin types are enabled.If the value of plugin_control_mask is 0 (zero), all dynamic plugins are disabled. |
H5PLget_loading_state() retrieves the bitmask that controls whether a certain type of plugin (e.g.: filters, VOL drivers) will be loaded by the HDF5 library.
Bit positions allocated to date are specified in H5PL_type_t as follows:
herr_t H5PLinsert | ( | const char * | search_path, |
unsigned int | index | ||
) |
Inserts a path at the specified index in the plugin search path list.
[in] | search_path | A plugin path |
[in] | index | Index |
H5PLinsert() inserts a plugin path at the specified index in the plugin search path list, moving other paths after index
.
herr_t H5PLprepend | ( | const char * | search_path | ) |
Inserts a plugin path at the beginning of the plugin search path list.
[in] | search_path | A plugin path |
H5PLprepend() inserts a plugin path at the end of the plugin search path list.
herr_t H5PLremove | ( | unsigned int | index | ) |
Removes a plugin path at a specified index from the plugin search path list.
[in] | index | Index |
H5PLremove() removes a plugin path at the specified index
and compacts the plugin search path list.
herr_t H5PLreplace | ( | const char * | search_path, |
unsigned int | index | ||
) |
Replaces the path at the specified index in the plugin search path list.
[in] | search_path | A plugin path |
[in] | index | Index |
H5PLreplace() replaces a plugin path at the specified index in the plugin search path list.
herr_t H5PLset_loading_state | ( | unsigned int | plugin_control_mask | ) |
Controls the loadability of dynamic plugin types.
[in] | plugin_control_mask | The list of dynamic plugin types to enable or disable. A plugin bit set to 0 (zero) prevents use of that dynamic plugin. A plugin bit set to 1 (one) enables use of that dynamic plugin. Setting plugin_control_mask to a negative value enables all dynamic plugin types.Setting plugin_control_mask to 0 (zero) disables all dynamic plugintypes. |
H5PLset_loading_state() uses one argument to enable or disable individual plugin types.
The plugin_control_mask
parameter is an encoded integer in which each bit controls a specific plugin type. Bit positions allocated to date are specified in H5PL_type_t as follows:
A plugin bit set to 0 (zero) prevents the use of the dynamic plugin type corresponding to that bit position. A plugin bit set to 1 (one) allows the use of that dynamic plugin type.
All dynamic plugin types can be enabled by setting plugin_control_mask
to a negative value. A value of 0 (zero) will disable all dynamic plugin types.
The loading of external dynamic plugins can be controlled during runtime with an environment variable, HDF5_PLUGIN_PRELOAD
. H5PLset_loading_state() inspects the HDF5_PLUGIN_PRELOAD
environment variable every time it is called. If the environment variable is set to the special ::
string, all dynamic plugins are disabled.
HDF5_PLUGIN_PRELOAD
controls the loading of dynamic plugin types at runtime. If it is set to disable all plugin types, then it will disable them for all running programs that access the same variable instance.herr_t H5PLsize | ( | unsigned int * | num_paths | ) |
Retrieves the number of stored plugin paths.
[out] | num_paths | Current length of the plugin search path list |
H5PLsize() retrieves the number of paths stored in the plugin search path list.