tests/README: document test bundles

Closes #16902
This commit is contained in:
Viktor Szakats 2025-04-01 11:42:25 +02:00
parent 93964c21f4
commit fddc7a67ea
No known key found for this signature in database
GPG Key ID: B5ABD165E2AEF201
2 changed files with 14 additions and 0 deletions

View File

@ -447,6 +447,8 @@ librtmp
libs
libssh
libssh2
libtest
libtests
Libtool
libtool
libuv

View File

@ -267,3 +267,15 @@ SPDX-License-Identifier: curl
writing tests that verify behaviors of specific individual functions.
The unit tests depend on curl being built with debug enabled.
### test bundles
The `--enable-test-bundles` (autotools) and `-DCURL_TEST_BUNDLES=ON` (cmake)
build options allow to build tests bundled into single executables, one for
libtests, one for unit tests and one for servers.
The executables' first argument is the name of libtest, unit test or server
respectively.
In these executables, the build process automatically renames the entry point
to a unique symbol. `test` becomes `test_<tool>`, e.g. `test_lib1598` or
`test_unit1305`. For servers `main` becomes `main_sws` for the `sws` server,
and so on. Other common symbols may also be suffixed the same way.