= NAME =
check_create_functional_logrun

= SYNOPSIS =
check_create_functional_logrun message

= DESCRIPTION =
If a batch testplan is being executed (BATCH_TESTPLAN and LOGRUN_FILE are set),
then the report log generator ([[loggen.py]]) is used to append results to the logrun file.

The report is placed in the REP_LOGRUN_FILE, which is in the report directory
($REP_DIR) and titled ${Device}.$LOGRUN_FILE.

If the report does not exist, it is created first.

This function is only ever called from [[function_log_compare|log_compare]]

= EXAMPLES =
Here are some sample invocations:
{{{#!YellowBox
check_create_functional_logrun "test error"
}}}

{{{#!YellowBox
check_create_functional_logrun "passed"
}}}

= ENVIRONMENT and ARGUMENTS =
This function takes 1 position argument:
 * $1 is a message

= RETURN =
Returns non-zero on error.

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

= SEE ALSO =
 * [[function_log_compare|log_compare]], [[loggen.py]]
 * [[function_check_create_logrun|check_create_logrun]] is the version of this function for benchmark tests