CURLOPT_VERBOSE.3 1.4 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950
  1. .\" generated by cd2nroff 0.1 from CURLOPT_VERBOSE.md
  2. .TH CURLOPT_VERBOSE 3 "2025-01-17" libcurl
  3. .SH NAME
  4. CURLOPT_VERBOSE \- verbose mode
  5. .SH SYNOPSIS
  6. .nf
  7. #include <curl/curl.h>
  8. CURLcode curl_easy_setopt(CURL *handle, CURLOPT_VERBOSE, long onoff);
  9. .fi
  10. .SH DESCRIPTION
  11. Set the \fIonoff\fP parameter to 1 to make the library display a lot of
  12. verbose information about its operations on this \fIhandle\fP. Useful for
  13. libcurl and/or protocol debugging and understanding. The verbose information
  14. is sent to stderr, or the stream set with \fICURLOPT_STDERR(3)\fP.
  15. You hardly ever want this enabled in production use, you almost always want
  16. this used when you debug/report problems.
  17. To also get all the protocol data sent and received, consider using the
  18. \fICURLOPT_DEBUGFUNCTION(3)\fP.
  19. .SH DEFAULT
  20. 0, meaning disabled.
  21. .SH PROTOCOLS
  22. This functionality affects all supported protocols
  23. .SH EXAMPLE
  24. .nf
  25. int main(void)
  26. {
  27. CURL *curl = curl_easy_init();
  28. if(curl) {
  29. curl_easy_setopt(curl, CURLOPT_URL, "https://example.com");
  30. /* ask libcurl to show us the verbose output */
  31. curl_easy_setopt(curl, CURLOPT_VERBOSE, 1L);
  32. /* Perform the request */
  33. curl_easy_perform(curl);
  34. }
  35. }
  36. .fi
  37. .SH AVAILABILITY
  38. Added in curl 7.1
  39. .SH RETURN VALUE
  40. Returns CURLE_OK
  41. .SH SEE ALSO
  42. .BR CURLOPT_DEBUGFUNCTION (3),
  43. .BR CURLOPT_ERRORBUFFER (3),
  44. .BR CURLOPT_STDERR (3),
  45. .BR curl_global_trace (3)