libcurl-easy(3)

libcurl(3)           libcurl easy interface            libcurl(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  transfer, the most important among them is the URL
     itself (you can't transfer anything without a specified  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  transfer
     using  curl_easy_perform(3).   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(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      Last change: 12 Aug 2003                    1