Rex::Commands::Upload(3p)

NAME
Rex::Commands::Upload - Upload a local file to a remote server

DESCRIPTION
With this module you can upload a local file via sftp to a remote host.

SYNOPSIS
 task "upload", "remoteserver", sub {
   upload "localfile", "/remote/file";
 };

EXPORTED FUNCTIONS

  upload($local, $remote)
Perform an upload. If $remote is a directory the file will be uploaded to that directory.

 task "upload", "remoteserver", sub {
   upload "localfile", "/path";
 };

This function supports the following hooks:

before
    This gets executed before anything is done. All original parameters are passed to it.

    The return value of this hook overwrites the original parameters of the function-call.

before_change
    This gets executed right before the new file is written. The local file name, and the remote file name are passed as parameters.

after_change
    This gets executed right after the file was written. On top of the local file name, and the remote file name, any returned results are passed as parameters.

after
    This gets executed right before the "upload()" function returns. All original parameters, and any results returned are passed to it.