Section: curl_easy_setopt options (3)
Updated: November 04, 2020
CURLOPT_HSTSREADDATA - pointer passed to the HSTS read callback
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_HSTSREADDATA, void *pointer);
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
to pass to the HSTS read function. If you use the
option, this is the pointer you'll get as
input in the 3rd argument to the callback.
This option doesn't enable HSTS, you need to use CURLOPT_HSTS_CTRL(3) to
This feature is only used for HTTP(S) transfer.
CURL *curl = curl_easy_init();
struct MyData this;
curl_easy_setopt(curl, CURLOPT_URL, "http://example.com");
/* pass pointer that gets passed in to the
CURLOPT_HSTSREADFUNCTION callback */
curl_easy_setopt(curl, CURLOPT_HSTSREADDATA, &this);
Added in 7.74.0
This will return CURLE_OK.