From: Viktor Szakats Date: Thu, 12 Jun 2025 10:09:09 +0000 (+0200) Subject: tidy-up: update deprecated status of some symbols/options X-Git-Tag: curl-8_15_0~268 X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=924c7e15dce54cfe70920e4a3bad4886835f1c4e;p=thirdparty%2Fcurl.git tidy-up: update deprecated status of some symbols/options `CURLOPT_SSL_FALSESTART` / `--false-start`, Secure Transport, BearSSL, GSKit, MesaLink, NSS. Follow-up to 1e2e808defe6850295baa002d07cde9a129ec791 #17595 Follow-up to 08a3e8e19a59d1530bfb208e187ac7c34c978dfd #16677 Closes #17605 --- diff --git a/docs/cmdline-opts/false-start.md b/docs/cmdline-opts/false-start.md index 2490253512..7c8c976698 100644 --- a/docs/cmdline-opts/false-start.md +++ b/docs/cmdline-opts/false-start.md @@ -5,7 +5,7 @@ Long: false-start Help: Enable TLS False Start Protocols: TLS Added: 7.42.0 -Category: tls +Category: deprecated Multi: boolean See-also: - tcp-fastopen diff --git a/docs/libcurl/curl_easy_setopt.md b/docs/libcurl/curl_easy_setopt.md index 8a5390f9f0..4af2be82f9 100644 --- a/docs/libcurl/curl_easy_setopt.md +++ b/docs/libcurl/curl_easy_setopt.md @@ -1118,7 +1118,7 @@ Enable use of ALPN. See CURLOPT_SSL_ENABLE_ALPN(3) ## CURLOPT_SSL_FALSESTART -Enable TLS False Start. See CURLOPT_SSL_FALSESTART(3) +**Deprecated option** Enable TLS False Start. See CURLOPT_SSL_FALSESTART(3) ## CURLOPT_SSL_OPTIONS diff --git a/docs/libcurl/opts/CURLOPT_SSL_FALSESTART.md b/docs/libcurl/opts/CURLOPT_SSL_FALSESTART.md index 3aefa3369a..a3e7159126 100644 --- a/docs/libcurl/opts/CURLOPT_SSL_FALSESTART.md +++ b/docs/libcurl/opts/CURLOPT_SSL_FALSESTART.md @@ -54,6 +54,10 @@ int main(void) } ~~~ +# DEPRECATED + +Deprecated since 8.15.0. + # %AVAILABILITY% # RETURN VALUE diff --git a/docs/libcurl/symbols-in-versions b/docs/libcurl/symbols-in-versions index 13d5dd3787..942dadbbf9 100644 --- a/docs/libcurl/symbols-in-versions +++ b/docs/libcurl/symbols-in-versions @@ -846,7 +846,7 @@ CURLOPT_SSL_CTX_FUNCTION 7.10.6 CURLOPT_SSL_EC_CURVES 7.73.0 CURLOPT_SSL_ENABLE_ALPN 7.36.0 CURLOPT_SSL_ENABLE_NPN 7.36.0 7.86.0 -CURLOPT_SSL_FALSESTART 7.42.0 +CURLOPT_SSL_FALSESTART 7.42.0 8.15.0 CURLOPT_SSL_OPTIONS 7.25.0 CURLOPT_SSL_SESSIONID_CACHE 7.16.0 CURLOPT_SSL_SIGNATURE_ALGORITHMS 8.14.0 @@ -1038,24 +1038,24 @@ CURLSSH_AUTH_NONE 7.16.1 CURLSSH_AUTH_PASSWORD 7.16.1 CURLSSH_AUTH_PUBLICKEY 7.16.1 CURLSSLBACKEND_AWSLC 8.1.0 -CURLSSLBACKEND_AXTLS 7.38.0 7.61.0 -CURLSSLBACKEND_BEARSSL 7.68.0 +CURLSSLBACKEND_AXTLS 7.38.0 7.61.0 +CURLSSLBACKEND_BEARSSL 7.68.0 8.15.0 CURLSSLBACKEND_BORINGSSL 7.49.0 CURLSSLBACKEND_CYASSL 7.34.0 -CURLSSLBACKEND_DARWINSSL 7.34.0 7.64.1 +CURLSSLBACKEND_DARWINSSL 7.34.0 7.64.1 CURLSSLBACKEND_GNUTLS 7.34.0 -CURLSSLBACKEND_GSKIT 7.34.0 +CURLSSLBACKEND_GSKIT 7.34.0 8.3.0 CURLSSLBACKEND_LIBRESSL 7.49.0 CURLSSLBACKEND_MBEDTLS 7.46.0 -CURLSSLBACKEND_MESALINK 7.62.0 +CURLSSLBACKEND_MESALINK 7.62.0 7.82.0 CURLSSLBACKEND_NONE 7.34.0 -CURLSSLBACKEND_NSS 7.34.0 +CURLSSLBACKEND_NSS 7.34.0 8.3.0 CURLSSLBACKEND_OPENSSL 7.34.0 -CURLSSLBACKEND_POLARSSL 7.34.0 7.69.0 +CURLSSLBACKEND_POLARSSL 7.34.0 7.69.0 CURLSSLBACKEND_QSOSSL 7.34.0 - 7.38.0 CURLSSLBACKEND_RUSTLS 7.76.0 CURLSSLBACKEND_SCHANNEL 7.34.0 -CURLSSLBACKEND_SECURETRANSPORT 7.64.1 +CURLSSLBACKEND_SECURETRANSPORT 7.64.1 8.15.0 CURLSSLBACKEND_WOLFSSL 7.49.0 CURLSSLOPT_ALLOW_BEAST 7.25.0 CURLSSLOPT_AUTO_CLIENT_CERT 7.77.0 diff --git a/include/curl/curl.h b/include/curl/curl.h index dfb6c76881..9eb021305a 100644 --- a/include/curl/curl.h +++ b/include/curl/curl.h @@ -158,11 +158,11 @@ typedef enum { CURLSSLBACKEND_POLARSSL CURL_DEPRECATED(7.69.0, "") = 6, CURLSSLBACKEND_WOLFSSL = 7, CURLSSLBACKEND_SCHANNEL = 8, - CURLSSLBACKEND_SECURETRANSPORT = 9, + CURLSSLBACKEND_SECURETRANSPORT CURL_DEPRECATED(8.15.0, "") = 9, CURLSSLBACKEND_AXTLS CURL_DEPRECATED(7.61.0, "") = 10, CURLSSLBACKEND_MBEDTLS = 11, CURLSSLBACKEND_MESALINK CURL_DEPRECATED(7.82.0, "") = 12, - CURLSSLBACKEND_BEARSSL = 13, + CURLSSLBACKEND_BEARSSL CURL_DEPRECATED(8.15.0, "") = 13, CURLSSLBACKEND_RUSTLS = 14 } curl_sslbackend; @@ -1954,7 +1954,8 @@ typedef enum { CURLOPT(CURLOPT_SSL_VERIFYSTATUS, CURLOPTTYPE_LONG, 232), /* Set if we should enable TLS false start. */ - CURLOPT(CURLOPT_SSL_FALSESTART, CURLOPTTYPE_LONG, 233), + CURLOPTDEPRECATED(CURLOPT_SSL_FALSESTART, CURLOPTTYPE_LONG, 233, + 8.15.0, "Has no function"), /* Do not squash dot-dot sequences */ CURLOPT(CURLOPT_PATH_AS_IS, CURLOPTTYPE_LONG, 234), diff --git a/src/tool_listhelp.c b/src/tool_listhelp.c index 785f4cd936..beb034eeaf 100644 --- a/src/tool_listhelp.c +++ b/src/tool_listhelp.c @@ -200,7 +200,7 @@ const struct helptxt helptext[] = { CURLHELP_HTTP | CURLHELP_OUTPUT}, {" --false-start", "Enable TLS False Start", - CURLHELP_TLS}, + CURLHELP_DEPRECATED}, {"-F, --form ", "Specify multipart MIME data", CURLHELP_HTTP | CURLHELP_UPLOAD | CURLHELP_POST | CURLHELP_IMAP |