1 _ _ ____ _ 2 ___| | | | _ \| | 3 / __| | | | |_) | | 4 | (__| |_| | _ <| |___ 5 \___|\___/|_| \_\_____| 6 7This directory is for libcurl programming examples. They are meant to show 8some simple steps on how you can build your own application to take full 9advantage of libcurl. 10 11If you end up with other small but still useful example sources, please mail 12them for submission in future packages and on the web site. 13 14BUILDING 15 16The Makefile.example is an example makefile that could be used to build these 17examples. Just edit the file according to your system and requirements first. 18 19Most examples should build fine using a command line like this: 20 21 $ `curl-config --cc --cflags --libs` -o example example.c 22 23Some compilers don't like having the arguments in this order but instead 24want you do reorganize them like: 25 26 $ `curl-config --cc` -o example example.c `curl-config --cflags --libs` 27 28*PLEASE* do not use the curl.haxx.se site as a test target for your libcurl 29applications/experiments. Even if some of the examples use that site as a URL 30at some places, it doesn't mean that the URLs work or that we expect you to 31actually torture our web site with your tests! Thanks. 32 33EXAMPLES 34 35anyauthput.c - HTTP PUT using "any" authentication method 36cacertinmem.c - Use a built-in PEM certificate to retrieve a https page 37cookie_interface.c - shows usage of simple cookie interface 38curlgtk.c - download using a GTK progress bar 39curlx.c - getting file info from the remote cert data 40debug.c - showing how to use the debug callback 41fileupload.c - uploading to a file:// URL 42fopen.c - fopen() layer that supports opening URLs and files 43ftpget.c - simple getting a file from FTP 44ftpgetresp.c - get the response strings from the FTP server 45ftpupload.c - upload a file to an FTP server 46ftpuploadresume.c - resume an upload to an FTP server 47getinfo.c - get the Content-Type from the recent transfer 48getinmemory.c - download a file to memory only 49ghiper.c - curl_multi_socket() using code with glib-2 50hiperfifo.c - downloads all URLs written to the fifo, using 51 curl_multi_socket() and libevent 52htmltidy.c - download a document and use libtidy to parse the HTML 53htmltitle.cc - download a HTML file and extract the <title> tag from a HTML 54 page using libxml 55http-post.c - HTTP POST 56httpput.c - HTTP PUT a local file 57https.c - simple HTTPS transfer 58multi-app.c - a multi-interface app 59multi-debugcallback.c - a multi-interface app using the debug callback 60multi-double.c - a multi-interface app doing two simultaneous transfers 61multi-post.c - a multi-interface app doing a multipart formpost 62multi-single.c - a multi-interface app getting a single file 63multithread.c - an example using multi-treading transferring multiple files 64opensslthreadlock.c - show how to do locking when using OpenSSL multi-threaded 65persistant.c - request two URLs with a persistent connection 66post-callback.c - send a HTTP POST using a callback 67postit2.c - send a HTTP multipart formpost 68sampleconv.c - showing how a program on a non-ASCII platform would invoke 69 callbacks to do its own codeset conversions instead of using 70 the built-in iconv functions in libcurl 71sepheaders.c - download headers to a separate file 72simple.c - the most simple download a URL source 73simplepost.c - HTTP POST 74simplessl.c - HTTPS example with certificates many options set 75synctime.c - Sync local time by extracting date from remote HTTP servers 7610-at-a-time.c - Download many files simultaneously, 10 at a time. 77