Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
CURLOPT_FAILONERROR(3)	   curl_easy_setopt options	CURLOPT_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 normally, ignoring that code.

       This method is not fail-safe and	there are occasions where non-success-
       ful 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.

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.54.1			 May 30, 2017		CURLOPT_FAILONERROR(3)

NAME | SYNOPSIS | DESCRIPTION | DEFAULT | PROTOCOLS | EXAMPLE | AVAILABILITY | RETURN VALUE | SEE ALSO

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=CURLOPT_FAILONERROR&sektion=3&manpath=FreeBSD+12.0-RELEASE+and+Ports>

home | help