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

FreeBSD Manual Pages

  
 
  

home | help
CURLOPT_ST..._DEPENDS_E(3) Library Functions Manual CURLOPT_ST..._DEPENDS_E(3)

NAME
       CURLOPT_STREAM_DEPENDS_E	- stream this transfer depends on exclusively

SYNOPSIS
       #include	<curl/curl.h>

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

DESCRIPTION
       Pass a CURL pointer in dephandle	to identify the	stream within the same
       connection  that	 this stream is	depending upon exclusively. That means
       it depends on it	and sets the Exclusive bit.

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

       Setting a dependency with the exclusive flag for	a reprioritized	stream
       causes all the dependencies of the new parent stream to	become	depen-
       dent on the reprioritized stream.

       This option can be set during transfer.

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

DEFAULT
       NULL

PROTOCOLS
       This functionality affects http only

EXAMPLE
       int main(void)
       {
	 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_E, curl);

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

AVAILABILITY
       Added in	curl 7.46.0

RETURN VALUE
       curl_easy_setopt(3) returns a CURLcode indicating success or error.

       CURLE_OK	(0) means everything was OK, non-zero means an error occurred,
       see libcurl-errors(3).

SEE ALSO
       CURLMOPT_PIPELINING(3),	 CURLOPT_HTTP_VERSION(3),   CURLOPT_STREAM_DE-
       PENDS(3), CURLOPT_STREAM_WEIGHT(3)

libcurl				  2025-06-03	    CURLOPT_ST..._DEPENDS_E(3)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=CURLOPT_STREAM_DEPENDS_E&sektion=3&manpath=FreeBSD+Ports+14.3.quarterly>

home | help