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]]

• check_create_functional_logrun
• set_testres_file
• get_report

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.

• ov_rootfs_reboot
• ov_rootfs_state
• ov_logger
• ov_rootfs_sync
• ov_rootfs_drop_caches
• ov_rootfs_oom
• ov_rootfs_kill
• ov_rootfs_logread

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]]

• ov_transport_put
• ov_transport_cmd

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]]