From ed70149de35ebc9f21bb9b4080830f37fe868882 Mon Sep 17 00:00:00 2001
From: Ben Taylor <ben.taylor@linaro.org>
Date: Mon, 1 Jun 2026 08:03:58 +0100
Subject: [PATCH] Add further documentation to tls_abort_transcript_context

Signed-off-by: Ben Taylor <ben.taylor@linaro.org>
---
 tests/suites/test_suite_ssl.function | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/tests/suites/test_suite_ssl.function b/tests/suites/test_suite_ssl.function
index 8a99e93940..c377bcaace 100644
--- a/tests/suites/test_suite_ssl.function
+++ b/tests/suites/test_suite_ssl.function
@@ -61,6 +61,9 @@ static int failing_ticket_write_unset_lifetime(
     defined(MBEDTLS_TEST_HAS_DEFAULT_EC_GROUP) && \
     defined(PSA_WANT_ALG_SHA_256)
 typedef struct {
+    /* Context for tls_abort_transcript(). The debug callback watches for
+     * trigger in the SSL debug trace, then aborts this connection's transcript
+     * hash operation exactly once so the test can check error propagation. */
     mbedtls_ssl_context *ssl;
     const char *trigger;
     int triggered;