summaryrefslogtreecommitdiffstats
path: root/src/H5FDhdfs.h
diff options
context:
space:
mode:
authorDana Robinson <43805+derobins@users.noreply.github.com>2023-10-30 16:13:54 (GMT)
committerGitHub <noreply@github.com>2023-10-30 16:13:54 (GMT)
commit58ef7dcdc9bfbfc65fe69d782914671f66322d85 (patch)
tree1944ce608aa8e78876cc59cd81a3eee8cbcff9dc /src/H5FDhdfs.h
parent87636d685594e804c0bfb59933e3a56b2dabcd28 (diff)
downloadhdf5-58ef7dcdc9bfbfc65fe69d782914671f66322d85.zip
hdf5-58ef7dcdc9bfbfc65fe69d782914671f66322d85.tar.gz
hdf5-58ef7dcdc9bfbfc65fe69d782914671f66322d85.tar.bz2
Update Doxygen initializers & identifiers in VFDs (#3795)
* Add Doxygen for all H5FD_<VFD> initializers * Add Doxygen for all H5FD_<VFD>_VALUE values * Mark H5FD_<vfd>_init() calls private in Doxygen
Diffstat (limited to 'src/H5FDhdfs.h')
-rw-r--r--src/H5FDhdfs.h21
1 files changed, 18 insertions, 3 deletions
diff --git a/src/H5FDhdfs.h b/src/H5FDhdfs.h
index c8c2c37..e5f7173 100644
--- a/src/H5FDhdfs.h
+++ b/src/H5FDhdfs.h
@@ -11,18 +11,29 @@
* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * */
/*
- * Purpose: The public header file for the hdfs driver.
+ * Purpose: The public header file for the Hadoop Distributed File System
+ * (hdfs) virtual file driver (VFD)
*/
#ifndef H5FDhdfs_H
#define H5FDhdfs_H
#ifdef H5_HAVE_LIBHDFS
-#define H5FD_HDFS (H5FDperform_init(H5FD_hdfs_init))
+
+/** Initializer for the hdfs VFD */
+#define H5FD_HDFS (H5FDperform_init(H5FD_hdfs_init))
+
+/** Identifier for the hdfs VFD */
#define H5FD_HDFS_VALUE H5_VFD_HDFS
-#else /* H5_HAVE_LIBHDFS */
+
+#else
+
+/** Initializer for the hdfs VFD (disabled) */
#define H5FD_HDFS (H5I_INVALID_HID)
+
+/** Identifier for the hdfs VFD (disabled) */
#define H5FD_HDFS_VALUE H5_VFD_INVALID
+
#endif /* H5_HAVE_LIBHDFS */
#ifdef H5_HAVE_LIBHDFS
@@ -104,6 +115,10 @@ typedef struct H5FD_hdfs_fapl_t {
int32_t stream_buffer_size;
} H5FD_hdfs_fapl_t;
+/** @private
+ *
+ * \brief Private initializer for the hdfs VFD
+ */
H5_DLL hid_t H5FD_hdfs_init(void);
/**