= NAME =
report_live

= SYNOPSIS =
 * report_live <test-command>

= 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.

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 [[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''

= SEE ALSO =
 * [[function_test_run|test_run]], [[function_report|report]], [[function_cmd|cmd]], [[function_log_this|log_this]]