NAME

DynGig::Multiplex::TCP - Multiplexed TCP Client

SYNOPSIS

            

              
              
use DynGig::Multiplex::TCP;
## imagine these servers are echo servers ..
my @server = qw( host:port /unix/domain/socket ... );
my %config = ( timeout => 30, buffer => 'bob loblaw' );
my $client = DynGig::Multiplex::TCP->new( map { $_ => \%config } @server );
my %option =
(
    timeout => 300,     ## global timeout in seconds
    max_buf => 1024,    ## max number of bytes in each read buffer
    multiplex => 100,   ## max number of threads
    index => 'forward'  ## index results/errors by server
    verbose => *STDERR  ## report progress to STDERR
);
if ( $client->run( %option ) )
{
    my $result = $client->result() || {};
    my $error = $client->error() || {};
}
else
{
    print $client->error();
}
            
          

DESCRIPTION

run

Launches client with the following parameter. Returns 1 if successful. Returns 0 otherwise.

            

              
              
index     : index results/errors by server if set to 'forward'
timeout   : global timeout in seconds
max_buf   : max number of bytes in each read buffer
multiplex : max number of threads
verbose   : report progress to a file handle opened for write.
            
          

result()

Returns undef if no result. Returns a HASH reference indexed either by server or by result (see the index parameter of run().)

error()

Returns undef if no error. Returns a string if a global error occurred, else if errors occurred with individual client/server connections, returns a HASH reference indexed either by server or by result. (see the index parameter of run().)

SEE ALSO

Socket and IO::Poll

NOTE

See DynGig::Multiplex