CURLOPT_HSTSWRITEDATA
Section: curl_easy_setopt options (3)
Updated: November 04, 2020
Page Index
NAME
CURLOPT_HSTSWRITEDATA - pointer passed to the HSTS write callback
SYNOPSIS
#include <
curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_HSTSWRITEDATA, void *pointer);
EXPERIMENTAL
Warning: this feature is early code and is marked as experimental. It can only
be enabled by explicitly telling configure with
--enable-hsts. You are
advised to not ship this in production before the experimental label is
removed.
DESCRIPTION
Data
pointer to pass to the HSTS write function. If you use the
CURLOPT_HSTSWRITEFUNCTION(3) option, this is the pointer you'll get as
input in the 4th argument to the callback.
This option doesn't enable HSTS, you need to use CURLOPT_HSTS_CTRL(3) to
do that.
DEFAULT
NULL
PROTOCOLS
This feature is only used for HTTP(S) transfer.
EXAMPLE
CURL *curl = curl_easy_init();
struct MyData this;
if(curl) {
curl_easy_setopt(curl, CURLOPT_URL, "http://example.com");
/* pass pointer that gets passed in to the
CURLOPT_HSTSWRITEFUNCTION callback */
curl_easy_setopt(curl, CURLOPT_HSTSWRITEDATA, &this);
curl_easy_perform(curl);
}
AVAILABILITY
Added in 7.74.0
RETURN VALUE
This will return CURLE_OK.
SEE ALSO
CURLOPT_HSTSWRITEFUNCTION(3),
CURLOPT_HSTSREADDATA(3),
CURLOPT_HSTSREADFUNCTION(3),