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