CURLOPT_HSTSWRITEDATA(3)

1CURLOPT_HSTSWRITEDATA(3)   curl_easy_setopt options   CURLOPT_HSTSWRITEDATA(3)
2
3
4

NAME

6       CURLOPT_HSTSWRITEDATA - pointer passed to the HSTS write callback
7

SYNOPSIS

9       #include <curl/curl.h>
10
11       CURLcode  curl_easy_setopt(CURL  *handle,  CURLOPT_HSTSWRITEDATA,  void
12       *pointer);
13

EXPERIMENTAL

15       Warning: this feature is early code and is marked as  experimental.  It
16       can only be enabled by explicitly telling configure with --enable-hsts.
17       You are advised to not ship this in production before the  experimental
18       label is removed.
19

DESCRIPTION

21       Data  pointer  to  pass to the HSTS write function. If you use the CUR‐
22       LOPT_HSTSWRITEFUNCTION(3) option, this is the pointer you'll get as in‐
23       put in the 4th argument to the callback.
24
25       This  option  doesn't enable HSTS, you need to use CURLOPT_HSTS_CTRL(3)
26       to do that.
27

DEFAULT

29       NULL
30

PROTOCOLS

32       This feature is only used for HTTP(S) transfer.
33

EXAMPLE

35       CURL *curl = curl_easy_init();
36       struct MyData this;
37       if(curl) {
38         curl_easy_setopt(curl, CURLOPT_URL, "http://example.com");
39
40         /* pass pointer that gets passed in to the
41            CURLOPT_HSTSWRITEFUNCTION callback */
42         curl_easy_setopt(curl, CURLOPT_HSTSWRITEDATA, &this);
43
44         curl_easy_perform(curl);
45       }
46

AVAILABILITY

48       Added in 7.74.0
49

RETURN VALUE

51       This will return CURLE_OK.
52