From: Daniel Stenberg <daniel@haxx.se>
Date: Sat, 20 Sep 2025 15:44:32 +0000 (+0200)
Subject: vtls_int.h: clarify data_pending
X-Git-Tag: rc-8_17_0-2~414
X-Git-Url: http://git.ipfire.org/?a=commitdiff_plain;h=3d8e15650ccc02cb7384f3b991478363e9498f3f;p=thirdparty%2Fcurl.git

vtls_int.h: clarify data_pending

Suggested-by: Joseph Birr-Pixton

Closes #18644
---

diff --git a/lib/vtls/vtls_int.h b/lib/vtls/vtls_int.h
index de0b735e22..8bf6c6c64b 100644
--- a/lib/vtls/vtls_int.h
+++ b/lib/vtls/vtls_int.h
@@ -153,6 +153,10 @@ struct Curl_ssl {
   size_t (*version)(char *buffer, size_t size);
   CURLcode (*shut_down)(struct Curl_cfilter *cf, struct Curl_easy *data,
                         bool send_shutdown, bool *done);
+
+  /* data_pending() shall return TRUE when it wants to get called again to
+     drain internal buffers and deliver data instead of waiting for the socket
+     to get readable */
   bool (*data_pending)(struct Curl_cfilter *cf,
                        const struct Curl_easy *data);