libcurl Manual curlmultifdset(3)
NAME
curlmultifdset - extracts file descriptor information from
a multi handle
SYNOPSIS
#include
CURLMcode curlmultifdset(CURLM *multihandle,
fdset *readfdset,
fdset *writefdset,
fdset *excfdset,
int *maxfd);
DESCRIPTION
This function extracts file descriptor information from a
given multihandle. libcurl returns its fdset sets. The
application can use these to select() on, but be sure to
FDZERO them before calling this function as
curlmultifdset(3) only adds its own descriptors, it
doesn't zero or otherwise remove any others. The
curlmultiperform(3) function should be called as soon as
one of them is ready to be read from or written to.
If no file descriptors are set by libcurl, maxfd will con-
tain -1 when this function returns. Otherwise it will con-
tain the higher descriptor number libcurl set.
You should also be aware that when doing select(), you
should consider using a rather small (single-digit number of
seconds) timeout and call curlmultiperform regularly -
even if no activity has been seen on the fdsets - as other-
wise libcurl-internal retries and timeouts may not work as
you'd think and want.
Starting with libcurl 7.16.0, you should use
curlmultitimeout to figure out how long to wait for
action.
RETURN VALUE
CURLMcode type, general libcurl multi interface error code.
See libcurl-errors(3)
SEE ALSO
curlmulticleanup(3),curlmultiinit(3),
curlmultitimeout(3)
ATRIBUTES
See attributes(5) for descriptions of the following attri-
butes:
libcurl 7.16.0 Last change: 2 Jan 2006 1
libcurl Manual curlmultifdset(3)
ATRIBUTE TYPE ATRIBUTE VALUE
Availability SUNWcurl
Interface Stability Uncommitted
NOTES
Source for C-URL is available on http:/opensolaris.org.
libcurl 7.16.0 Last change: 2 Jan 2006 2
|