curl/docs/libcurl/curl_multi_fdset.3

32 lines
1.2 KiB
Groff
Raw Normal View History

.\" $Id$
.\"
.TH curl_multi_fdset 3 "15 Apr 2004" "libcurl 7.9.5" "libcurl Manual"
.SH NAME
2002-10-15 04:39:30 -04:00
curl_multi_fdset - extracts file descriptor information from a multi handle
.SH SYNOPSIS
2004-04-13 10:34:12 -04:00
.nf
#include <curl/curl.h>
CURLMcode curl_multi_fdset(CURLM *multi_handle,
fd_set *read_fd_set,
fd_set *write_fd_set,
fd_set *exc_fd_set,
int *max_fd);
.ad
.SH DESCRIPTION
This function extracts file descriptor information from a given multi_handle.
libcurl returns its fd_set sets. The application can use these to select()
on. The \fIcurl_multi_perform(3)\fP function should be called as soon as one
2004-04-14 08:13:21 -04:00
of them are ready to be read from or written to.
You should also be aware that when doing select(), you should consider using a
rather small (single-digit number of seconds) timeout and call
\fIcurl_multi_perform\fP regularly - even if no activity has been seen on the
fd_sets - as otherwise libcurl-internal retries and timeouts may not work as
you'd think.
.SH RETURN VALUE
CURLMcode type, general libcurl multi interface error code. See
2004-04-13 10:34:12 -04:00
\fIlibcurl-errors(3)\fP
.SH "SEE ALSO"
.BR curl_multi_cleanup "(3)," curl_multi_init "(3)"