FreeBSD Manual Pages
libcurl-easy(3) Library Functions Manual libcurl-easy(3) NAME libcurl-easy - easy interface overview DESCRIPTION When using libcurl's "easy" interface you init your session and get a handle (often referred to as an "easy handle"), which you use as input to the easy interface functions you use. Use curl_easy_init(3) to get the handle. You continue by setting all the options you want in the upcoming trans- fer, the most important among them is the URL itself (you cannot trans- fer anything without a specified URL). You might want to set some call- backs as well that are called from the library when data is available etc. For example CURLOPT_WRITEFUNCTION(3). curl_easy_setopt(3) is used for all this. CURLOPT_URL(3) is the only option you really must set, as otherwise there can be no transfer. Another commonly used option is CURLOPT_VER- BOSE(3) that helps you see what libcurl is doing under the hood, which is useful when debugging for example. The curl_easy_setopt(3) man page has a full index of the over 300 available options. If you at any point would like to blank all previously set options for a single easy handle, you can call curl_easy_reset(3) and you can also make a clone of an easy handle (with all its set options) using curl_easy_duphandle(3). When all is setup, you tell libcurl to perform the transfer using curl_easy_perform(3). It performs the entire transfer operation and does not return until it is done (successfully or not). After the transfer has been made, you can set new options and make an- other transfer, or if you are done, cleanup the session by calling curl_easy_cleanup(3). If you want persistent connections, you do not cleanup immediately, but instead run ahead and perform other transfers using the same easy handle. SEE ALSO curl_easy_cleanup(3), curl_easy_init(3), curl_easy_setopt(3), libcurl(3), libcurl-errors(3), libcurl-multi(3) libcurl 2025-06-03 libcurl-easy(3)
NAME | DESCRIPTION | SEE ALSO
Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=libcurl-easy&sektion=3&manpath=FreeBSD+Ports+14.3.quarterly>