quickjs-tart

quickjs-based runtime for wallet-core logic
Log | Files | Refs | README | LICENSE

CURLOPT_SSL_SIGNATURE_ALGORITHMS.md (1850B)

      1 ---
      2 c: Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
      3 SPDX-License-Identifier: curl
      4 Title: CURLOPT_SSL_SIGNATURE_ALGORITHMS
      5 Section: 3
      6 Source: libcurl
      7 See-also:
      8   - CURLOPT_SSL_CIPHER_LIST (3)
      9   - CURLOPT_SSL_EC_CURVES (3)
     10   - CURLOPT_SSLVERSION (3)
     11   - CURLOPT_USE_SSL (3)
     12 Protocol:
     13   - TLS
     14 TLS-backend:
     15   - OpenSSL
     16 Added-in: 8.14.0
     17 ---
     18 
     19 # NAME
     20 
     21 CURLOPT_SSL_SIGNATURE_ALGORITHMS - signature algorithms to use for TLS
     22 
     23 # SYNOPSIS
     24 
     25 ~~~c
     26 #include <curl/curl.h>
     27 
     28 CURLcode curl_easy_setopt(CURL *handle, CURLOPT_SSL_SIGNATURE_ALGORITHMS, char *list);
     29 ~~~
     30 
     31 # DESCRIPTION
     32 
     33 Pass a char pointer, pointing to a null-terminated string holding the list of
     34 signature algorithms to use for the TLS connection. The list must be syntactically
     35 correct, it consists of one or more signature algorithm strings separated by colons.
     36 
     37 A valid example of a signature algorithms list with OpenSSL is:
     38 ~~~
     39 "DSA+SHA256:rsa_pss_pss_sha256"
     40 ~~~
     41 
     42 The application does not have to keep the string around after setting this
     43 option.
     44 
     45 Using this option multiple times makes the last set string override the
     46 previous ones. Set it to NULL to disable its use again.
     47 
     48 Works with OpenSSL and its BoringSSL fork (added in 8.14.0).
     49 
     50 # DEFAULT
     51 
     52 NULL, use built-in list
     53 
     54 # %PROTOCOLS%
     55 
     56 # EXAMPLE
     57 
     58 ~~~c
     59 int main(void)
     60 {
     61   CURL *curl = curl_easy_init();
     62   if(curl) {
     63     CURLcode res;
     64     curl_easy_setopt(curl, CURLOPT_URL, "https://example.com/");
     65     curl_easy_setopt(curl, CURLOPT_SSL_SIGNATURE_ALGORITHMS,
     66                      "DSA+SHA256:rsa_pss_pss_sha256");
     67     res = curl_easy_perform(curl);
     68     curl_easy_cleanup(curl);
     69   }
     70 }
     71 ~~~
     72 
     73 # HISTORY
     74 
     75 OpenSSL support added in 8.14.0.
     76 
     77 # %AVAILABILITY%
     78 
     79 # RETURN VALUE
     80 
     81 curl_easy_setopt(3) returns a CURLcode indicating success or error.
     82 
     83 CURLE_OK (0) means everything was OK, non-zero means an error occurred, see
     84 libcurl-errors(3).