CURLOPT_GSSAPI_DELEGATION(3)

1CURLOPT_GSSAPI_DELEGATION(3)curl_easy_setopt optionsCURLOPT_GSSAPI_DELEGATION(3)
2
3
4

NAME

6       CURLOPT_GSSAPI_DELEGATION - allowed GSS-API delegation
7

SYNOPSIS

9       #include <curl/curl.h>
10
11       CURLcode curl_easy_setopt(CURL *handle, CURLOPT_GSSAPI_DELEGATION, long
12       level);
13

DESCRIPTION

15       Set the long parameter level to CURLGSSAPI_DELEGATION_FLAG to allow un‐
16       conditional GSSAPI credential delegation. The delegation is disabled by
17       default since 7.21.7.  Set the parameter to  CURLGSSAPI_DELEGATION_POL‐
18       ICY_FLAG to delegate only if the OK-AS-DELEGATE flag is set in the ser‐
19       vice ticket in case this feature is supported by the GSS-API  implemen‐
20       tation  and  the definition of GSS_C_DELEG_POLICY_FLAG was available at
21       compile-time.
22

DEFAULT

24       CURLGSSAPI_DELEGATION_NONE
25

PROTOCOLS

27       HTTP
28

EXAMPLE

30       CURL *curl = curl_easy_init();
31       if(curl) {
32         CURLcode ret;
33         curl_easy_setopt(curl, CURLOPT_URL, "https://example.com/");
34         /* delegate if okayed by policy */
35         curl_easy_setopt(curl, CURLOPT_GSSAPI_DELEGATION,
36                                CURLGSSAPI_DELEGATION_POLICY_FLAG);
37         ret = curl_easy_perform(curl);
38       }
39
40

AVAILABILITY

42       Added in 7.22.0
43

RETURN VALUE

45       Returns CURLE_OK if the option is supported,  and  CURLE_UNKNOWN_OPTION
46       if not.
47