CURLOPT_GSSAPI_DELEGATION.md (1522B)
1 --- 2 c: Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al. 3 SPDX-License-Identifier: curl 4 Title: CURLOPT_GSSAPI_DELEGATION 5 Section: 3 6 Source: libcurl 7 Protocol: 8 - HTTP 9 See-also: 10 - CURLOPT_HTTPAUTH (3) 11 - CURLOPT_PROXYAUTH (3) 12 Added-in: 7.22.0 13 --- 14 15 # NAME 16 17 CURLOPT_GSSAPI_DELEGATION - allowed GSS-API delegation 18 19 # SYNOPSIS 20 21 ~~~c 22 #include <curl/curl.h> 23 24 CURLcode curl_easy_setopt(CURL *handle, CURLOPT_GSSAPI_DELEGATION, long level); 25 ~~~ 26 27 # DESCRIPTION 28 29 Set the long parameter *level* to **CURLGSSAPI_DELEGATION_FLAG** to allow 30 unconditional GSSAPI credential delegation. The delegation is disabled by 31 default since 7.21.7. Set the parameter to 32 **CURLGSSAPI_DELEGATION_POLICY_FLAG** to delegate only if the OK-AS-DELEGATE 33 flag is set in the service ticket in case this feature is supported by the 34 GSS-API implementation and the definition of *GSS_C_DELEG_POLICY_FLAG* was 35 available at compile-time. 36 37 # DEFAULT 38 39 CURLGSSAPI_DELEGATION_NONE 40 41 # %PROTOCOLS% 42 43 # EXAMPLE 44 45 ~~~c 46 int main(void) 47 { 48 CURL *curl = curl_easy_init(); 49 if(curl) { 50 CURLcode ret; 51 curl_easy_setopt(curl, CURLOPT_URL, "https://example.com/"); 52 /* delegate if okayed by policy */ 53 curl_easy_setopt(curl, CURLOPT_GSSAPI_DELEGATION, 54 (long)CURLGSSAPI_DELEGATION_POLICY_FLAG); 55 ret = curl_easy_perform(curl); 56 } 57 } 58 ~~~ 59 60 # %AVAILABILITY% 61 62 # RETURN VALUE 63 64 curl_easy_setopt(3) returns a CURLcode indicating success or error. 65 66 CURLE_OK (0) means everything was OK, non-zero means an error occurred, see 67 libcurl-errors(3).