plucky (3) CURLOPT_KRBLEVEL.3.gz

Provided by: libcurl4-doc_8.12.1-2ubuntu1_all bug

NAME

       CURLOPT_KRBLEVEL - FTP kerberos security level

SYNOPSIS

       #include <curl/curl.h>

       CURLcode curl_easy_setopt(CURL *handle, CURLOPT_KRBLEVEL, char *level);

DESCRIPTION

       Pass  a  char  pointer  as parameter. Set the kerberos security level for FTP; this also enables kerberos
       awareness. This is a string that should match one of the following: &'clear', &'safe', &'confidential' or
       &'private'.  If  the  string is set but does not match one of these, 'private' is used. Set the string to
       NULL to disable kerberos support for FTP.

       The application does not have to keep the string around after setting this option.

       The application does not have to keep the string around after setting this option.

DEFAULT

       NULL

PROTOCOLS

       This functionality affects ftp only

EXAMPLE

       int main(void)
       {
         CURL *curl = curl_easy_init();
         if(curl) {
           CURLcode res;
           curl_easy_setopt(curl, CURLOPT_URL, "ftp://example.com/foo.bin");
           curl_easy_setopt(curl, CURLOPT_KRBLEVEL, "private");
           res = curl_easy_perform(curl);
           curl_easy_cleanup(curl);
         }
       }

HISTORY

       This option was known as CURLOPT_KRB4LEVEL up to 7.16.3

AVAILABILITY

       Added in curl 7.16.4

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_KRBLEVEL(3), CURLOPT_USE_SSL(3)