|
|
function report live in split format
|
|
= NAME =
report_live
|
|
|
= SYNOPSIS =
* report_live <test-command>
|
|
test_run function, to actually execute
the test on the target.
|
= DESCRIPTION =
This function performs the indicated command on the target device, and
records it's output to a "live" log on the host. This is commonly called
by a test's [[function_test_run|test_run]] function, to actually execute
the 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 returned as return
code from the 'report_live' operation.
|
Note that the exit code from the command is returned as return
code from the 'report_live' operation.
|
|
To record the output of a command run on the Fuego host, use log_this.
|
To record the output of a command run on the Fuego host, use [[function_log_this|log_this]].
|
|
|
= EXAMPLES =
Here are some sample invocations:
{{{#!YellowBox
report_live "hello-world.sh $HELLO_WORLD_ARG"
}}}
|
|
|
= ENVIRONMENT and ARGUMENTS =
The arguments to this function are:
* $1 - the command to execute on the target
|
|
|
= RETURN =
Returns non-zero on error.
|
|
|
= SOURCE =
Located in ''scripts/functions.sh''
|
|
test_run, report, cmd, log_this
|
= SEE ALSO =
* [[function_test_run|test_run]], [[function_report|report]], [[function_cmd|cmd]], [[function_log_this|log_this]]
|
|
|