DragonFly On-Line Manual Pages

Search: Section:  

CURLOPT_SASL_IR(3)                  libcurl                 CURLOPT_SASL_IR(3)


NAME

       CURLOPT_SASL_IR - send initial response in first packet


SYNOPSIS

       #include <curl/curl.h>

       CURLcode curl_easy_setopt(CURL *handle, CURLOPT_SASL_IR, long enable);


DESCRIPTION

       Pass a long. If the value is 1, curl will send the initial response to
       the server in the first authentication packet in order to reduce the
       number of ping pong requests. Only applicable to the following
       supporting SASL authentication mechanisms:

       * Login * Plain * GSSAPI * NTLM * OAuth 2.0

       Note: Whilst IMAP supports this option there is no need to explicitly
       set it, as libcurl can determine the feature itself when the server
       supports the SASL-IR CAPABILITY.


DEFAULT

       0


PROTOCOLS

       IMAP, POP3 and SMTP


EXAMPLE

       CURL *curl = curl_easy_init();
       if(curl) {
         curl_easy_setopt(curl, CURLOPT_URL, "smtp://example.com/");
         curl_easy_setopt(curl, CURLOPT_SASL_IR, 1L);
         ret = curl_easy_perform(curl);
         curl_easy_cleanup(curl);
       }


AVAILABILITY

       Added in 7.31.0


RETURN VALUE

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


SEE ALSO

       CURLOPT_MAIL_AUTH(3), CURLOPT_MAIL_FROM(3),

ibcurl 8.1.2                    April 26, 2023              CURLOPT_SASL_IR(3)

Search: Section: