moparisthebest/curl
1
0
Fork 0
mirror of https://github.com/moparisthebest/curl synced 2024-12-21 23:58:49 -05:00
Code Issues Releases Wiki Activity

more formatting fixes

Browse Source
This commit is contained in:
Daniel Stenberg 2004-03-15 12:41:24 +00:00
parent 8c4e91a653
commit 7de892eeb4
1 changed files with 9 additions and 10 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

19
docs/libcurl/libcurl.3
View File

@ -8,8 +8,8 @@ libcurl \- client-side URL transfers
.SH DESCRIPTION .SH DESCRIPTION
This is an overview on how to use libcurl in your C programs. There are This is an overview on how to use libcurl in your C programs. There are
specific man pages for each function mentioned in here. There are also the specific man pages for each function mentioned in here. There are also the
\fIlibcurl-easy\fP man page, the \fIlibcurl-multi\fP man page, the \fIlibcurl-easy(3)\fP man page, the \fIlibcurl-multi(3)\fP man page, the
\fIlibcurl-share\fP man page and the \fIlibcurl-the-guide\fP document for \fIlibcurl-share(3)\fP man page and the \fIlibcurl-the-guide\fP document for
further reading on how to do programming with libcurl. further reading on how to do programming with libcurl.
There exist more than a dozen custom bindings that bring libcurl access to There exist more than a dozen custom bindings that bring libcurl access to
@ -25,10 +25,9 @@ To transfer files, you always set up an "easy handle" using
option of using the "easy" interface, or the "multi" interface. option of using the "easy" interface, or the "multi" interface.
The easy interface is a synchronous interface with which you call The easy interface is a synchronous interface with which you call
\fIcurl_easy_perform\fP and let it perform the transfer. When it is completed, \fIcurl_easy_perform(3)\fP and let it perform the transfer. When it is
the function return and you can continue. More details are found in the completed, the function return and you can continue. More details are found in
.BR "libcurl-easy (3)" the \fIlibcurl-easy(3)\fP man page.
man page.
The multi interface on the other hand is an asynchronous interface, that you The multi interface on the other hand is an asynchronous interface, that you
call and that performs only a little piece of the tranfer on each invoke. It call and that performs only a little piece of the tranfer on each invoke. It
@ -38,7 +37,7 @@ even to easily download multiple files simultaneously using a single thread.
You can have multiple easy handles share certain data, even if they are used You can have multiple easy handles share certain data, even if they are used
in different threads. This magic is setup using the share interface, as in different threads. This magic is setup using the share interface, as
described in the \fIlibcurl-share\fP man page. described in the \fIlibcurl-share(3)\fP man page.
There is also a series of other helpful functions to use. They are: There is also a series of other helpful functions to use. They are:
@ -102,12 +101,12 @@ Never ever call curl-functions simultaneously using the same handle from
several threads. libcurl is thread-safe and can be used in any number of several threads. libcurl is thread-safe and can be used in any number of
threads, but you must use separate curl handles if you want to use libcurl in threads, but you must use separate curl handles if you want to use libcurl in
more than one thread simultaneously. more than one thread simultaneously.
.SH "PERSISTANT CONNECTIONS" .SH "PERSISTENT CONNECTIONS"
Persistent connections means that libcurl can re-use the same connection for Persistent connections means that libcurl can re-use the same connection for
several transfers, if the conditions are right. several transfers, if the conditions are right.
libcurl will *always* attempt to use persistent connections. Whenever you use libcurl will \fBalways\fP attempt to use persistent connections. Whenever you
\fIcurl_easy_perform(3)\fP or \fIcurl_multi_perform(3)\fP, libcurl will use \fIcurl_easy_perform(3)\fP or \fIcurl_multi_perform(3)\fP, libcurl will
attempt to use an existing connection to do the transfer, and if none exists attempt to use an existing connection to do the transfer, and if none exists
it'll open a new one that will be subject for re-use on a possible following it'll open a new one that will be subject for re-use on a possible following
call to \fIcurl_easy_perform(3)\fP or \fIcurl_multi_perform(3)\fP. call to \fIcurl_easy_perform(3)\fP or \fIcurl_multi_perform(3)\fP.