generic-library/curl
1
0
Fork 0
Code Issues Pull Requests Releases Wiki Activity

CURLOPT_NOBODY.3: clarify this option is for downloads

Browse Source 
When enabling CURLOPT_NOBODY, libcurl effectively switches off upload
mode and will do a download (without a body). This is now better
explained in this man page.

Bug: http://curl.haxx.se/mail/lib-2014-08/0236.html
Reported-by: John Coffey
This commit is contained in:
Daniel Stenberg
2014-08-27 23:59:54 +02:00
parent 1cd5008bba
commit 1d30f40950
1 changed files with 6 additions and 3 deletions
Download Patch File Download Diff File Expand all files Collapse all files

9
docs/libcurl/opts/CURLOPT_NOBODY.3
View File

@@ -22,15 +22,18 @@
.\" .\"
.TH CURLOPT_NOBODY 3 "17 Jun 2014" "libcurl 7.37.0" "curl_easy_setopt options" .TH CURLOPT_NOBODY 3 "17 Jun 2014" "libcurl 7.37.0" "curl_easy_setopt options"
.SH NAME .SH NAME
CURLOPT_NOBODY \- do the request without getting the body CURLOPT_NOBODY \- do the download request without getting the body
.SH SYNOPSIS .SH SYNOPSIS
#include <curl/curl.h> #include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_NOBODY, long opt); CURLcode curl_easy_setopt(CURL *handle, CURLOPT_NOBODY, long opt);
.SH DESCRIPTION .SH DESCRIPTION
A long parameter set to 1 tells libcurl to not include the body-part in the A long parameter set to 1 tells libcurl to not include the body-part in the
output. For HTTP(S), this makes libcurl do a HEAD request. For most other output when doing what would otherwise be a download. For HTTP(S), this makes
protocols it means just not asking to transfer the body data. libcurl do a HEAD request. For most other protocols it means just not asking
to transfer the body data.
Enabling this option means asking for a download but without a body.
.SH DEFAULT .SH DEFAULT
0, the body is transferred 0, the body is transferred
.SH PROTOCOLS .SH PROTOCOLS