Bryan Henderson


RPC::Xmlrpc_c::Client::Curl - Curl XML transport for RPC::Xmlrpc_c::Client


 use RPC::Xmlrpc_c::Client::Curl qw(:all);

 RPC::Xmlrpc_c::Client::Curl->createObject(TRANSPORT      => \my $transport,
                                           TRANSPORTPARMS => {},
                                           ERROR          => \my $error1);

 RPC::Xmlrpc_c::Client->createObject(TRANSPORT => $transport,
                                     CLIENT    => \my $client,
                                     ERROR     => \my $error2);


This module provides client XML transport functions for use with a RPC::Xmlrpc-c::Client XML-RPC client object. In particular, it provides functions based on HTTP using the Curl HTTP library. It uses XML-RPC For C/C++'s Curl transport.

Probably the only reason you would be interested in this class is that you need something like it to use RPC::Xmlrpc_c::Client, as seen in the example above.


    TRANSPORT      => \my $transport,
    ERROR          => \my $error1);

This creates a RPC::Xmlrpc_c::Client::Curl object.



      This is a reference to a scalar variable that the method sets to the handle of the new object.

      If you do not specify this option, you don't get a handle for the object, and as no reference is created to the object, it gets destroyed as soon as it is created. This is not very useful.

      If the method fails to create the object, it sets the variable arbitrarily. See ERROR.


      This is a reference to a hash of named transport parameters.


         { network_interface  => 'eth0',
           no_ssl_verify_peer => 1,
           timeout => 5

      The names (hash keys) are the names of the members of struct xmlrpc_curl_xportparms in Xmlrpc-c. This subroutine recognizes only the parameters up through timeout.

      Any transport parameter you don't specify defaults to the Xmlrpc-c default. If you specify a key that is not a valid transport parameter name, createObject() ignores it.


      This is a reference to a scalar variable that the method sets to a text description of why it is unable to create the object. If it is able to create the object, it sets it to undef.

      If you do not specify this option and creation fails, the method croaks.