generic-library/curl
1
0
Fork 0
Code Issues Pull Requests Releases Wiki Activity

Hammer home the fact that "multi interface" != "multi-threaded"

Browse Source
This commit is contained in:
Dan Fandrich 2008-09-09 05:39:59 +00:00
parent 2ef72f7abb
commit ac1ab03cb0
1 changed files with 9 additions and 3 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

12
docs/libcurl/libcurl-tutorial.3
View File

@ -1117,12 +1117,18 @@ interface that transfers one file at a time and doesn't return until its
done.
The multi interface on the other hand, allows your program to transfer
multiple files in both directions at the same time, without forcing you to
use multiple threads.
multiple files in both directions at the same time, without forcing you
to use multiple threads. The name might make it seem that the multi
interface is for multi-threaded programs, but the truth is almost the
reverse. The multi interface can allow a single-threaded application
to perform the same kinds of multiple, simultaneous transfers that
multi-threaded programs can perform. It allows many of the benefits
of multi-threaded transfers without the complexity of managing and
synchronizing many threads.
To use this interface, you are better off if you first understand the basics
of how to use the easy interface. The multi interface is simply a way to make
multiple transfers at the same time, by adding up multiple easy handles in to
multiple transfers at the same time by adding up multiple easy handles in to
a "multi stack".
You create the easy handles you want and you set all the options just like you