@@ -252,7 +252,7 @@ typedef int (*curl_xferinfo_callback)(void *clientp,
252252
253253#ifndef CURL_MAX_READ_SIZE
254254 /* The maximum receive buffer size configurable via CURLOPT_BUFFERSIZE. */
255- #define CURL_MAX_READ_SIZE (10* 1024* 1024)
255+ #define CURL_MAX_READ_SIZE (10 * 1024 * 1024)
256256#endif
257257
258258#ifndef CURL_MAX_WRITE_SIZE
@@ -269,7 +269,7 @@ typedef int (*curl_xferinfo_callback)(void *clientp,
269269/* The only reason to have a max limit for this is to avoid the risk of a bad
270270 server feeding libcurl with a never-ending header that causes reallocs
271271 infinitely */
272- #define CURL_MAX_HTTP_HEADER (100* 1024)
272+ #define CURL_MAX_HTTP_HEADER (100 * 1024)
273273#endif
274274
275275/* This is a magic return code for the write callback that, when returned,
@@ -593,7 +593,7 @@ typedef enum {
593593 CURLE_USE_SSL_FAILED , /* 64 - Requested FTP SSL level failed */
594594 CURLE_SEND_FAIL_REWIND , /* 65 - Sending the data requires a rewind
595595 that failed */
596- CURLE_SSL_ENGINE_INITFAILED , /* 66 - failed to initialise ENGINE */
596+ CURLE_SSL_ENGINE_INITFAILED , /* 66 - failed to initialize ENGINE */
597597 CURLE_LOGIN_DENIED , /* 67 - user, password or similar was not
598598 accepted and we failed to login */
599599 CURLE_TFTP_NOTFOUND , /* 68 - file not found on server */
@@ -802,9 +802,11 @@ typedef CURLcode (*curl_ssl_ctx_callback)(CURL *curl, /* easy handle */
802802#define CURLPROXY_SOCKS5_HOSTNAME 7L /* Use the SOCKS5 protocol but pass along
803803 the hostname rather than the IP
804804 address. added in 7.18.0 */
805+ #define CURLPROXY_HTTPS3 8L /* HTTPS and attempt HTTP/3
806+ added in 8.21.0 */
805807
806808typedef enum {
807- CURLPROXY_LAST = 8 /* never use */
809+ CURLPROXY_LAST = 9 /* never use */
808810} curl_proxytype ; /* this enum was added in 7.10 */
809811
810812/*
@@ -816,7 +818,7 @@ typedef enum {
816818 * CURLAUTH_NEGOTIATE - HTTP Negotiate (SPNEGO) authentication
817819 * CURLAUTH_GSSNEGOTIATE - Alias for CURLAUTH_NEGOTIATE (deprecated)
818820 * CURLAUTH_NTLM - HTTP NTLM authentication
819- * CURLAUTH_DIGEST_IE - HTTP Digest authentication with IE flavour
821+ * CURLAUTH_DIGEST_IE - HTTP Digest authentication with IE flavor
820822 * CURLAUTH_NTLM_WB - HTTP NTLM authentication delegated to winbind helper
821823 * CURLAUTH_BEARER - HTTP Bearer token authentication
822824 * CURLAUTH_ONLY - Use together with a single other type to force no
@@ -902,16 +904,16 @@ enum curl_khmatch {
902904};
903905
904906typedef int
905- (* curl_sshkeycallback ) (CURL * easy , /* easy handle */
906- const struct curl_khkey * knownkey , /* known */
907- const struct curl_khkey * foundkey , /* found */
908- enum curl_khmatch , /* libcurl's view on the keys */
909- void * clientp ); /* custom pointer passed with */
910- /* CURLOPT_SSH_KEYDATA */
907+ (* curl_sshkeycallback )(CURL * easy , /* easy handle */
908+ const struct curl_khkey * knownkey , /* known */
909+ const struct curl_khkey * foundkey , /* found */
910+ enum curl_khmatch , /* libcurl's view on the keys */
911+ void * clientp ); /* custom pointer passed with */
912+ /* CURLOPT_SSH_KEYDATA */
911913
912914typedef int
913- (* curl_sshhostkeycallback ) (void * clientp ,/* custom pointer passed */
914- /* with CURLOPT_SSH_HOSTKEYDATA */
915+ (* curl_sshhostkeycallback )(void * clientp ,/* custom pointer passed */
916+ /* with CURLOPT_SSH_HOSTKEYDATA */
915917 int keytype , /* CURLKHTYPE */
916918 const char * key , /* hostkey to check */
917919 size_t keylen ); /* length of the key */
@@ -932,7 +934,7 @@ typedef enum {
932934
933935/* - ALLOW_BEAST tells libcurl to allow the BEAST SSL vulnerability in the
934936 name of improving interoperability with older servers. Some SSL libraries
935- have introduced work-arounds for this flaw but those work-arounds sometimes
937+ have introduced workarounds for this flaw but those workarounds sometimes
936938 make the SSL communication fail. To regain functionality with those broken
937939 servers, a user can this way allow the vulnerability back. */
938940#define CURLSSLOPT_ALLOW_BEAST (1L << 0)
@@ -1362,7 +1364,7 @@ typedef enum {
13621364 CURLOPTDEPRECATED (CURLOPT_KRBLEVEL , CURLOPTTYPE_STRINGPOINT , 63 ,
13631365 8.17 .0 , "removed "),
13641366
1365- /* Set if we should verify the peer in ssl handshake, set 1 to verify. */
1367+ /* Set if we should verify the peer in SSL handshake, set 1 to verify. */
13661368 CURLOPT (CURLOPT_SSL_VERIFYPEER , CURLOPTTYPE_LONG , 64 ),
13671369
13681370 /* The CApath or CAfile used to validate the peer certificate
@@ -1420,7 +1422,7 @@ typedef enum {
14201422 */
14211423 CURLOPT (CURLOPT_HTTPGET , CURLOPTTYPE_LONG , 80 ),
14221424
1423- /* Set if we should verify the Common name from the peer certificate in ssl
1425+ /* Set if we should verify the Common name from the peer certificate in SSL
14241426 * handshake, set 1 to check existence, 2 to ensure that it matches the
14251427 * provided hostname. */
14261428 CURLOPT (CURLOPT_SSL_VERIFYHOST , CURLOPTTYPE_LONG , 81 ),
@@ -1494,8 +1496,8 @@ typedef enum {
14941496 CURLOPT (CURLOPT_SHARE , CURLOPTTYPE_OBJECTPOINT , 100 ),
14951497
14961498 /* indicates type of proxy. accepted values are CURLPROXY_HTTP (default),
1497- CURLPROXY_HTTPS, CURLPROXY_SOCKS4, CURLPROXY_SOCKS4A and
1498- CURLPROXY_SOCKS5. */
1499+ CURLPROXY_HTTPS, CURLPROXY_HTTPS2, CURLPROXY_HTTPS3, CURLPROXY_SOCKS4,
1500+ CURLPROXY_SOCKS4A and CURLPROXY_SOCKS5. */
14991501 CURLOPT (CURLOPT_PROXYTYPE , CURLOPTTYPE_VALUES , 101 ),
15001502
15011503 /* Set the Accept-Encoding string. Use this to tell a server you would like
@@ -1524,12 +1526,12 @@ typedef enum {
15241526 Note that setting multiple bits may cause extra network round-trips. */
15251527 CURLOPT (CURLOPT_HTTPAUTH , CURLOPTTYPE_VALUES , 107 ),
15261528
1527- /* Set the ssl context callback function, currently only for OpenSSL or
1529+ /* Set the SSL context callback function, currently only for OpenSSL or
15281530 wolfSSL ssl_ctx, or mbedTLS mbedtls_ssl_config in the second argument.
15291531 The function must match the curl_ssl_ctx_callback prototype. */
15301532 CURLOPT (CURLOPT_SSL_CTX_FUNCTION , CURLOPTTYPE_FUNCTIONPOINT , 108 ),
15311533
1532- /* Set the userdata for the ssl context callback function's third
1534+ /* Set the userdata for the SSL context callback function's third
15331535 argument */
15341536 CURLOPT (CURLOPT_SSL_CTX_DATA , CURLOPTTYPE_CBPOINT , 109 ),
15351537
@@ -1935,11 +1937,11 @@ typedef enum {
19351937 /* Set authentication options directly */
19361938 CURLOPT (CURLOPT_LOGIN_OPTIONS , CURLOPTTYPE_STRINGPOINT , 224 ),
19371939
1938- /* Enable/disable TLS NPN extension (http2 over ssl might fail without) */
1940+ /* Enable/disable TLS NPN extension (http2 over SSL might fail without) */
19391941 CURLOPTDEPRECATED (CURLOPT_SSL_ENABLE_NPN , CURLOPTTYPE_LONG , 225 ,
19401942 7.86 .0 , "Has no function "),
19411943
1942- /* Enable/disable TLS ALPN extension (http2 over ssl might fail without) */
1944+ /* Enable/disable TLS ALPN extension (http2 over SSL might fail without) */
19431945 CURLOPT (CURLOPT_SSL_ENABLE_ALPN , CURLOPTTYPE_LONG , 226 ),
19441946
19451947 /* Time to wait for a response to an HTTP request containing an
@@ -1985,10 +1987,12 @@ typedef enum {
19851987 CURLOPT (CURLOPT_STREAM_WEIGHT , CURLOPTTYPE_LONG , 239 ),
19861988
19871989 /* Set stream dependency on another curl handle */
1988- CURLOPT (CURLOPT_STREAM_DEPENDS , CURLOPTTYPE_OBJECTPOINT , 240 ),
1990+ CURLOPTDEPRECATED (CURLOPT_STREAM_DEPENDS , CURLOPTTYPE_OBJECTPOINT , 240 ,
1991+ 8.21 .0 , "Has no function "),
19891992
19901993 /* Set E-xclusive stream dependency on another curl handle */
1991- CURLOPT (CURLOPT_STREAM_DEPENDS_E , CURLOPTTYPE_OBJECTPOINT , 241 ),
1994+ CURLOPTDEPRECATED (CURLOPT_STREAM_DEPENDS_E , CURLOPTTYPE_OBJECTPOINT , 241 ,
1995+ 8.21 .0 , "Has no function "),
19921996
19931997 /* Do not send any tftp option requests to the server */
19941998 CURLOPT (CURLOPT_TFTP_NO_OPTIONS , CURLOPTTYPE_LONG , 242 ),
@@ -2012,11 +2016,11 @@ typedef enum {
20122016 this option is used only if PROXY_SSL_VERIFYPEER is true */
20132017 CURLOPT (CURLOPT_PROXY_CAPATH , CURLOPTTYPE_STRINGPOINT , 247 ),
20142018
2015- /* Set if we should verify the proxy in ssl handshake,
2019+ /* Set if we should verify the proxy in SSL handshake,
20162020 set 1 to verify. */
20172021 CURLOPT (CURLOPT_PROXY_SSL_VERIFYPEER , CURLOPTTYPE_LONG , 248 ),
20182022
2019- /* Set if we should verify the Common name from the proxy certificate in ssl
2023+ /* Set if we should verify the Common name from the proxy certificate in SSL
20202024 * handshake, set 1 to check existence, 2 to ensure that it matches
20212025 * the provided hostname. */
20222026 CURLOPT (CURLOPT_PROXY_SSL_VERIFYHOST , CURLOPTTYPE_LONG , 249 ),
@@ -2808,14 +2812,14 @@ struct curl_slist {
28082812 * backend can also be specified via the name parameter (passing -1 as id). If
28092813 * both id and name are specified, the name is ignored. If neither id nor
28102814 * name are specified, the function fails with CURLSSLSET_UNKNOWN_BACKEND
2811- * and set the "avail" pointer to the NULL -terminated list of available
2815+ * and set the "avail" pointer to the null -terminated list of available
28122816 * backends.
28132817 *
28142818 * Upon success, the function returns CURLSSLSET_OK.
28152819 *
28162820 * If the specified SSL backend is not available, the function returns
28172821 * CURLSSLSET_UNKNOWN_BACKEND and sets the "avail" pointer to a
2818- * NULL -terminated list of available SSL backends.
2822+ * null -terminated list of available SSL backends.
28192823 *
28202824 * The SSL backend can be set only once. If it has already been set, a
28212825 * subsequent attempt to change it results in a CURLSSLSET_TOO_LATE.
0 commit comments