CURLOPT_KRBLEVEL.md (1551B)
1 --- 2 c: Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al. 3 SPDX-License-Identifier: curl 4 Title: CURLOPT_KRBLEVEL 5 Section: 3 6 Source: libcurl 7 See-also: 8 - CURLOPT_KRBLEVEL (3) 9 - CURLOPT_USE_SSL (3) 10 Protocol: 11 - FTP 12 Added-in: 7.16.4 13 --- 14 15 # NAME 16 17 CURLOPT_KRBLEVEL - FTP kerberos security level 18 19 # SYNOPSIS 20 21 ~~~c 22 #include <curl/curl.h> 23 24 CURLcode curl_easy_setopt(CURL *handle, CURLOPT_KRBLEVEL, char *level); 25 ~~~ 26 27 # DESCRIPTION 28 29 Pass a char pointer as parameter. Set the kerberos security level for FTP; 30 this also enables kerberos awareness. This is a string that should match one 31 of the following: &'clear', &'safe', &'confidential' or &'private'. If the 32 string is set but does not match one of these, 'private' is used. Set the 33 string to NULL to disable kerberos support for FTP. 34 35 The application does not have to keep the string around after setting this 36 option. 37 38 The application does not have to keep the string around after setting this 39 option. 40 41 # DEFAULT 42 43 NULL 44 45 # %PROTOCOLS% 46 47 # EXAMPLE 48 49 ~~~c 50 int main(void) 51 { 52 CURL *curl = curl_easy_init(); 53 if(curl) { 54 CURLcode res; 55 curl_easy_setopt(curl, CURLOPT_URL, "ftp://example.com/foo.bin"); 56 curl_easy_setopt(curl, CURLOPT_KRBLEVEL, "private"); 57 res = curl_easy_perform(curl); 58 curl_easy_cleanup(curl); 59 } 60 } 61 ~~~ 62 63 # HISTORY 64 65 This option was known as CURLOPT_KRB4LEVEL up to 7.16.3 66 67 # %AVAILABILITY% 68 69 # RETURN VALUE 70 71 curl_easy_setopt(3) returns a CURLcode indicating success or error. 72 73 CURLE_OK (0) means everything was OK, non-zero means an error occurred, see 74 libcurl-errors(3).