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