NAME

     curl_multi_info_read - read multi stack informationals


SYNOPSIS

     #include <curl/curl.h>

     CURLMsg *curl_multi_info_read( CURLM *multi_handle,
                                    int *msgs_in_queue);


DESCRIPTION

     Ask  the multi handle if there's any messages/informationals
     from the individual transfers. Messages include information­
     als such as an error code from the transfer or just the fact
     that a transfer is completed. More details on  these  should
     be written down as well.

     Repeated  calls  to  this  function will return a new struct
     each time, until a special "end of msgs" struct is  returned
     as  a signal that there is no more to get at this point. The
     integer pointed to with msgs_in_queue will contain the  num­
     ber of remaining messages after this function was called.

     The  data  the  returned  pointer points to will not survive
     calling curl_multi_cleanup().

     The 'CURLMsg' struct is very simple and  only  contain  very
     basic informations.  If more involved information is wanted,
     the particular "easy handle" in present in that  struct  and
     can  thus  be used in subsequent regular curl_easy_getinfo()
     calls (or similar).


RETURN VALUE

     A pointer to a filled-in struct, or NULL if it failed or ran
     out  of  structs. It also writes the number of messages left
     in the queue (after this read) in  the  integer  the  second
     argument points to.


SEE ALSO

     curl_multi_cleanup(3),curl_multi_init(3),curl_multi_per­
     form(3)













Man(1) output converted with man2html