FreeBSD Manual Pages
CURLOPT_HTTPGET(3) Library Functions Manual CURLOPT_HTTPGET(3) NAME CURLOPT_HTTPGET - ask for an HTTP GET request SYNOPSIS #include <curl/curl.h> CURLcode curl_easy_setopt(CURL *handle, CURLOPT_HTTPGET, long useget); DESCRIPTION Pass a long. If useget is 1, this forces the HTTP request to get back to using GET. Usable if a POST, HEAD, PUT, etc has been used previously using the same curl handle. When setting CURLOPT_HTTPGET(3) to 1, libcurl automatically sets CUR- LOPT_NOBODY(3) to 0 and CURLOPT_UPLOAD(3) to 0. Setting this option to zero has no effect. Applications need to explic- itly select which HTTP request method to use, they cannot deselect a method. To reset a handle to default method, consider curl_easy_re- set(3). DEFAULT 0 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"); /* use a GET to fetch this */ curl_easy_setopt(curl, CURLOPT_HTTPGET, 1L); /* Perform the request */ curl_easy_perform(curl); } } AVAILABILITY Added in curl 7.8.1 RETURN VALUE curl_easy_setopt(3) returns a CURLcode indicating success or error. CURLE_OK (0) means everything was OK, non-zero means an error occurred, see libcurl-errors(3). SEE ALSO CURLOPT_NOBODY(3), CURLOPT_POST(3), CURLOPT_UPLOAD(3), curl_easy_re- set(3) libcurl 2025-06-03 CURLOPT_HTTPGET(3)
NAME | SYNOPSIS | DESCRIPTION | DEFAULT | PROTOCOLS | EXAMPLE | AVAILABILITY | RETURN VALUE | SEE ALSO
Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=CURLOPT_HTTPGET&sektion=3&manpath=FreeBSD+Ports+14.3.quarterly>