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

FreeBSD Manual Pages

  
 
  

home | help
CURLOPT_STREAM_DEPENDS(3)  curl_easy_setopt options  CURLOPT_STREAM_DEPENDS(3)

NAME
       CURLOPT_STREAM_DEPENDS -	set stream this	transfer depends on

SYNOPSIS
       #include	<curl/curl.h>

       CURLcode	 curl_easy_setopt(CURL	*handle,  CURLOPT_STREAM_DEPENDS, CURL
       *dephandle);

DESCRIPTION
       Pass a CURL * pointer in	dephandle to identify the  stream  within  the
       same  connection	that this stream is depending upon. This option	clears
       the exclusive bit and is	mutually exclusive to  the  CURLOPT_STREAM_DE-
       PENDS_E(3) option.

       The  spec  says "Including a dependency expresses a preference to allo-
       cate resources to the identified	stream rather than  to	the  dependent
       stream."

       This option can be set during transfer.

       dephandle must not be the same as handle, that will cause this function
       to return an error. It must be another easy handle, and it  also	 needs
       to  be  a  handle  of a transfer	that will be sent over the same	HTTP/2
       connection for this option to have an actual effect.

DEFAULT
       NULL

PROTOCOLS
       HTTP/2

EXAMPLE
       CURL *curl = curl_easy_init();
       CURL *curl2 = curl_easy_init(); /* a second handle */
       if(curl)	{
	 curl_easy_setopt(curl,	CURLOPT_URL, "https://example.com/one");

	 /* the	second depends on the first */
	 curl_easy_setopt(curl2, CURLOPT_URL, "https://example.com/two");
	 curl_easy_setopt(curl2, CURLOPT_STREAM_DEPENDS, curl);

	 /* then add both to a multi handle and	transfer them! */
       }

AVAILABILITY
       Added in	7.46.0

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

SEE ALSO
       CURLOPT_STREAM_WEIGHT(3), CURLOPT_STREAM_DEPENDS_E(3),

libcurl	7.72.0			 May 31, 2017	     CURLOPT_STREAM_DEPENDS(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_STREAM_DEPENDS&sektion=3&manpath=FreeBSD+12.1-RELEASE+and+Ports>

home | help