= NAME =
get_testlog

= SYNOPSIS =
 * get_testlog <testdir> [<testlog-filename>]

= DESCRIPTION =
Retrieve the test log from the target device.

= EXAMPLES =
Here are some sample invocations:
{{{#!YellowBox
    get_testlog $TESTDIR $FUEGO_HOME/fuego.$TESTDIR/$TESTDIR.log
}}}

= ENVIRONMENT and ARGUMENTS =
 * $1 = testdir
 * $2 = (optional) testlog-filename, which is the name of test log on target to retrieve. If this is not specified, the following default is used: $FUEGO_HOME/fuego.$TESTDIR/$TESTDIR.log

The following values are used by the routine:
 * FUEGO_LOGS_PATH
 * JOB_NAME
 * NODE_NAME
 * BUILD_ID
 * BUILD_NUMBER

These are used to construct the output path for the logfile (on the host),
which is: $FUEGO_LOGS_PATH/${JOB_NAME}/testlogs/${NODE_NAME}.${BUILD_ID}.${BUILD_NUMBER}.log



= RETURN =
Returns non-zero on error.

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

= SEE ALSO =
 * [[function_bench_processing|bench_processing]], [[function_get|get]]