libcurl-easy - easy interface overview


DESCRIPTION

       When  using  libcurl's "easy" interface you init your ses-
       sion and get a handle (often referred to as an "easy  han-
       dle"  in various docs and sources), which you use as input
       to   the   easy   interface   functions   you   use.   Use
       curl_easy_init() to get the handle.

       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 without a speci-
       fied URL as you may have figured out yourself). You  might
       want  to  set  some  callbacks as well that will be called
       from   the   library   when   data   is   available   etc.
       curl_easy_setopt() is used for all this.

       When  all is setup, you tell libcurl to perform the trans-
       fer using curl_easy_perform().  It will then do the entire
       operation  and won't return until it is done (successfully
       or not).

       After the transfer has been made, you can set new  options
       and  make another transfer, or if you're done, cleanup the
       session by calling curl_easy_cleanup(). If you  want  per-
       sistant  connections,  you  don't cleanup immediately, but
       instead run ahead and perform other  transfers  using  the
       same easy handle.

























Man(1) output converted with man2html