CURLOPT_KRBLEVEL.3 1.4 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647
  1. .\" generated by cd2nroff 0.1 from CURLOPT_KRBLEVEL.md
  2. .TH CURLOPT_KRBLEVEL 3 "2025-01-17" libcurl
  3. .SH NAME
  4. CURLOPT_KRBLEVEL \- FTP kerberos security level
  5. .SH SYNOPSIS
  6. .nf
  7. #include <curl/curl.h>
  8. CURLcode curl_easy_setopt(CURL *handle, CURLOPT_KRBLEVEL, char *level);
  9. .fi
  10. .SH DESCRIPTION
  11. Pass a char pointer as parameter. Set the kerberos security level for FTP;
  12. this also enables kerberos awareness. This is a string that should match one
  13. of the following: &\(aqclear\(aq, &\(aqsafe\(aq, &\(aqconfidential\(aq or &\(aqprivate\(aq. If the
  14. string is set but does not match one of these, \(aqprivate\(aq is used. Set the
  15. string to NULL to disable kerberos support for FTP.
  16. The application does not have to keep the string around after setting this
  17. option.
  18. .SH DEFAULT
  19. NULL
  20. .SH PROTOCOLS
  21. This functionality affects ftp only
  22. .SH EXAMPLE
  23. .nf
  24. int main(void)
  25. {
  26. CURL *curl = curl_easy_init();
  27. if(curl) {
  28. CURLcode res;
  29. curl_easy_setopt(curl, CURLOPT_URL, "ftp://example.com/foo.bin");
  30. curl_easy_setopt(curl, CURLOPT_KRBLEVEL, "private");
  31. res = curl_easy_perform(curl);
  32. curl_easy_cleanup(curl);
  33. }
  34. }
  35. .fi
  36. .SH HISTORY
  37. This option was known as CURLOPT_KRB4LEVEL up to 7.16.3
  38. .SH AVAILABILITY
  39. Added in curl 7.16.4
  40. .SH RETURN VALUE
  41. Returns CURLE_OK if the option is supported, CURLE_UNKNOWN_OPTION if not, or
  42. CURLE_OUT_OF_MEMORY if there was insufficient heap space.
  43. .SH SEE ALSO
  44. .BR CURLOPT_KRBLEVEL (3),
  45. .BR CURLOPT_USE_SSL (3)