CURLOPT_KEEP_SENDING_ON_ERROR(3)

1CURLOPT_KEEP_SENDING_ON_ERROcRu(r3l)_easy_setopt optCiUoRnLsOPT_KEEP_SENDING_ON_ERROR(3)
2
3
4

NAME

6       CURLOPT_KEEP_SENDING_ON_ERROR  - keep sending on early HTTP response >=
7       300
8

SYNOPSIS

10       #include <curl/curl.h>
11
12       CURLcode curl_easy_setopt(CURL *handle, CURLOPT_KEEP_SENDING_ON_ERROR,
13                                 long keep_sending);
14

DESCRIPTION

16       A long parameter set to 1 tells the library to keep sending the request
17       body  if  the  HTTP  code  returned is equal to or larger than 300. The
18       default action would be to stop sending and close the stream or connec‐
19       tion.
20
21       This  option  is  suitable  for  manual NTLM authentication, i.e. if an
22       application does not use CURLOPT_HTTPAUTH(3), but instead sets  "Autho‐
23       rization: NTLM ..."  headers manually using CURLOPT_HTTPHEADER(3).
24
25       Most applications do not need this option.
26

DEFAULT

28       0, stop sending on error
29

PROTOCOLS

31       HTTP
32

EXAMPLE

34       CURL *curl = curl_easy_init();
35       if(curl) {
36         CURLcode ret;
37         curl_easy_setopt(curl, CURLOPT_URL, "https://example.com/");
38         curl_easy_setopt(curl, CURLOPT_POSTFIELDS, "sending data");
39         curl_easy_setopt(curl, CURLOPT_KEEP_SENDING_ON_ERROR, 1L);
40         ret = curl_easy_perform(curl);
41       }
42

AVAILABILITY

44       Along with HTTP. Added in 7.51.0.
45

RETURN VALUE

47       Returns CURLE_OK if HTTP is enabled, and CURLE_UNKNOWN_OPTION if not.
48