= NAME =
put

= SYNOPSIS =
 * put [-r] <file1> [<file2>...] <destination>

= DESCRIPTION =
The 'put' function is used to transfer directories and files to the target.

It adds a statement to the devlog, and then calls [[function ov_transport_put|ov_transport_put]].

It takes the '-r' option to allow putting items recursively.
You can use wildcards in the file specifications.

= EXAMPLES =
Here are some example calls

{{{#!YellowBox
    put hello $TEST_HOME/fuego.$TESTDIR
}}}

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

{{{#!YellowBox
    put -r XML-Test-Suite.tar tests/.libs/* tests/xmltest.sh  $FUEGO_HOME/fuego.$TESTDIR/;
}}}


= ENVIRONMENT and ARGUMENTS =

The arguments are passed unchanged to ov_transport_put.
 * -r may be passed in the first position, to specify to recursively transfer directories and files
 * the last argument should be an destination directory on the target.  The directory should be a full path (specified from the root)

= RETURN =
Returns non-zero on error

= SOURCE =
Located in ''scripts/functions.sh''

= SEE ALSO =
 * [[function ov_transport_put|ov_transport_put]], [[function_get|get]], [[function_test_deploy|test_deploy]]