This page documents the Fuego core scripts functions.

The following functions are available to test scripts.

FIXTHIS - core functions: should document which of the functions are internal, and which are intended for test script use

list of routines (by providing script) [edit section]

= list of routines (by providing script) =
from functions.sh

• bench_processing
• do log processing for benchmark tests * build
• internal - perform the 'build' phase of test execution * function_build_cleanup
• internal - * build_error
• to be used externally - report an error and abort the test * check_capability
• check to see if the target has the specified capability * cmd
• to be used externally - execute a command on the target * concurrent_check
• wait for other test to complete before proceeding * deploy
• internal - perform the 'deploy phase of test execution * dump_syslogs
• dump the syslogs for the target under test * fail_check_cases * firmware
• get the firmware name from the target * get
• to be used externally - get a file or files from the target * get_testlog * hd_test_mount_prepare * hd_test_clean_umount * is_empty
• fail if an environment variable is empty * kill_procs
• kill process on the target * log_compare
• to be used by scripts (specifically by test_processing) * pre_build
• internal * pre_deploy
• internal * pre_test * post_build
• internal * post_deploy
• internal * post_test * put
• to be used externally - put a file or files on the target * report
• to be used externally - execute command and put stdout into log * report_append
• to be used externally - execute command and append stdout to log * report_devlog * safe_cmd
• to be used externally * syslog_cmp * target_cleanup * target_reboot
• reboot the target * target_setup_route_to_host * unpack - internal - used to unpack the test program source tarball

 * [[function_bench_processing|bench_processing]] - do log processing for benchmark tests
 * [[function_build|build]] - internal - perform the 'build' phase of test execution
 * [[function_build_cleanup]] - internal - 
 * [[function_build_error|build_error]] - to be used externally - report an error and abort the test
 * [[function_check_capability|check_capability]] - check to see if the target has the specified capability
 * [[function_cmd|cmd]] - to be used externally - execute a command on the target
 * [[function_concurrent_check|concurrent_check]] - wait for other test to complete before proceeding
 * [[function_deploy|deploy]] - internal - perform the 'deploy phase of test execution
 * [[function_dump_syslogs|dump_syslogs]] - dump the syslogs for the target under test
 * [[function_fail_check_cases|fail_check_cases]]
 * [[function_firmware|firmware]] - get the firmware name from the target
 * [[function_get|get]] - to be used externally - get a file or files from the target
 * [[function_get_testlog|get_testlog]]
 * [[function_hd_test_mount_prepare|hd_test_mount_prepare]]
 * [[function_hd_test_clean_umount|hd_test_clean_umount]]
 * [[function_is_empty|is_empty]] - fail if an environment variable is empty
 * [[function_kill_procs|kill_procs]] - kill process on the target
 * [[function_log_compare|log_compare]] - to be used by scripts (specifically by test_processing)
 * [[function_pre_build|pre_build]] - internal
 * [[function_pre_deploy|pre_deploy]] - internal
 * [[function_pre_test|pre_test]]
 * [[function_post_build|post_build]] - internal
 * [[function_post_deploy|post_deploy]] - internal
 * [[function_post_test|post_test]]
 * [[function_put|put]] - to be used externally - put a file or files on the target
 * [[function_report|report]] - to be used externally - execute command and put stdout into log
 * [[function_report_append|report_append]] - to be used externally - execute command and append stdout to log
 * [[function_report_devlog|report_devlog]]
 * [[function_safe_cmd|safe_cmd]] - to be used externally
 * [[function_syslog_cmp|syslog_cmp]]
 * [[function_target_cleanup|target_cleanup]]
 * [[function_target_reboot|target_reboot]] - reboot the target
 * [[function_target_setup_route_to_host|target_setup_route_to_host]]
 * [[function_unpack|unpack]] - internal - used to unpack the test program source tarball

• abort the current test, emitting a reason string to output * assert_define
• to be used externally - check that an environment variable is defined * run_python

from common.sh
 * [[function_abort_job|abort_job]] - abort the current test, emitting a reason string to output
 * [[function_assert_define|assert_define]] - to be used externally - check that an environment variable is defined
 * [[function_run_python|run_python]]

from reports.sh
 * [[function_check_create_logrun|check_create_logrun]]
 * [[function_check_create_functional_logrun|check_create_functional_logrun]]
 * [[function_set_testres_file|set_testres_file]]
 * [[function_gen_report|get_report]]

from overlays.sh
 * [[function_set_overlay_vars|set_overlay_vars]] - internal - process overlays and set variables for board, platform, test plan and test specs

FIXTHIS - need to document the ov_* functions as well, from the scripts in the engine/overlays/base directory.

From base-distrib.fuegoclass:
 * [[function_ov_get_firmware|ov_get_firmware]]
 * [[function_ov_rootfs_reboot|ov_rootfs_reboot]]
 * [[function_ov_rootfs_state|ov_rootfs_state]]
 * [[function_ov_logger|ov_logger]]
 * [[function_ov_rootfs_sync|ov_rootfs_sync]]
 * [[function_ov_rootfs_drop_caches|ov_rootfs_drop_caches]]
 * [[function_ov_rootfs_oom|ov_rootfs_oom]]
 * [[function_ov_rootfs_kill|ov_rootfs_kill]]
 * [[function_ov_rootfs_logread|ov_rootfs_logread]]

From base-board.fuegoclass:
 * [[function_ov_transport_get|ov_transport_get]]
 * [[function_ov_transport_put|ov_transport_put]]
 * [[function_ov_transport_cmd|ov_transport_cmd]]

From base-funcs.fuegoclass:
 * [[function_default_target_route_setup|default_target_route_setup]]