README for Perl extension WWW::Curl The perl module WWW::Curl provides an interface to the cURL library "libcurl". See http://curl.haxx.se/ for more information on cURL and libcurl. This module requires libcurl and the corresponding headerfiles to be installed. You then may install this module via the usual way: perl Makefile.PL make make test # NEEDS CONFIGURATION - see note below make install The Makefile.PL script will try to use the 'curl-config' command to find the correct headers and libcurl path. If curl.h can't be found, either through curl-config or the internal list of guesses, you can specify an explicit path when building the Makefile: perl Makefile.PL /home/foo/curl/include The maintainer has never tried to run this on windows, so all feedback welcome. Testing: 'make test' will only run if you have a suitable test web server somewhere - the 'printenv' script commonly distributed with apache on linux is useable, for example. You need to set the environment variable CURL_TEST_URL to the URL of such a script and set the environment variable PERL_MM_USE_DEFAULT=1 for 'make test' to work automatically. Test 08ssl.t will only work well if you have a list of "well-known" CA certificates in the file 'ca-bundle.crt' in the current directory. This file can be obtained from most distributions of mod_ssl (www.modssl.org) - it isn't supplied here, as its currently >250Kbytes. The module provides the same functionality as libcurl provides to C programs, please refer to the documentation of libcurl. A number of examples may be found in t/*.t and examples/ directories. This software is distributed AS IS, WITHOUT WARRANTY OF ANY KIND, either express or implied. Send praise, patches, money, beer and pizza to the author. Send complaints to /dev/null. ;-) The author of the original relase of this software is Georg Horn <horn at koblenz-net.de> Parts of the callback support were added Forrest Cahoon <forrest.cahoon at merrillcorp.com> More callback support, many tests additional documentation and Makefile features have been added by Cris Bailiff <c.bailiff+curl at devsecure.com> Curl multi support has been added by Sebastian Riedel <sri at oook.de> The current maintainer is Cris Bailiff <c.bailiff+curl at devsecure.com> The latest version can be downloaded from http://curl.haxx.se/libcurl/perl/ or found on CPAN as the module WWW::Curl Copyright (C) 2000-2005, Daniel Stenberg, Cris Bailiff , et al. You may opt to use, copy, modify, merge, publish, distribute and/or sell copies of the Software, and permit persons to whom the Software is furnished to do so, under the terms of the MPL or the MIT/X-derivate licenses. You may pick one of these licenses.