/ 
Rex-0.50.0
River stage two • 22 direct dependents • 22 total dependents
/ Rex

NAME

Rex - Remote Execution

DESCRIPTION

(R)?ex is a small script to ease the execution of remote commands. You can write small tasks in a file named Rexfile.

You can find examples and howtos on http://rexify.org/

GETTING HELP

SYNOPSIS

user "root";
password "ch4ngem3";

desc "Show Unix version";
task "uname", sub {
   say run "uname -a";
};

bash# rex -H "server[01..10]" uname

See Rex::Commands for a list of all commands you can use.

CLASS METHODS

get_current_connection

This function is deprecated since 0.28! See Rex::Commands::connection.

Returns the current connection as a hashRef.

server

The server name

ssh

1 if it is a ssh connection, 0 if not.

is_ssh

Returns 1 if the current connection is a ssh connection. 0 if not.

is_local

Returns 1 if the current connection is local. Otherwise 0.

is_sudo

Returns 1 if the current operation is executed within sudo.

get_sftp

Returns the sftp object for the current ssh connection.

connect

Use this function to create a connection if you use Rex as a library.

use Rex;
use Rex::Commands::Run;
use Rex::Commands::Fs;

Rex::connect(
  server    => "remotehost",
  user      => "root",
  password   => "f00b4r",
  private_key => "/path/to/private/key/file",
  public_key  => "/path/to/public/key/file",
);

if(is_file("/foo/bar")) {
  print "Do something...\n";
}

my $output = run("uptime");

CONTRIBUTORS

Many thanks to the contributors for their work (alphabetical order).

alex1line
Alexandr Ciornii
Anders Ossowicki
Andrej Zverev
bollwarm
Boris Däppen
Cameron Daniel
Chris Steigmeier
complefor
Cuong Manh Le
Daniel Baeurer
David Golovan
Dominik Danter
Dominik Schulz
eduardoj
fanyeren
Ferenc Erki
Fran Rodriguez
Franky Van Liedekerke
Gilles Gaudin, for writing a french howto
Hiroaki Nakamura
Ilya Evseev
Jean Charles Passard
Jean-Marie Renouard
Jeen Lee
Jens Berthold
Jonathan Delgado
Jon Gentle
Joris
Jose Luis Martinez
Kasim Tuman
Keedi Kim
Laird Liu
Mario Domgoergen
Nathan Abu
Niklas Larsson
Nikolay Fetisov
Nils Domrose
Peter H. Ezetta
Piotr Karbowski
Rao Chenlin (Chenryn)
RenatoCRON
Renee Bäcker
Samuele Tognini
Sascha Guenther
Simon Bertrang
Stephane Benoit
Sven Dowideit
Tianon Gravi
Tokuhiro Matsuno
Tomohiro Hosaka