Test_Specs_and_Plans >> function_report_append

Fuego wiki

function report append

NAME [edit section]

report_append

SYNOPSIS [edit section]

report_append <test-command> [<log-filename>]

DESCRIPTION [edit section]

This function performs the indicated command on the target device, and records it's output to the test log (appending it to the data already there). This is commonly called by a test's test_run function, to actually execute the test on the target.

See Log files for a description of the test log on the target.

Note that the exit code from the command is preserved across the 'tee' used to capture the output from the command, and used with the 'exit' statement to have this be the return code from the 'report' operation.

EXAMPLES [edit section]

FIXTHIS - need an example call for report_append

ENVIRONMENT and ARGUMENTS [edit section]

The arguments to this function are:

$1 - the command to execute on the target
$2 - (optional) the filename of the test log, on the target. If this is not specified, the value $BOARD_TESTDIR/fuego.$TESTDIR/$TESTDIR.log is used.

The following variables are used:

FUEGO_HOME
TESTDIR

These are used to construct the default test log filename on the target, if a log filename is not specified in the positional arguments.

RETURN [edit section]

Returns non-zero on error.

SOURCE [edit section]

Located in scripts/functions.sh