mirror of
https://github.com/moparisthebest/curl
synced 2024-12-21 23:58:49 -05:00
minor update edits
This commit is contained in:
parent
69f4dda74a
commit
7332350e85
@ -81,6 +81,12 @@ TODO
|
|||||||
* Since USERPWD always override the user and password specified in URLs, we
|
* Since USERPWD always override the user and password specified in URLs, we
|
||||||
might need another way to specify user+password for anonymous ftp logins.
|
might need another way to specify user+password for anonymous ftp logins.
|
||||||
|
|
||||||
|
* The FTP code should get a way of returning errors that is known to still
|
||||||
|
have the control connection alive and sound. Currently, a returned error
|
||||||
|
from within ftp-functions does not tell if the control connection is still
|
||||||
|
OK to use or not. This causes libcurl to fail to re-use connections
|
||||||
|
slightly too often.
|
||||||
|
|
||||||
HTTP
|
HTTP
|
||||||
|
|
||||||
* Digest and GSS-Negotiate support for HTTP proxies. They only work on
|
* Digest and GSS-Negotiate support for HTTP proxies. They only work on
|
||||||
|
@ -7,9 +7,8 @@
|
|||||||
libcurl-easy \- easy interface overview
|
libcurl-easy \- easy interface overview
|
||||||
.SH DESCRIPTION
|
.SH DESCRIPTION
|
||||||
When using libcurl's "easy" interface you init your session and get a handle
|
When using libcurl's "easy" interface you init your session and get a handle
|
||||||
(often referred to as an "easy handle" in various docs and sources), which you
|
(often referred to as an "easy handle"), which you use as input to the easy
|
||||||
use as input to the easy interface functions you use. Use
|
interface functions you use. Use \fIcurl_easy_init(3)\fP to get the handle.
|
||||||
\fIcurl_easy_init(3)\fP to get the handle.
|
|
||||||
|
|
||||||
You continue by setting all the options you want in the upcoming transfer, the
|
You continue by setting all the options you want in the upcoming transfer, the
|
||||||
most important among them is the URL itself (you can't transfer anything
|
most important among them is the URL itself (you can't transfer anything
|
||||||
|
@ -33,45 +33,28 @@ The multi interface on the other hand is an asynchronous interface, that you
|
|||||||
call and that performs only a little piece of the transfer on each invoke. It
|
call and that performs only a little piece of the transfer on each invoke. It
|
||||||
is perfect if you want to do things while the transfer is in progress, or
|
is perfect if you want to do things while the transfer is in progress, or
|
||||||
similar. The multi interface allows you to select() on libcurl action, and
|
similar. The multi interface allows you to select() on libcurl action, and
|
||||||
even to easily download multiple files simultaneously using a single thread.
|
even to easily download multiple files simultaneously using a single thread. See further deails in the \fIlibcurl-multi(3)\fP man page.
|
||||||
|
|
||||||
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(3)\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, including these:
|
||||||
|
|
||||||
.RS
|
.RS
|
||||||
.TP 10
|
.IP curl_version_info()
|
||||||
.B curl_version()
|
gets detailed libcurl (and other used libraries) version info
|
||||||
displays the libcurl version
|
.IP curl_getdate()
|
||||||
.TP
|
|
||||||
.B curl_getdate()
|
|
||||||
converts a date string to time_t
|
converts a date string to time_t
|
||||||
.TP
|
.IP curl_easy_getinfo()
|
||||||
.B curl_getenv()
|
|
||||||
portable environment variable reader
|
|
||||||
.TP
|
|
||||||
.B curl_easy_getinfo()
|
|
||||||
get information about a performed transfer
|
get information about a performed transfer
|
||||||
.TP
|
.IP curl_formadd()
|
||||||
.B curl_formadd()
|
|
||||||
helps building an HTTP form POST
|
helps building an HTTP form POST
|
||||||
.TP
|
.IP curl_formfree()
|
||||||
.B curl_formfree()
|
|
||||||
free a list built with \fIcurl_formadd(3)\fP
|
free a list built with \fIcurl_formadd(3)\fP
|
||||||
.TP
|
.IP curl_slist_append()
|
||||||
.B curl_slist_append()
|
|
||||||
builds a linked list
|
builds a linked list
|
||||||
.TP
|
.IP curl_slist_free_all()
|
||||||
.B curl_slist_free_all()
|
|
||||||
frees a whole curl_slist
|
frees a whole curl_slist
|
||||||
.TP
|
|
||||||
.B curl_mprintf()
|
|
||||||
portable printf() functions
|
|
||||||
.TP
|
|
||||||
.B curl_strequal()
|
|
||||||
portable case insensitive string comparisons
|
|
||||||
.RE
|
.RE
|
||||||
|
|
||||||
.SH "LINKING WITH LIBCURL"
|
.SH "LINKING WITH LIBCURL"
|
||||||
@ -82,13 +65,17 @@ curl-config is added to make it easier for applications to link with libcurl
|
|||||||
and developers to learn about libcurl and how to use it.
|
and developers to learn about libcurl and how to use it.
|
||||||
|
|
||||||
Run 'curl-config --libs' to get the (additional) linker options you need to
|
Run 'curl-config --libs' to get the (additional) linker options you need to
|
||||||
link with the particular version of libcurl you've installed.
|
link with the particular version of libcurl you've installed. See the
|
||||||
|
\fIcurl-config(1)\fP man page for further details.
|
||||||
|
|
||||||
|
Unix-like operating system that ship libcurl as part of their distributions
|
||||||
|
often don't provide the curl-config tool, but simply install the library and
|
||||||
|
headers in the common path for this purpose.
|
||||||
|
|
||||||
For details, see the curl-config.1 man page.
|
|
||||||
.SH "LIBCURL SYMBOL NAMES"
|
.SH "LIBCURL SYMBOL NAMES"
|
||||||
All public functions in the libcurl interface are prefixed with 'curl_' (with
|
All public functions in the libcurl interface are prefixed with 'curl_' (with
|
||||||
a lowercase c). You can find other functions in the library source code, but
|
a lowercase c). You can find other functions in the library source code, but
|
||||||
other prefixes indicate the functions are private and may change without
|
other prefixes indicate that the functions are private and may change without
|
||||||
further notice in the next release.
|
further notice in the next release.
|
||||||
|
|
||||||
Only use documented functions and functionality!
|
Only use documented functions and functionality!
|
||||||
|
Loading…
Reference in New Issue
Block a user