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 header files to be
installed. 

For example on Ubuntu installing libcurl4-openssl-dev will satisfy this
dependency.

You then may install this module via the usual way
(for installation on Windows please see README.Win32):

    perl Makefile.PL
    make
    make test
    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

If you want to specify which curl-config to use instead of the first in path 
set the environment variable CURL_CONFIG to point at the curl-config to use.

Minimum version requirements:

This module, starting from version 4 requires at least Perl 5.6.1 and libcurl 7.10.8.
These releases are more than 5 years old and they have multiple security vulnerabilities,
it is advised that you upgrade as soon as possible to a more recent, secure version.
Anything older than these versions of Perl and libcurl respectively is not supported.

Windows specific fixes and patches are welcome as testing is mainly focused on Linux.

The module provides the same functionality, except as noted in the documentation, 
as libcurl provides to C programs. Please refer to the documentation of libcurl for the
general interface description and the WWW::Curl POD for the differences.

This software is distributed AS IS, WITHOUT WARRANTY OF ANY KIND, either
express or implied.

History:

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 maintainers are Cris Bailiff <c.bailiff+curl at devsecure.com> and
Bálint Szilakszi <szbalint at cpan.org>

The latest version is available on CPAN - https://metacpan.org/pod/WWW::Curl .

The source code repository is available at https://github.com/szbalint/WWW--Curl .
 
Copyright (C) 2000-2005, 2008-2010 Daniel Stenberg, Cris Bailiff, Bálint Szilakszi, 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.