curl_multi_fdset(3) 맨 페이지 - 윈디하나의 솔라나라

개요

섹션
맨 페이지 이름
검색(S)

curl_multi_fdset(3)

/usr/local/bin/rman를 실행할 수 없습니다

curl_multi_fdset(3)        Library Functions Manual        curl_multi_fdset(3)

NAME
       curl_multi_fdset  -  extract  file  descriptor information from a multi
       handle

SYNOPSIS
       #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);

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, but be sure to FD_ZERO them before calling this
       function as curl_multi_fdset(3) only adds its own descriptors, it  does
       not  zero  or  otherwise  remove  any others. The curl_multi_perform(3)
       function should be called as soon as one of them is ready  to  be  read
       from or written to.

       The  read_fd_set argument should point to an object of type fd_set that
       on returns specifies the file descriptors to be checked for being ready
       to read.

       The write_fd_set argument should point to an object of type fd_set that
       on return specifies the file descriptors to be checked for being  ready
       to write.

       The  exc_fd_set  argument should point to an object of type fd_set that
       on return specifies the file descriptors to be checked for error condi‐
       tions.

       If no file descriptors are set by libcurl, max_fd contain -1 when  this
       function  returns.  Otherwise it contains the highest descriptor number
       libcurl set. When libcurl returns -1 in max_fd, it is  because  libcurl
       currently  does  something that is not possible for your application to
       monitor with a socket and unfortunately you can then not  know  exactly
       when  the  current action is completed using select(). You then need to
       wait a while before you proceed and call curl_multi_perform(3)  anyway.
       How  long  to wait? Unless curl_multi_timeout(3) gives you a lower num‐
       ber, we suggest 100 milliseconds or so, but you may want to test it out
       in your own particular conditions to find a suitable value.

       When doing select(), you should use curl_multi_timeout(3) to figure out
       how long to wait for action. Call curl_multi_perform(3) even if no  ac‐
       tivity has been seen on the fd_sets after the timeout expires as other‐
       wise  internal retries and timeouts may not work as you would think and
       want.

       If one of the sockets used by libcurl happens to be  larger  than  what
       can be set in an fd_set, which on POSIX systems means that the file de‐
       scriptor  is  larger than FD_SETSIZE, then libcurl tries to not set it.
       Setting a too large file descriptor in an  fd_set  implies  an  out  of
       bounds write which can cause crashes, or worse. The effect of NOT stor‐
       ing  it  might possibly save you from the crash, but makes your program
       NOT wait for sockets it should wait for...

PROTOCOLS
       This functionality affects all supported protocols

EXAMPLE
       int main(void)
       {
         fd_set fdread;
         fd_set fdwrite;
         fd_set fdexcep;
         int maxfd;
         int rc;
         CURLMcode mc;
         struct timeval timeout = {1, 0};

         CURLM *multi = curl_multi_init();

         do {

           /* call curl_multi_perform() */

           FD_ZERO(&fdread);
           FD_ZERO(&fdwrite);
           FD_ZERO(&fdexcep);

           /* get file descriptors from the transfers */
           mc = curl_multi_fdset(multi, &fdread, &fdwrite, &fdexcep, &maxfd);

           if(mc != CURLM_OK) {
             fprintf(stderr, "curl_multi_fdset() failed, code %d.\n", mc);
             break;
           }

           /* wait for activity on one of the sockets */
           rc = select(maxfd + 1, &fdread, &fdwrite, &fdexcep, &timeout);

         } while(!mc);
       }

AVAILABILITY
       Added in curl 7.9.6

RETURN VALUE
       This function returns a CURLMcode indicating success or error.

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


ATTRIBUTES
       See attributes(7) for descriptions of the following attributes:

       box; cbp-1 | cbp-1 l | l .  ATTRIBUTE TYPE ATTRIBUTE VALUE = Availabil‐
       ity   web/curl = Stability Uncommitted

SEE ALSO
       curl_multi_cleanup(3),    curl_multi_init(3),    curl_multi_perform(3),
       curl_multi_timeout(3),  curl_multi_wait(3),  curl_multi_waitfds(3), se‐
       lect(2)



NOTES
       Source code for open source software components in Oracle  Solaris  can
       be found at https://www.oracle.com/downloads/opensource/solaris-source-
       code-downloads.html.

       This software was built from source available at:
       https://github.com/oracle/solaris-userland

       The original community source was downloaded from:
       https://curl.se/download/curl-8.17.0.tar.bz2

       Further information about this software can be found on the open source
       community website at http://curl.haxx.se/.

libcurl                           2025-12-01               curl_multi_fdset(3)
맨 페이지 내용의 저작권은 맨 페이지 작성자에게 있습니다.
RSS ATOM XHTML 5 CSS3