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 level);
12

DESCRIPTION

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

DEFAULT

23       CURLGSSAPI_DELEGATION_NONE
24

PROTOCOLS

26       HTTP
27

EXAMPLE

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

AVAILABILITY

41       Added in 7.22.0
42

RETURN VALUE

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