= NAME =
test_deploy

= SYNOPSIS =
Deploys the test program to the target

= DESCRIPTION =
This function is defined in the base test script for a test, and executes those
commands required to deploy the (recently built) test program to the target.

When this function starts, the source code for the test program has been built, and the current directory is the root directory where the source
is located (in /fuego-rw/buildzone/<''test_name''-''platform_name''/>

The usual operation is to call 'put' to move the test program to the target, but if there are auxiliary programs, scripts or data files, sometimes it is
necessary to create an archive on the host, send it to the target, and unpack
it on the target.

Test materials should be put in the directory $BOARD_TESTDIR/fuego.$TESTDIR on
the target.

== Commonly called functions or programs ==
This function can contain calls to just about any command, but there are some
common commands used for building Linux source
 * [[function_put|put]] - used to put a file or multiple files on the target
 * tar - used to archive multiple files on the host
 * [[function_cmd|cmd]] - used to execute other commands, in preparation for test execution, on the target

= EXAMPLES =
Some sample contents are:
{{{#!YellowBox
function test_deploy {
    put hello $BOARD_TESTDIR/fuego.$TESTDIR
}
}}}

{{{#!YellowBox
function test_deploy {
    put {sample*,run-tests.sh} $BOARD_TESTDIR/fuego.$TESTDIR
}
}}}

{{{#!YellowBox
function test_deploy {
    tar cf XML-Test-Suite.tar XML-Test-Suite/
    put -r XML-Test-Suite.tar tests/.libs/* tests/xmltest.sh  $BOARD_TESTDIR/fuego.$TESTDIR/;

    cmd "cd $BOARD_TESTDIR/fuego.$TESTDIR; tar xf XML-Test-Suite.tar"
    cmd "mkdir -p $BOARD_TESTDIR/xmlwf";

    put xmlwf/.libs/xmlwf  $BOARD_TESTDIR/xmlwf/xmlwf;
}
}}}



= ENVIRONMENT and ARGUMENTS =
Some environment variables commonly used are:
 * $BOARD_TESTDIR
 * $TESTDIR

There are no arguments to this function.


= RETURN =
returns non-zero for error

= SOURCE =
Located in the base script for each test.  The base test scripts are located in /home/jenkins/fuego/engine/tests/<test_name>.

An example path would be: ''/home/jenkins/fuego/engine/tests/Functional.hello_world/hello_world.sh''

= SEE ALSO =
 * [[function_deploy|deploy]], [[function_pre_deploy|pre_deploy]], [[function_post_deploy|post_deploy]]