[guest-test] New Test: example code of leverage lkvs amx test

add example code to leverage
lkvs/state-components-validation-utilities/amx/tmul test code and run
test in legacy VM and tdx VM

[Test Components] amx
[Test Types] func
[Supported Devices] all-generic

Signed-off-by: Hongyu Ning <[email protected]>

guest-test/amx/amx.test_executor.sh

@@ -0,0 +1,74 @@
+#!/bin/bash
+# SPDX-License-Identifier: GPL-2.0-only
+# Copyright (c) 2024 Intel Corporation
+
+# Author:   Hongyu Ning <[email protected]>
+#
+# History:  10, Jan., 2024 - Hongyu Ning - creation
+
+
+# @desc This script prepare and run $TESTCASE in for $FEATURE amx
+# in VM; please note, $FEATURE name and subfolder name under guest-test
+# must be the exactly same, here FEATURE=amx
+
+###################### Variables ######################
+## common variables example ##
+SCRIPT_DIR_LOCAL="$( cd "$( dirname "$0" )" && pwd )"
+echo "$SCRIPT_DIR_LOCAL"
+# get test scenario config for $FEATURE tdx test_executor
+source "$SCRIPT_DIR_LOCAL"/../test_params.py
+## end of common variables example ##
+
+###################### Functions ######################
+## $FEATURE specific Functions ##
+
+###################### Do Works ######################
+## common works example ##
+cd "$(dirname "$0")" 2>/dev/null || exit 1
+source ../../.env
+
+# get test_executor common functions:
+# function based on sshpass to scp common.sh and optional $1 test_script.sh to Guest VM
+## guest_test_prepare
+# function based on sshpass to scp $1 source_code_dir and compile $2 test_binary in Guest VM
+## guest_test_source_code
+# function based on sshpass to execute $1 test_script.sh/test_bin and potential $2 script params in Guest VM
+## guest_test_entry
+# function based on sshpass to close VM
+## guest_test_close
+source "$SCRIPT_DIR"/guest.test_executor.sh
+
+cd "$SCRIPT_DIR_LOCAL" || die "fail to switch to $SCRIPT_DIR_LOCAL"
+## end of common works example ##
+
+## $FEATURE specific code path ##
+# select test_functions by $TESTCASE
+case "$TESTCASE" in
+  GUEST_TESTCASE_EXAMPLE)
+    guest_test_prepare guest_test.sh
+    guest_test_source_code test_source_code_dir_example test_binary_example
+    guest_test_entry guest_test.sh "-t $TESTCASE" || \
+    die "Failed on $TESTCASE guest_test.sh -t $TESTCASE"
+    if [[ $GCOV == "off" ]]; then
+      guest_test_close
+    fi
+    ;;
+  TMUL_1)
+    guest_test_prepare
+    guest_test_source_code "$SCRIPT_DIR/../state-components-validation-utilities/amx/tmul" tmul || \
+            die "Failed to prepare guest test source code for $TESTCASE"
+    guest_test_entry tmul "-b 2 -t 10 -c 20 -i 1" || \
+            die "Failed on $TESTCASE"
+    if [[ $GCOV == "off" ]]; then
+      guest_test_close
+    fi
+    ;;
+  :)
+    test_print_err "Must specify the test scenario option by [-t]"
+    usage && exit 1
+    ;;
+  \?)
+    test_print_err "Input test case option $TESTCASE is not supported"
+    usage && exit 1
+    ;;
+esac

guest-test/amx/tests

@@ -0,0 +1,2 @@
+./guest-test/guest.test_launcher.sh -v 1 -s 1 -m 1 -d on -t legacy -f amx -x TMUL_1 -c " " -p off
+./guest-test/guest.test_launcher.sh -v 1 -s 1 -m 1 -d on -t tdx -f amx -x TMUL_1 -c "accept_memory=lazy" -p off