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