xenial (3) CURLOPT_FAILONERROR.3.gz

Provided by: libcurl4-doc_7.47.0-1ubuntu2.19_all bug

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 normally, 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.


DEFAULT
       0, do not fail on error


PROTOCOLS
       HTTP


EXAMPLE
       TODO


AVAILABILITY
       Along with HTTP


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


SEE ALSO
       CURLOPT_HTTP200ALIASES(3),