CURLOPT_VERBOSE.md (1594B)
1 --- 2 c: Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al. 3 SPDX-License-Identifier: curl 4 Title: CURLOPT_VERBOSE 5 Section: 3 6 Source: libcurl 7 See-also: 8 - CURLOPT_DEBUGFUNCTION (3) 9 - CURLOPT_ERRORBUFFER (3) 10 - CURLOPT_STDERR (3) 11 - curl_global_trace (3) 12 Protocol: 13 - All 14 Added-in: 7.1 15 --- 16 17 # NAME 18 19 CURLOPT_VERBOSE - verbose mode 20 21 # SYNOPSIS 22 23 ~~~c 24 #include <curl/curl.h> 25 26 CURLcode curl_easy_setopt(CURL *handle, CURLOPT_VERBOSE, long onoff); 27 ~~~ 28 29 # DESCRIPTION 30 31 Set the *onoff* parameter to 1 to make the library display a lot of verbose 32 information about its operations on this *handle*. Useful for libcurl and/or 33 protocol debugging and understanding. The verbose information is sent to 34 stderr, or the stream set with CURLOPT_STDERR(3). 35 36 You hardly ever want this enabled in production use, you almost always want 37 this used when you debug/report problems. 38 39 To also get all the protocol data sent and received, consider using the 40 CURLOPT_DEBUGFUNCTION(3). 41 42 **WARNING** this may show sensitive contents from headers and data. 43 44 # DEFAULT 45 46 0, meaning disabled. 47 48 # %PROTOCOLS% 49 50 # EXAMPLE 51 52 ~~~c 53 int main(void) 54 { 55 CURL *curl = curl_easy_init(); 56 if(curl) { 57 curl_easy_setopt(curl, CURLOPT_URL, "https://example.com"); 58 59 /* ask libcurl to show us the verbose output */ 60 curl_easy_setopt(curl, CURLOPT_VERBOSE, 1L); 61 62 /* Perform the request */ 63 curl_easy_perform(curl); 64 } 65 } 66 ~~~ 67 68 # %AVAILABILITY% 69 70 # RETURN VALUE 71 72 curl_easy_setopt(3) returns a CURLcode indicating success or error. 73 74 CURLE_OK (0) means everything was OK, non-zero means an error occurred, see 75 libcurl-errors(3).