NetKVM: Add a case for checking the keyword in the driver logs

Configure the driver with TX capacity of 64 (instead of default of 1024)
and check in the driver logs that the driver limit the SG
(scatter-gather) area " Limit m_SGTableCapacity by 64"

Signed-off-by: wji <[email protected]>

qemu/tests/cfg/netkvm_params_check.cfg

@@ -0,0 +1,15 @@
+- netkvm_params_check:
+    virt_test_type = qemu
+    type = netkvm_params_check
+    only Windows
+    only virtio_net
+    vhost = on
+    timeout = 360
+    smp ~= ${vcpu_maxcpus}
+    queues = ${smp}
+    netkvmco_name = "TXcapacity"
+    netkvmco_value = "64"
+    expected_log_msg = "Limit m_SGTableCapacity by 64"
+    cdroms += " virtio"
+    required_virtio_win_prewhql = [0.1.242 , )
+    required_virtio_win = [1.9.36.0, )

qemu/tests/netkvm_params_check.py

@@ -0,0 +1,73 @@
+import logging
+import re
+
+from virttest import error_context, utils_net
+
+LOG_JOB = logging.getLogger("avocado.test")
+
+
+@error_context.context_aware
+def run(test, params, env):
+    """
+    Netkvm log checking using traceview:
+
+    1) Start the VM.
+    2) Configure and verify the advanced parameters of the NIC.
+    3) Use TraceView.exe to apply filters and capture relevant keywords.
+    4) Restart the NIC.
+    5) Monitor the output in TraceView.exe and extract the captured keywords.
+    6) Restore the default parameter value
+
+    :param test: QEMU test object
+    :param params: Dictionary with the test parameters
+    :param env: Dictionary with test environment.
+    """
+
+    def get_keyword_from_traceview(keyword):
+        """
+        Get the keyword by `TraceView.exe`
+
+        Return the keywords which means that we found it.
+        """
+
+        device_mac = vm.virtnet[0].mac
+        error_context.context(f"Check {keyword} from the traceview", test.log.info)
+        output = utils_net.dump_traceview_log_windows(params, vm)
+        utils_net.restart_guest_network(session, device_mac, params["os_type"])
+        mapping_output = re.findall(keyword, output)
+        if mapping_output == []:
+            test.fail(f"Can't get {keyword} from traceview")
+        return mapping_output
+
+    def set_and_verify_parameter_value(value):
+        """
+        Get and Set the value by `netkvmco.exe`
+
+        Raised exception when checking netkvmco.exe setup was unsuccessful.
+        """
+
+        utils_net.set_netkvm_param_value(vm, netkvmco_name, value)
+        cur_value = utils_net.get_netkvm_param_value(vm, netkvmco_name)
+        if cur_value != value:
+            test.fail(
+                f"Current value '{cur_value}' was not restored to default "
+                f"value '{default_value}'"
+            )
+
+    timeout = params.get_numeric("login_timeout", 240)
+    vm_name = params["main_vm"]
+    vm = env.get_vm(vm_name)
+    vm.verify_alive()
+    session = vm.wait_for_serial_login(timeout=timeout)
+    netkvmco_name = params.get("netkvmco_name")
+    netkvmco_value = params.get("netkvmco_value")
+    expected_log_msg = params.get("expected_log_msg")
+    default_value = utils_net.get_netkvm_param_value(vm, netkvmco_name)
+    # Set the new parameter value
+    set_and_verify_parameter_value(value=netkvmco_value)
+    # Check for the expected log message
+    result = get_keyword_from_traceview(expected_log_msg)
+    error_context.context(f"Found '{result}' in TraceView logs", logging.info)
+    # Restore the default parameter value
+    set_and_verify_parameter_value(value=default_value)
+    session.close()