NAME

XAS::Lib::SSH::Client::Exec - A class to interact with the SSH Exec facility

SYNOPSIS

 use XAS::Lib::SSH::Client::Exec;

 my $client = XAS::Lib::SSH::Client::Exec->new(
    -host     => 'test-xen-01',
    -username => 'root',
    -password => 'secret',
 );

 $client->connect();

 my @vms = $client->call('xe vm-list params', sub {
     my $output = shift;
     ...
 });

 $client->disconnect();

DESCRIPTION

The module uses the SSH Exec subsystem to execute commands. Which means it executes a procedure on a remote host and parses the resulting output. This module inherits from XAS::Lib::SSH::Client.

METHODS

setup

This method will set up the environment to execute commands using the exec subsystem on a remote system.

run($command)

This method does nothing.

call($command, $parser)

This method executes the command on the remote host and parses the output.

$command

The command string to be executed.

$parser

A coderef to the parser that will parse the returned data. The parser will accept one parameter which is a reference to that data.

The assumption with this method is that the remote command will return some sort of parsable data stream. After the data has been parsed the results is returned to the caller.

exit_code

Returns the exit code from the remote process.

exit_signal

Returns the exit signal from the remote process.

SEE ALSO

XAS::Lib::SSH::Client
XAS

AUTHOR

Kevin L. Esteb, <kevin@kesteb.us>

COPYRIGHT AND LICENSE

Copyright (c) 2012-2015 Kevin L. Esteb

This is free software; you can redistribute it and/or modify it under the terms of the Artistic License 2.0. For details, see the full text of the license at http://www.perlfoundation.org/artistic_license_2_0.