cuberite/polarssl
1
0
Fork 0
mirror of https://github.com/cuberite/polarssl.git synced 2025-09-30 08:56:50 -04:00
Code Issues Packages Projects Releases Wiki Activity

Add comment to set/increment step functions

Browse Source 
These functions are thread safe, but using them from within multiple
threads at the same time may not have the intended effect, given order
cannot be guaranteed. Also, standardise header comment formatting.

Signed-off-by: Paul Elliott <paul.elliott@arm.com>
This commit is contained in:
Paul Elliott 2024-02-06 15:10:03 +00:00
parent f20728ee49
commit 79e2e5d2d0
1 changed files with 20 additions and 10 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

20
tests/include/test/helpers.h
View File

@ -111,6 +111,11 @@ int mbedtls_test_get_line_no(void);
/**
* \brief Increment the current test step.
*
* \note Calling this function from within multiple threads at the
* same time is not recommended - whilst it is entirely thread
* safe, the order of calls to this function can obviously not
* be ensured, so unexpected results may occur.
*/
void mbedtls_test_increment_step(void);
@ -218,9 +223,14 @@ void mbedtls_test_skip(const char *test, int line_no, const char *filename);
* \brief Set the test step number for failure reports.
*
* Call this function to display "step NNN" in addition to the
* line number and file name if a test fails. Typically the "step
* number" is the index of a for loop but it can be whatever you
* want.
* line number and file name if a test fails. Typically the
* "step number" is the index of a for loop but it can be
* whatever you want.
*
* \note Calling this function from a within multiple threads at the
* same time is not recommended - whilst it is entirely thread
* safe, the order of calls to this function can obviously not
* be ensured, so unexpected results may occur.
*
* \param step The step number to report.
*/
@ -235,8 +245,8 @@ void mbedtls_test_info_reset(void);
/**
* \brief Get the test info data mutex.
*
* \note This is designed only to be used by threading_helpers to avoid a
* deadlock, not for general access to this mutex.
* \note This is designed only to be used by threading_helpers to
* avoid a deadlock, not for general access to this mutex.
*
* \return The test info data mutex.
*/