libcurl(3)            libcurl easy interface           libcurl(3)



NAME
       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"),  which you use as input to the easy interface func-
       tions you use. Use curl_easy_init(3) 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(3) is used for all this.

       When all is setup, you tell libcurl to perform the  trans-
       fer  using  curl_easy_perform(3).   It  will  then  do the
       entire operation and won't return until it is  done  (suc-
       cessfully 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(3). If you want per-
       sistent connections, you don't  cleanup  immediately,  but
       instead  run  ahead  and perform other transfers using the
       same easy handle.




libcurl 7.10.7             12 Aug 2003                 libcurl(3)