CURLOPT_SASL_IR(3)

1CURLOPT_SASL_IR(3)         curl_easy_setopt options         CURLOPT_SASL_IR(3)
2
3
4

NAME

6       CURLOPT_SASL_IR - send initial response in first packet
7

SYNOPSIS

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

DESCRIPTION

14       Pass  a long. If the value is 1, curl will send the initial response to
15       the server in the first authentication packet in order  to  reduce  the
16       number of ping pong requests. Only applicable to the following support‐
17       ing SASL authentication mechanisms:
18
19       * Login * Plain * GSSAPI * NTLM * OAuth 2.0
20
21       Note: Whilst IMAP supports this option there is no need  to  explicitly
22       set  it,  as  libcurl  can determine the feature itself when the server
23       supports the SASL-IR CAPABILITY.
24

DEFAULT

26       0
27

PROTOCOLS

29       IMAP, POP3 and SMTP
30

EXAMPLE

32       CURL *curl = curl_easy_init();
33       if(curl) {
34         curl_easy_setopt(curl, CURLOPT_URL, "smtp://example.com/");
35         curl_easy_setopt(curl, CURLOPT_SASL_IR, 1L);
36         ret = curl_easy_perform(curl);
37         curl_easy_cleanup(curl);
38       }
39

AVAILABILITY

41       Added in 7.31.0
42

RETURN VALUE

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