aboutsummaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
Diffstat (limited to 'docs')
-rw-r--r--docs/examples/fopen.c31
-rw-r--r--docs/examples/imap-multi.c34
-rw-r--r--docs/examples/multi-app.c31
-rw-r--r--docs/examples/multi-debugcallback.c31
-rw-r--r--docs/examples/multi-double.c31
-rw-r--r--docs/examples/multi-post.c31
-rw-r--r--docs/examples/multi-single.c31
-rw-r--r--docs/examples/pop3-multi.c34
-rw-r--r--docs/examples/smtp-multi.c34
9 files changed, 222 insertions, 66 deletions
diff --git a/docs/examples/fopen.c b/docs/examples/fopen.c
index 6fe5c0f9f..c26c0de04 100644
--- a/docs/examples/fopen.c
+++ b/docs/examples/fopen.c
@@ -128,6 +128,7 @@ static int fill_buffer(URL_FILE *file, size_t want)
fd_set fdexcep;
struct timeval timeout;
int rc;
+ CURLMcode mc; /* curl_multi_fdset() return code */
/* only attempt to fill buffer if transactions still running and buffer
* doesnt exceed required size already
@@ -158,15 +159,31 @@ static int fill_buffer(URL_FILE *file, size_t want)
}
/* get file descriptors from the transfers */
- curl_multi_fdset(multi_handle, &fdread, &fdwrite, &fdexcep, &maxfd);
+ mc = curl_multi_fdset(multi_handle, &fdread, &fdwrite, &fdexcep, &maxfd);
- /* In a real-world program you OF COURSE check the return code of the
- function calls. On success, the value of maxfd is guaranteed to be
- greater or equal than -1. We call select(maxfd + 1, ...), specially
- in case of (maxfd == -1), we call select(0, ...), which is basically
- equal to sleep. */
+ if(mc != CURLM_OK)
+ {
+ fprintf(stderr, "curl_multi_fdset() failed, code %d.\n", mc);
+ break;
+ }
- rc = select(maxfd+1, &fdread, &fdwrite, &fdexcep, &timeout);
+ /* On success the value of maxfd is guaranteed to be >= -1. We call
+ select(maxfd + 1, ...); specially in case of (maxfd == -1) we call
+ select(0, ...), which is basically equal to sleeping the timeout. On
+ Windows we can't sleep via select without a dummy socket and instead
+ we Sleep() for 100ms which is the minimum suggested value in the
+ curl_multi_fdset() doc. */
+
+#ifdef _WIN32
+ if(maxfd == -1) {
+ Sleep(100);
+ rc = 0;
+ }
+ else
+#endif
+ {
+ rc = select(maxfd+1, &fdread, &fdwrite, &fdexcep, &timeout);
+ }
switch(rc) {
case -1:
diff --git a/docs/examples/imap-multi.c b/docs/examples/imap-multi.c
index 601205a08..c8c67ff87 100644
--- a/docs/examples/imap-multi.c
+++ b/docs/examples/imap-multi.c
@@ -88,6 +88,7 @@ int main(void)
fd_set fdexcep;
int maxfd = -1;
int rc;
+ CURLMcode mc; /* curl_multi_fdset() return code */
long curl_timeo = -1;
@@ -109,15 +110,32 @@ int main(void)
timeout.tv_usec = (curl_timeo % 1000) * 1000;
}
- /* Get file descriptors from the transfers */
- curl_multi_fdset(mcurl, &fdread, &fdwrite, &fdexcep, &maxfd);
+ /* get file descriptors from the transfers */
+ mc = curl_multi_fdset(mcurl, &fdread, &fdwrite, &fdexcep, &maxfd);
- /* In a real-world program you OF COURSE check the return code of the
- function calls. On success, the value of maxfd is guaranteed to be
- greater or equal than -1. We call select(maxfd + 1, ...), specially in
- case of (maxfd == -1), we call select(0, ...), which is basically equal
- to sleep. */
- rc = select(maxfd + 1, &fdread, &fdwrite, &fdexcep, &timeout);
+ if(mc != CURLM_OK)
+ {
+ fprintf(stderr, "curl_multi_fdset() failed, code %d.\n", mc);
+ break;
+ }
+
+ /* On success the value of maxfd is guaranteed to be >= -1. We call
+ select(maxfd + 1, ...); specially in case of (maxfd == -1) we call
+ select(0, ...), which is basically equal to sleeping the timeout. On
+ Windows we can't sleep via select without a dummy socket and instead
+ we Sleep() for 100ms which is the minimum suggested value in the
+ curl_multi_fdset() doc. */
+
+#ifdef _WIN32
+ if(maxfd == -1) {
+ Sleep(100);
+ rc = 0;
+ }
+ else
+#endif
+ {
+ rc = select(maxfd+1, &fdread, &fdwrite, &fdexcep, &timeout);
+ }
if(tvdiff(tvnow(), mp_start) > MULTI_PERFORM_HANG_TIMEOUT) {
fprintf(stderr,
diff --git a/docs/examples/multi-app.c b/docs/examples/multi-app.c
index a5f71c5ac..bf0f11ad5 100644
--- a/docs/examples/multi-app.c
+++ b/docs/examples/multi-app.c
@@ -73,6 +73,7 @@ int main(void)
do {
struct timeval timeout;
int rc; /* select() return code */
+ CURLMcode mc; /* curl_multi_fdset() return code */
fd_set fdread;
fd_set fdwrite;
@@ -99,15 +100,31 @@ int main(void)
}
/* get file descriptors from the transfers */
- curl_multi_fdset(multi_handle, &fdread, &fdwrite, &fdexcep, &maxfd);
+ mc = curl_multi_fdset(multi_handle, &fdread, &fdwrite, &fdexcep, &maxfd);
- /* In a real-world program you OF COURSE check the return code of the
- function calls. On success, the value of maxfd is guaranteed to be
- greater or equal than -1. We call select(maxfd + 1, ...), specially in
- case of (maxfd == -1), we call select(0, ...), which is basically equal
- to sleep. */
+ if(mc != CURLM_OK)
+ {
+ fprintf(stderr, "curl_multi_fdset() failed, code %d.\n", mc);
+ break;
+ }
- rc = select(maxfd+1, &fdread, &fdwrite, &fdexcep, &timeout);
+ /* On success the value of maxfd is guaranteed to be >= -1. We call
+ select(maxfd + 1, ...); specially in case of (maxfd == -1) we call
+ select(0, ...), which is basically equal to sleeping the timeout. On
+ Windows we can't sleep via select without a dummy socket and instead
+ we Sleep() for 100ms which is the minimum suggested value in the
+ curl_multi_fdset() doc. */
+
+#ifdef _WIN32
+ if(maxfd == -1) {
+ Sleep(100);
+ rc = 0;
+ }
+ else
+#endif
+ {
+ rc = select(maxfd+1, &fdread, &fdwrite, &fdexcep, &timeout);
+ }
switch(rc) {
case -1:
diff --git a/docs/examples/multi-debugcallback.c b/docs/examples/multi-debugcallback.c
index 8eedcee5b..31dec5472 100644
--- a/docs/examples/multi-debugcallback.c
+++ b/docs/examples/multi-debugcallback.c
@@ -147,6 +147,7 @@ int main(void)
do {
struct timeval timeout;
int rc; /* select() return code */
+ CURLMcode mc; /* curl_multi_fdset() return code */
fd_set fdread;
fd_set fdwrite;
@@ -173,15 +174,31 @@ int main(void)
}
/* get file descriptors from the transfers */
- curl_multi_fdset(multi_handle, &fdread, &fdwrite, &fdexcep, &maxfd);
+ mc = curl_multi_fdset(multi_handle, &fdread, &fdwrite, &fdexcep, &maxfd);
- /* In a real-world program you OF COURSE check the return code of the
- function calls. On success, the value of maxfd is guaranteed to be
- greater or equal than -1. We call select(maxfd + 1, ...), specially in
- case of (maxfd == -1), we call select(0, ...), which is basically equal
- to sleep. */
+ if(mc != CURLM_OK)
+ {
+ fprintf(stderr, "curl_multi_fdset() failed, code %d.\n", mc);
+ break;
+ }
- rc = select(maxfd+1, &fdread, &fdwrite, &fdexcep, &timeout);
+ /* On success the value of maxfd is guaranteed to be >= -1. We call
+ select(maxfd + 1, ...); specially in case of (maxfd == -1) we call
+ select(0, ...), which is basically equal to sleeping the timeout. On
+ Windows we can't sleep via select without a dummy socket and instead
+ we Sleep() for 100ms which is the minimum suggested value in the
+ curl_multi_fdset() doc. */
+
+#ifdef _WIN32
+ if(maxfd == -1) {
+ Sleep(100);
+ rc = 0;
+ }
+ else
+#endif
+ {
+ rc = select(maxfd+1, &fdread, &fdwrite, &fdexcep, &timeout);
+ }
switch(rc) {
case -1:
diff --git a/docs/examples/multi-double.c b/docs/examples/multi-double.c
index 91422e6e2..df0922a1c 100644
--- a/docs/examples/multi-double.c
+++ b/docs/examples/multi-double.c
@@ -62,6 +62,7 @@ int main(void)
do {
struct timeval timeout;
int rc; /* select() return code */
+ CURLMcode mc; /* curl_multi_fdset() return code */
fd_set fdread;
fd_set fdwrite;
@@ -88,15 +89,31 @@ int main(void)
}
/* get file descriptors from the transfers */
- curl_multi_fdset(multi_handle, &fdread, &fdwrite, &fdexcep, &maxfd);
+ mc = curl_multi_fdset(multi_handle, &fdread, &fdwrite, &fdexcep, &maxfd);
- /* In a real-world program you OF COURSE check the return code of the
- function calls. On success, the value of maxfd is guaranteed to be
- greater or equal than -1. We call select(maxfd + 1, ...), specially in
- case of (maxfd == -1), we call select(0, ...), which is basically equal
- to sleep. */
+ if(mc != CURLM_OK)
+ {
+ fprintf(stderr, "curl_multi_fdset() failed, code %d.\n", mc);
+ break;
+ }
- rc = select(maxfd+1, &fdread, &fdwrite, &fdexcep, &timeout);
+ /* On success the value of maxfd is guaranteed to be >= -1. We call
+ select(maxfd + 1, ...); specially in case of (maxfd == -1) we call
+ select(0, ...), which is basically equal to sleeping the timeout. On
+ Windows we can't sleep via select without a dummy socket and instead
+ we Sleep() for 100ms which is the minimum suggested value in the
+ curl_multi_fdset() doc. */
+
+#ifdef _WIN32
+ if(maxfd == -1) {
+ Sleep(100);
+ rc = 0;
+ }
+ else
+#endif
+ {
+ rc = select(maxfd+1, &fdread, &fdwrite, &fdexcep, &timeout);
+ }
switch(rc) {
case -1:
diff --git a/docs/examples/multi-post.c b/docs/examples/multi-post.c
index 965a2c3f6..a6cc8683c 100644
--- a/docs/examples/multi-post.c
+++ b/docs/examples/multi-post.c
@@ -83,6 +83,7 @@ int main(void)
do {
struct timeval timeout;
int rc; /* select() return code */
+ CURLMcode mc; /* curl_multi_fdset() return code */
fd_set fdread;
fd_set fdwrite;
@@ -109,15 +110,31 @@ int main(void)
}
/* get file descriptors from the transfers */
- curl_multi_fdset(multi_handle, &fdread, &fdwrite, &fdexcep, &maxfd);
+ mc = curl_multi_fdset(multi_handle, &fdread, &fdwrite, &fdexcep, &maxfd);
- /* In a real-world program you OF COURSE check the return code of the
- function calls. On success, the value of maxfd is guaranteed to be
- greater or equal than -1. We call select(maxfd + 1, ...), specially in
- case of (maxfd == -1), we call select(0, ...), which is basically equal
- to sleep. */
+ if(mc != CURLM_OK)
+ {
+ fprintf(stderr, "curl_multi_fdset() failed, code %d.\n", mc);
+ break;
+ }
- rc = select(maxfd+1, &fdread, &fdwrite, &fdexcep, &timeout);
+ /* On success the value of maxfd is guaranteed to be >= -1. We call
+ select(maxfd + 1, ...); specially in case of (maxfd == -1) we call
+ select(0, ...), which is basically equal to sleeping the timeout. On
+ Windows we can't sleep via select without a dummy socket and instead
+ we Sleep() for 100ms which is the minimum suggested value in the
+ curl_multi_fdset() doc. */
+
+#ifdef _WIN32
+ if(maxfd == -1) {
+ Sleep(100);
+ rc = 0;
+ }
+ else
+#endif
+ {
+ rc = select(maxfd+1, &fdread, &fdwrite, &fdexcep, &timeout);
+ }
switch(rc) {
case -1:
diff --git a/docs/examples/multi-single.c b/docs/examples/multi-single.c
index 37a01cd83..3d80c655f 100644
--- a/docs/examples/multi-single.c
+++ b/docs/examples/multi-single.c
@@ -60,6 +60,7 @@ int main(void)
do {
struct timeval timeout;
int rc; /* select() return code */
+ CURLMcode mc; /* curl_multi_fdset() return code */
fd_set fdread;
fd_set fdwrite;
@@ -86,15 +87,31 @@ int main(void)
}
/* get file descriptors from the transfers */
- curl_multi_fdset(multi_handle, &fdread, &fdwrite, &fdexcep, &maxfd);
+ mc = curl_multi_fdset(multi_handle, &fdread, &fdwrite, &fdexcep, &maxfd);
- /* In a real-world program you OF COURSE check the return code of the
- function calls. On success, the value of maxfd is guaranteed to be
- greater or equal than -1. We call select(maxfd + 1, ...), specially in
- case of (maxfd == -1), we call select(0, ...), which is basically equal
- to sleep. */
+ if(mc != CURLM_OK)
+ {
+ fprintf(stderr, "curl_multi_fdset() failed, code %d.\n", mc);
+ break;
+ }
- rc = select(maxfd+1, &fdread, &fdwrite, &fdexcep, &timeout);
+ /* On success the value of maxfd is guaranteed to be >= -1. We call
+ select(maxfd + 1, ...); specially in case of (maxfd == -1) we call
+ select(0, ...), which is basically equal to sleeping the timeout. On
+ Windows we can't sleep via select without a dummy socket and instead
+ we Sleep() for 100ms which is the minimum suggested value in the
+ curl_multi_fdset() doc. */
+
+#ifdef _WIN32
+ if(maxfd == -1) {
+ Sleep(100);
+ rc = 0;
+ }
+ else
+#endif
+ {
+ rc = select(maxfd+1, &fdread, &fdwrite, &fdexcep, &timeout);
+ }
switch(rc) {
case -1:
diff --git a/docs/examples/pop3-multi.c b/docs/examples/pop3-multi.c
index d14d1159b..42142f954 100644
--- a/docs/examples/pop3-multi.c
+++ b/docs/examples/pop3-multi.c
@@ -88,6 +88,7 @@ int main(void)
fd_set fdexcep;
int maxfd = -1;
int rc;
+ CURLMcode mc; /* curl_multi_fdset() return code */
long curl_timeo = -1;
@@ -109,15 +110,32 @@ int main(void)
timeout.tv_usec = (curl_timeo % 1000) * 1000;
}
- /* Get file descriptors from the transfers */
- curl_multi_fdset(mcurl, &fdread, &fdwrite, &fdexcep, &maxfd);
+ /* get file descriptors from the transfers */
+ mc = curl_multi_fdset(mcurl, &fdread, &fdwrite, &fdexcep, &maxfd);
- /* In a real-world program you OF COURSE check the return code of the
- function calls. On success, the value of maxfd is guaranteed to be
- greater or equal than -1. We call select(maxfd + 1, ...), specially in
- case of (maxfd == -1), we call select(0, ...), which is basically equal
- to sleep. */
- rc = select(maxfd + 1, &fdread, &fdwrite, &fdexcep, &timeout);
+ if(mc != CURLM_OK)
+ {
+ fprintf(stderr, "curl_multi_fdset() failed, code %d.\n", mc);
+ break;
+ }
+
+ /* On success the value of maxfd is guaranteed to be >= -1. We call
+ select(maxfd + 1, ...); specially in case of (maxfd == -1) we call
+ select(0, ...), which is basically equal to sleeping the timeout. On
+ Windows we can't sleep via select without a dummy socket and instead
+ we Sleep() for 100ms which is the minimum suggested value in the
+ curl_multi_fdset() doc. */
+
+#ifdef _WIN32
+ if(maxfd == -1) {
+ Sleep(100);
+ rc = 0;
+ }
+ else
+#endif
+ {
+ rc = select(maxfd+1, &fdread, &fdwrite, &fdexcep, &timeout);
+ }
if(tvdiff(tvnow(), mp_start) > MULTI_PERFORM_HANG_TIMEOUT) {
fprintf(stderr,
diff --git a/docs/examples/smtp-multi.c b/docs/examples/smtp-multi.c
index 7f3d333df..998f69e3f 100644
--- a/docs/examples/smtp-multi.c
+++ b/docs/examples/smtp-multi.c
@@ -155,6 +155,7 @@ int main(void)
fd_set fdexcep;
int maxfd = -1;
int rc;
+ CURLMcode mc; /* curl_multi_fdset() return code */
long curl_timeo = -1;
@@ -176,15 +177,32 @@ int main(void)
timeout.tv_usec = (curl_timeo % 1000) * 1000;
}
- /* Get file descriptors from the transfers */
- curl_multi_fdset(mcurl, &fdread, &fdwrite, &fdexcep, &maxfd);
+ /* get file descriptors from the transfers */
+ mc = curl_multi_fdset(mcurl, &fdread, &fdwrite, &fdexcep, &maxfd);
- /* In a real-world program you OF COURSE check the return code of the
- function calls. On success, the value of maxfd is guaranteed to be
- greater or equal than -1. We call select(maxfd + 1, ...), specially in
- case of (maxfd == -1), we call select(0, ...), which is basically equal
- to sleep. */
- rc = select(maxfd+1, &fdread, &fdwrite, &fdexcep, &timeout);
+ if(mc != CURLM_OK)
+ {
+ fprintf(stderr, "curl_multi_fdset() failed, code %d.\n", mc);
+ break;
+ }
+
+ /* On success the value of maxfd is guaranteed to be >= -1. We call
+ select(maxfd + 1, ...); specially in case of (maxfd == -1) we call
+ select(0, ...), which is basically equal to sleeping the timeout. On
+ Windows we can't sleep via select without a dummy socket and instead
+ we Sleep() for 100ms which is the minimum suggested value in the
+ curl_multi_fdset() doc. */
+
+#ifdef _WIN32
+ if(maxfd == -1) {
+ Sleep(100);
+ rc = 0;
+ }
+ else
+#endif
+ {
+ rc = select(maxfd+1, &fdread, &fdwrite, &fdexcep, &timeout);
+ }
if(tvdiff(tvnow(), mp_start) > MULTI_PERFORM_HANG_TIMEOUT) {
fprintf(stderr,