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

FreeBSD Manual Pages

  
 
  

home | help
BUNDLE_WAIT(3)		   libdill Library Functions		BUNDLE_WAIT(3)

NAME
       bundle_wait - wait while	coroutines in the bundle finish

SYNOPSIS
	      #include <libdill.h>

	      int bundle_wait(
		  int bndl,
		  int64_t deadline);

DESCRIPTION
       If  there are no	coroutines in the bundle the function will succeed im-
       mediately.  Otherwise, it will wait until all  the  coroutines  in  the
       bundle finish or	until deadline is reached.

       bndl: Handle of a coroutine bundle.

       deadline:  A  point in time when	the operation should time out, in mil-
       liseconds.  Use the now function	to get your current point in time.   0
       means immediate timeout,	i.e., perform the operation if possible	or re-
       turn without blocking if	not.  -1 means no  deadline,  i.e.,  the  call
       will block forever if the operation cannot be performed.

RETURN VALUE
       In case of success the function returns 0.  In case of error it returns
       -1 and sets errno to one	of the values below.

ERRORS
       o EBADF:	Invalid	handle.

       o ECANCELED: Current coroutine was canceled.

       o ENOTSUP: The handle does not support this operation.

       o ETIMEDOUT: Deadline was reached.

EXAMPLE
	      int b = bundle();
	      bundle_go(b, worker());
	      bundle_go(b, worker());
	      bundle_go(b, worker());
	      /* Give wrokers 1	second to finish. */
	      bundle_wait(b, now() + 1000);
	      /* Cancel	any remaining workers. */
	      hclose(b);

SEE ALSO
       bundle(3) bundle_go(3) bundle_go_mem(3) bundle_mem(3)  go(3)  go_mem(3)
       now(3) yield(3)

libdill								BUNDLE_WAIT(3)

NAME | SYNOPSIS | DESCRIPTION | RETURN VALUE | ERRORS | EXAMPLE | SEE ALSO

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

home | help