NAME

GRID::Cluster::Handle - The object that manages GRID::Cluster unidirectional and bidirectional pipes

DESCRIPTION

The result of a call to the methods open or open2 of GRID::Cluster is a reference to a GRID::Cluster::Handle object. This kind of object manages GRID::Cluster unidirectional and bidirectional pipes used during the execution of remote commands.

A GRID::Cluster::Handle object has the following attributes:

• readset

  A reference to a IO::Select object. It contains the handles to make reading operations over the pipes.

• proc

  A reference to a list that contains the reading handles of a pipe. This attribute is only used by the methods open and close.

• rproc

  A reference to a list that contains the reading handles of a pipe. This attribute is only used by the methods open2 and close2.

• wproc

  A reference to a list that contains the writing handles of a pipe. This attribute is only used by the methods open2 and close2.

• pid

  A reference to a list that contains the PIDs of the processes that have been opened.

• id

  A reference to a hash. The keys are unique identificators of every pipe reading handle. The values are numbers that identify every reading handle.

• map_id_machine

  A reference to a hash. The keys are the id numbers of the reading handles. The values are the names of every machine.

METHODS

The Constructor new

Syntax:

  my $cluster_handles = GRID::Cluster::Handle->new (
    readset        => $readset,
    rproc          => \@rproc,
    wproc          => \@wproc,
    pid            => \@pid,
    id             => \%id,
    map_id_machine => \%map_id_machine
  );

In the case of using the methods open2 and close2.

  my $cluster_handles = GRID::Cluster::Handle->new (
    readset        => $readset,
    proc           => \@proc,
    pid            => \@pid,
    id             => \%id,
    map_id_machine => \%map_id_machine
  );

In the case of using the methods open and close.

SEE ALSO

• GRID::Cluster

• GRID::Cluster::Tutorial

• GRID::Machine

• IPC::PerlSSH

• http://www.openssh.com

• http://www.csm.ornl.gov/torc/C3/

• Man pages of ssh, ssh-key-gen, ssh_config, scp, ssh-agent, ssh-add, sshd

AUTHORS

Eduardo Segredo Gonzalez <esegredo@ull.es> and Casiano Rodriguez Leon <casiano@ull.es>

AKNOWLEDGEMENTS

This work has been supported by the EC (FEDER) and the Spanish Ministry of Science and Innovation inside the 'Plan Nacional de I+D+i' with the contract number TIN2008-06491-C04-02.

Also, it has been supported by the Canary Government project number PI2007/015.

The work of Eduardo Segredo was funded by grant FPU-AP2009-0457.

COPYRIGHT AND LICENSE

Copyright (C) 2010 by Casiano Rodriguez Leon and Eduardo Segredo Gonzalez. All rights reserved.

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself, either Perl version 5.12.2 or, at your option, any later version of Perl 5 you may have available.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.