mirror of
https://github.com/moparisthebest/curl
synced 2024-11-05 09:05:04 -05:00
36 lines
1.5 KiB
Groff
36 lines
1.5 KiB
Groff
|
.\" $Id$
|
||
|
|
.\"
|
||
|
|
.TH curl_multi_info_read 3 "1 March 2002" "libcurl 7.9.5" "libcurl Manual"
|
||
|
|
.SH NAME
|
||
|
|
curl_multi_info_read - read multi stack informationals
|
||
|
|
.SH SYNOPSIS
|
||
|
|
#include <curl/curl.h>
|
||
|
|
|
||
|
|
CURLMsg *curl_multi_info_read( CURLM *multi_handle,
|
||
|
|
int *msgs_in_queue);
|
||
|
|
.ad
|
||
|
|
.SH DESCRIPTION
|
||
|
|
Ask the multi handle if there's any messages/informationals from the
|
||
|
|
individual transfers. Messages include informationals 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 \fImsgs_in_queue\fP will
|
||
|
|
contain the number 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).
|
||
|
|
.SH "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.
|
||
|
|
.SH "SEE ALSO"
|
||
|
|
.BR curl_multi_cleanup "(3)," curl_multi_init "(3)," curl_multi_perform "(3)"
|