NAME

WWW::Curl::Multi - Perl extension interface for libcurl

SYNOPSIS

        use WWW::CURL::Multi;
        my $curlm = new WWW::Curl::Multi;
        $curlm->add_handle($curl);
        $curlm->perform;
        $curlm->remove_handle($curl);

DESCRIPTION

WWW::Curl::Multi is an extension to WWW::Curl::Easy which makes it possible to process multiple easy handles parallel.

METHODS

        $curlm = new WWW::Curl::Multi
                This method constructs a new WWW::Curl::Multi object.

        $curlm->add_handle( $curl )
                This method adds a WWW::Curl::Easy object to the multi stack.

        $curlm->perform
                This method parallel perlforms all WWW::Curl::Easy objects
                on the stack.

        *Warning* - this does not perform exactly the
        same functions as the direct libcurl function - for example,
        there's no opportunity to get the fdset back at any time, so
        this interface could change in future as those functions
        are added.

        $curl->remove_handle( $curl )
                This method removes a WWW::Curl::Easy object from the stack.

        *Note* If you want to use several times one set of handles for
        different requests, remove them, change options (f.e. CURLOPT_URL),
        and add back.

        $curlm->strerror( ErrNo )
                This method returns a string describing the CURLMcode error 
                code passed in the argument errornum.

AUTHOR

Sebastian Riedel (sri@cpan.org)

COPYRIGHT

Copyright (C) 2004 Sebastian Riedel, 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.

SEE ALSO

WWW::Curl, WWW::Curl::Easy, http://curl.haxx.se/