summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorjhendersonHDF <jhenderson@hdfgroup.org>2023-05-03 16:46:31 (GMT)
committerJordan Henderson <jhenderson@hdfgroup.org>2023-05-03 18:26:57 (GMT)
commitcc1157b7a3c739c03ff1d300f0efe5552ed3f23a (patch)
tree1dc8fb3b312b4ddfdda4fe3778193aa651e7eeb6
parent7df92eee39e904bb38e74ce5f7971ebc4886472b (diff)
downloadhdf5-cc1157b7a3c739c03ff1d300f0efe5552ed3f23a.zip
hdf5-cc1157b7a3c739c03ff1d300f0efe5552ed3f23a.tar.gz
hdf5-cc1157b7a3c739c03ff1d300f0efe5552ed3f23a.tar.bz2
Minor tidying of API tests files (#2878)
* Minor tidying of API tests files * Remove old API test configuration setting
-rw-r--r--test/API/CMakeLists.txt1
-rw-r--r--test/API/README.md15
2 files changed, 9 insertions, 7 deletions
diff --git a/test/API/CMakeLists.txt b/test/API/CMakeLists.txt
index c2f95bd..dd2bca2 100644
--- a/test/API/CMakeLists.txt
+++ b/test/API/CMakeLists.txt
@@ -9,6 +9,7 @@
# help@hdfgroup.org.
#
+
cmake_minimum_required (VERSION 3.18)
project (HDF5_TEST_API C)
diff --git a/test/API/README.md b/test/API/README.md
index d57472d..aec6eaa 100644
--- a/test/API/README.md
+++ b/test/API/README.md
@@ -1,12 +1,13 @@
# HDF5 API Tests
-This directory contains several test applications that exercise [HDF5](https://github.com/HDFGroup/hdf5)'s
+This directory contains several test applications that exercise HDF5's
public API and serve as regression tests for HDF5 [VOL Connectors](https://portal.hdfgroup.org/display/HDF5/Virtual+Object+Layer).
## Build Process and options
-These HDF5 API tests are enabled and built by default, but can be disabled if desired.
-The following build options are available to influence how the API tests get built:
+These HDF5 API tests are disabled by default, but can be enabled by passing the
+`-DHDF5_TEST_API=ON` option to CMake. The following build options are available
+to influence how the API tests get built:
### CMake
@@ -39,9 +40,9 @@ Currently unsupported
### Usage
-These API tests currently only support usage with HDF5 VOL connectors that can be loaded dynamically
-as a plugin. For information on how to build a VOL connector in this manner, refer to section 2.3 of
-the [HDF5 VOL Connector Author Guide](https://portal.hdfgroup.org/display/HDF5/HDF5+VOL+Connector+Authors+Guide?preview=/53610813/59903039/vol_connector_author_guide.pdf).
+These API tests currently only support usage with the native HDF5 VOL connector and HDF5 VOL
+connectors that can be loaded dynamically as a plugin. For information on how to build a VOL
+connector in this manner, refer to section 2.3 of the [HDF5 VOL Connector Author Guide](https://portal.hdfgroup.org/display/HDF5/HDF5+VOL+Connector+Authors+Guide?preview=/53610813/59903039/vol_connector_author_guide.pdf).
TODO: section on building VOL connectors alongside HDF5 for use with tests
@@ -64,7 +65,7 @@ and use it when running tests. If HDF5 is unable to locate or load the VOL conne
will fall back to running the tests with the native HDF5 VOL connector and an error similar to the
following will appear in the test output:
- HDF5-DIAG: Error detected in HDF5 (1.13.0) MPI-process 0:
+ HDF5-DIAG: Error detected in HDF5 (X.XX.X) MPI-process 0:
#000: /home/user/git/hdf5/src/H5.c line 1010 in H5open(): library initialization failed
major: Function entry/exit
minor: Unable to initialize object