CURLOPT_REQUEST_TARGET(3)

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

NAME

6       CURLOPT_REQUEST_TARGET - specify an alternative target for this request
7

SYNOPSIS

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

DESCRIPTION

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

DEFAULT

19       NULL
20

PROTOCOLS

22       HTTP
23

EXAMPLE

25       curl = curl_easy_init();
26       if(curl) {
27         curl_easy_setopt(curl, CURLOPT_URL, "http://example.com/*");
28         curl_easy_setopt(curl, CURLOPT_CUSTOMREQUEST, "OPTIONS");
29
30         /* issue an OPTIONS * request (no leading slash) */
31         curl_easy_setopt(curl, CURLOPT_REQUEST_TARGET, "*");
32
33         /* Perform the request */
34         curl_easy_perform(curl);
35       }
36

AVAILABILITY

38       Added in 7.55.0
39

RETURN VALUE

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