CURLOPT_FAILONERROR(3)

CURLOPT_FAILONERROR(3curl_easy_setopt optionCURLOPT_FAILONERROR(3)

NAME

     CURLOPT_FAILONERROR - request failure on  HTTP  response  >=
     400

SYNOPSIS

     #include <curl/curl.h>

     CURLcode curl_easy_setopt(CURL *handle, CURLOPT_FAILONERROR,
     long fail);

DESCRIPTION

     A long parameter set to 1 tells  the  library  to  fail  the
     request if the HTTP code returned is equal to or larger than
     400. The default action would be to  return  the  page  nor-
     mally, ignoring that code.

     This method is not fail-safe and there are  occasions  where
     non-successful  response codes will slip through, especially
     when authentication is  involved  (response  codes  401  and
     407).

     You might get some amounts  of  headers  transferred  before
     this  situation  is  detected, like when a "100-continue" is
     received as a response to a POST/PUT and a  401  or  407  is
     received immediately afterwards.

     When this option is used and an error is detected,  it  will
     cause     the     connection     to     get    closed    and
     CURLE_HTTP_RETURNED_ERROR is returned.

DEFAULT

     0, do not fail on error

PROTOCOLS

     HTTP

EXAMPLE

     CURL *curl = curl_easy_init();
     if(curl) {
       CURLcode ret;
       curl_easy_setopt(curl, CURLOPT_URL, "https://example.com/");
       curl_easy_setopt(curl, CURLOPT_FAILONERROR, 1L);
       ret = curl_easy_perform(curl);
       if(ret == CURLE_HTTP_RETURNED_ERROR) {
         /* a HTTP response error problem */
       }
     }

AVAILABILITY

     Along with HTTP.

libcurl 7.58.0      Last change: May 30, 2017                   1

CURLOPT_FAILONERROR(3curl_easy_setopt optionCURLOPT_FAILONERROR(3)

RETURN VALUE

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

SEE ALSO

     CURLOPT_HTTP200ALIASES(3), CURLOPT_KEEP_SENDING_ON_ERROR(3),

libcurl 7.58.0      Last change: May 30, 2017                   2