mingw/share/man/man3/curl_multi_fdset.3

   1 .\" $Id: curl_multi_fdset.3,v 1.13 2008-12-28 21:56:56 bagder Exp $
   2 .\"
   3 .TH curl_multi_fdset 3 "2 Jan 2006" "libcurl 7.16.0" "libcurl Manual"
   4 .SH NAME
   5 curl_multi_fdset - extracts file descriptor information from a multi handle
   6 .SH SYNOPSIS
   7 .nf
   8 #include <curl/curl.h>
   9
  10 CURLMcode curl_multi_fdset(CURLM *multi_handle,
  11                            fd_set *read_fd_set,
  12                            fd_set *write_fd_set,
  13                            fd_set *exc_fd_set,
  14                            int *max_fd);
  15 .ad
  16 .SH DESCRIPTION
  17 This function extracts file descriptor information from a given multi_handle.
  18 libcurl returns its fd_set sets. The application can use these to select() on,
  19 but be sure to FD_ZERO them before calling this function as
  20 \fIcurl_multi_fdset(3)\fP only adds its own descriptors, it doesn't zero or
  21 otherwise remove any others. The \fIcurl_multi_perform(3)\fP function should be
  22 called as soon as one of them is ready to be read from or written to.
  23
  24 If no file descriptors are set by libcurl, \fImax_fd\fP will contain -1 when
  25 this function returns. Otherwise it will contain the higher descriptor number
  26 libcurl set.
  27
  28 You should also be aware that when doing select(), you should consider using a
  29 rather small (single-digit number of seconds) timeout and call
  30 \fIcurl_multi_perform\fP regularly - even if no activity has been seen on the
  31 fd_sets - as otherwise libcurl-internal retries and timeouts may not work as
  32 you'd think and want.
  33
  34 Starting with libcurl 7.16.0, you should use \fBcurl_multi_timeout\fP to
  35 figure out how long to wait for action.
  36 .SH RETURN VALUE
  37 CURLMcode type, general libcurl multi interface error code. See
  38 \fIlibcurl-errors(3)\fP
  39 .SH "SEE ALSO"
  40 .BR curl_multi_cleanup "(3)," curl_multi_init "(3), "
  41 .BR curl_multi_timeout "(3) "