Provided by: libcurl4-doc_8.9.1-2ubuntu2.1_all bug

NAME

       CURLOPT_REQUEST_TARGET - alternative target for this request

SYNOPSIS

       #include <curl/curl.h>

       CURLcode curl_easy_setopt(CURL *handle, CURLOPT_REQUEST_TARGET, string);

DESCRIPTION

       Pass  a  char  pointer to string which libcurl uses in the upcoming request instead of the
       path as extracted from the URL.

       libcurl passes on the verbatim string in its request without  any  filter  or  other  safe
       guards. That includes white space and control characters.

DEFAULT

       NULL

PROTOCOLS

       This functionality affects http only

EXAMPLE

       int main(void)
       {
         CURL *curl = curl_easy_init();
         if(curl) {
           curl_easy_setopt(curl, CURLOPT_URL, "https://example.com/*");
           curl_easy_setopt(curl, CURLOPT_CUSTOMREQUEST, "OPTIONS");

           /* issue an OPTIONS * request (no leading slash) */
           curl_easy_setopt(curl, CURLOPT_REQUEST_TARGET, "*");

           /* Perform the request */
           curl_easy_perform(curl);
         }
       }

AVAILABILITY

       Added in curl 7.55.0

RETURN VALUE

       Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not.

SEE ALSO

       CURLOPT_CUSTOMREQUEST(3), CURLOPT_HTTPGET(3), CURLOPT_PATH_AS_IS(3), CURLOPT_URL(3)