diff options
author | Daniel Stenberg <daniel@haxx.se> | 2017-06-21 23:35:08 +0200 |
---|---|---|
committer | Daniel Stenberg <daniel@haxx.se> | 2017-06-21 23:39:10 +0200 |
commit | 9b167fd090f596eac828817d48c247eeae53407f (patch) | |
tree | d89ba04374722be9ca36d633a82e07616abbe0f6 /docs/libcurl/opts | |
parent | 8de8f4eb7e7c276eb2b2a2f7888c88d0779bed39 (diff) |
--request-target: instead of --strip-path-slash
... and CURLOPT_REQUEST_TARGET instead of CURLOPT_STRIP_PATH_SLASH.
This option instead provides the full "alternative" target to use in the
request, instead of extracting the path from the URL.
Test 1298 and 1299 updated accordingly.
Idea-by: Evert Pot
Suggestion: https://daniel.haxx.se/blog/2017/06/19/options-with-curl/comment-page-1/#comment-18373
Closes #1593
Diffstat (limited to 'docs/libcurl/opts')
-rw-r--r-- | docs/libcurl/opts/CURLOPT_CUSTOMREQUEST.3 | 2 | ||||
-rw-r--r-- | docs/libcurl/opts/CURLOPT_NOBODY.3 | 2 | ||||
-rw-r--r-- | docs/libcurl/opts/CURLOPT_REQUEST_TARGET.3 (renamed from docs/libcurl/opts/CURLOPT_STRIP_PATH_SLASH.3) | 14 | ||||
-rw-r--r-- | docs/libcurl/opts/Makefile.inc | 2 |
4 files changed, 10 insertions, 10 deletions
diff --git a/docs/libcurl/opts/CURLOPT_CUSTOMREQUEST.3 b/docs/libcurl/opts/CURLOPT_CUSTOMREQUEST.3 index e53504491..33cce250b 100644 --- a/docs/libcurl/opts/CURLOPT_CUSTOMREQUEST.3 +++ b/docs/libcurl/opts/CURLOPT_CUSTOMREQUEST.3 @@ -108,4 +108,4 @@ Returns CURLE_OK if the option is supported, CURLE_UNKNOWN_OPTION if not, or CURLE_OUT_OF_MEMORY if there was insufficient heap space. .SH "SEE ALSO" .BR CURLOPT_HTTPHEADER "(3), " CURLOPT_NOBODY "(3), " -.BR CURLOPT_STRIP_PATH_SLASH "(3), " +.BR CURLOPT_REQUEST_TARGET "(3), " diff --git a/docs/libcurl/opts/CURLOPT_NOBODY.3 b/docs/libcurl/opts/CURLOPT_NOBODY.3 index d0116a9ed..02590b212 100644 --- a/docs/libcurl/opts/CURLOPT_NOBODY.3 +++ b/docs/libcurl/opts/CURLOPT_NOBODY.3 @@ -57,4 +57,4 @@ Always Returns CURLE_OK .SH "SEE ALSO" .BR CURLOPT_HTTPGET "(3), " CURLOPT_POST "(3), " -.BR CURLOPT_STRIP_PATH_SLASH "(3), " +.BR CURLOPT_REQUEST_TARGET "(3), " diff --git a/docs/libcurl/opts/CURLOPT_STRIP_PATH_SLASH.3 b/docs/libcurl/opts/CURLOPT_REQUEST_TARGET.3 index 5d0886782..eabefaa2d 100644 --- a/docs/libcurl/opts/CURLOPT_STRIP_PATH_SLASH.3 +++ b/docs/libcurl/opts/CURLOPT_REQUEST_TARGET.3 @@ -20,18 +20,18 @@ .\" * .\" ************************************************************************** .\" -.TH CURLOPT_STRIP_PATH_SLASH 3 "17 Jun 2014" "libcurl 7.37.0" "curl_easy_setopt options" +.TH CURLOPT_REQUEST_TARGET 3 "17 Jun 2014" "libcurl 7.37.0" "curl_easy_setopt options" .SH NAME -CURLOPT_STRIP_PATH_SLASH \- strip the leading slash from the path +CURLOPT_REQUEST_TARGET \- specify an alternative target for this request .SH SYNOPSIS #include <curl/curl.h> -CURLcode curl_easy_setopt(CURL *handle, CURLOPT_STRIP_PATH_SLASH, value); +CURLcode curl_easy_setopt(CURL *handle, CURLOPT_REQUEST_TARGET, string); .SH DESCRIPTION -Pass a long set to 1 to tell libcurl to strip out the leading slash from the -path when used on the server. +Pass a char * to string which libcurl uses in the upcoming request instead of +the path as extracted from the URL. .SH DEFAULT -0 - use the leading slash. +NULL .SH PROTOCOLS HTTP .SH EXAMPLE @@ -42,7 +42,7 @@ if(curl) { curl_easy_setopt(curl, CURLOPT_CUSTOMREQUEST, "OPTIONS"); /* issue an OPTIONS * request (no leading slash) */ - curl_easy_setopt(curl, CURLOPT_STRIP_PATH_SLASH, 1L); + curl_easy_setopt(curl, CURLOPT_REQUEST_TARGET, "*"); /* Perform the request */ curl_easy_perform(curl); diff --git a/docs/libcurl/opts/Makefile.inc b/docs/libcurl/opts/Makefile.inc index 40930dc5d..c094604d9 100644 --- a/docs/libcurl/opts/Makefile.inc +++ b/docs/libcurl/opts/Makefile.inc @@ -231,6 +231,7 @@ man_MANS = \ CURLOPT_READFUNCTION.3 \ CURLOPT_REDIR_PROTOCOLS.3 \ CURLOPT_REFERER.3 \ + CURLOPT_REQUEST_TARGET.3 \ CURLOPT_RESOLVE.3 \ CURLOPT_RESUME_FROM.3 \ CURLOPT_RESUME_FROM_LARGE.3 \ @@ -278,7 +279,6 @@ man_MANS = \ CURLOPT_STREAM_DEPENDS.3 \ CURLOPT_STREAM_DEPENDS_E.3 \ CURLOPT_STREAM_WEIGHT.3 \ - CURLOPT_STRIP_PATH_SLASH.3 \ CURLOPT_SUPPRESS_CONNECT_HEADERS.3 \ CURLOPT_TCP_FASTOPEN.3 \ CURLOPT_TCP_KEEPALIVE.3 \ |