|
|
= NAME =report
|
|
|
= SYNOPSIS = * report <test-command> [<log-filename>]
|
|
test_run function, to actually executethe test on the target.
|
= DESCRIPTION =This function performs the indicated command on the target device, andrecords it's output to the test log. This is commonly calledby a test's [[function_test_run|test_run]] function, to actually executethe test on the target.
|
|
See Log files for a description of the test log 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' usedto capture the output from the command, and used with the 'exit' statementto have this be the return code from the 'report' operation.
|
Note that the exit code from the command is preserved across the 'tee' usedto capture the output from the command, and used with the 'exit' statementto have this be the return code from the 'report' operation.
|
|
FIXTHIS - In the test_run function, this report function is used to retrieve stdout and stderr while running test script and then store its log in /fuego-rw/logs. This function is currently not good due to session ending when the board changes its IP address or SHUTDOWN. I suggest using the cmd and get from your API to avoid this kind of issue.
|
FIXTHIS - In the test_run function, this report function is used to retrieve stdout and stderr while running test script and then store its log in /fuego-rw/logs. This function is currently not good due to session ending when the board changes its IP address or SHUTDOWN. I suggest using the cmd and get from your API to avoid this kind of issue.
|
|
|
= EXAMPLES =Here are some sample invocations:{{{#!YellowBox report "hello-world.sh $HELLO_WORLD_ARG"}}}
|
|
|
= ENVIRONMENT and ARGUMENTS =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
|
The following variables are used: * FUEGO_HOME * TESTDIR
|
|
These are used to construct the default test log filename on the target, if alog filename is not specified in the positional arguments.
|
These are used to construct the default test log filename on the target, if alog filename is not specified in the positional arguments.
|
|
|
= RETURN =Returns non-zero on error.
|
|
|
= SOURCE =Located in ''scripts/functions.sh''
|
|
test_run, report_append, safe_cmd
|
= SEE ALSO = * [[function_test_run|test_run]], [[function_report_append|report_append]], [[function_safe_cmd|safe_cmd]]
|