From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mails.dpdk.org (mails.dpdk.org [217.70.189.124]) by inbox.dpdk.org (Postfix) with ESMTP id 7C1BC45837; Wed, 21 Aug 2024 21:40:08 +0200 (CEST) Received: from mails.dpdk.org (localhost [127.0.0.1]) by mails.dpdk.org (Postfix) with ESMTP id 76B6C42DE3; Wed, 21 Aug 2024 21:40:05 +0200 (CEST) Received: from mail-il1-f226.google.com (mail-il1-f226.google.com [209.85.166.226]) by mails.dpdk.org (Postfix) with ESMTP id 1A79642E12 for ; Wed, 21 Aug 2024 21:40:04 +0200 (CEST) Received: by mail-il1-f226.google.com with SMTP id e9e14a558f8ab-39d22965434so3751695ab.0 for ; Wed, 21 Aug 2024 12:40:04 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=iol.unh.edu; s=unh-iol; t=1724269203; x=1724874003; darn=dpdk.org; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:from:to:cc:subject:date :message-id:reply-to; bh=fxHR+NN639YW5bmVP5eg68VQbnbRJ2q5oubgi+B++Y0=; b=Nn/IeZVB0ZK1ugvvvvbtvjKD5xFNR6pvoqLIfFuuTuqyEqrNenM7uFsgXZbjEV5Ax8 RwYp86yzkBRiv1PupO6BAvc4ZOgwpeFnjN3mkyEdpJmQgKEbxVfQBBgkJtjni/WWcH0W jRWRcUALTjQDpmEcSjsCmfEiGbvrJZxr0fZos= X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1724269203; x=1724874003; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:x-gm-message-state:from:to:cc :subject:date:message-id:reply-to; bh=fxHR+NN639YW5bmVP5eg68VQbnbRJ2q5oubgi+B++Y0=; b=hzQDXBVpL3ju1cpldRATgaU9MwMTEmAyo29ngmSCx1XmVgZd1S14Ivu+5eA3oOlO6x 9XA2L2X0Dr8wWWAe57jgYZ0BWdTo2Rvk5f94PHqKSo5W2ZkFIBsHlpuluzZ5xohKf8tD KFGm/ZfO2BDVYxBp2ZnnGK8GDmicgh5u2iW7/bNGVjWVSvzSsb2FwYSwZhSa+eP1hUVJ tvXQp4vdh+ftN/qrS+PTj13v0z89471qnbnAfuO/QzYaJGeh05J9Mc1xzhfhCyP21u13 HepbM/R+NOx4KH8XKQhcFVU5FESPUnPia5tsLJeQ0ukXdgsrKVkn5Y1xcDCZiGv9glPk TVdg== X-Gm-Message-State: AOJu0YyQBXbQIa1m5hN93uZacyBLMxja5ETiyGfmIgWfH9hN8PLi13Q3 PMOHi0wAcbHUitd4lo+z8q1jozCRXnA0Hh5tvebiT6XKBqxbjes1r8iwm305j8cZypVae14ihpV 3Oq3ZNbcQocR70tt9e3G964IowKSSZZTk X-Google-Smtp-Source: AGHT+IGMQmpSmaag3knjN5gp+rLuzFDSAZM7g6NE+PmDNRlI4XYLWTkZIM7u5dybW6n4B1n/e21GFf4ySrlv X-Received: by 2002:a05:6e02:1c8e:b0:399:df91:bf57 with SMTP id e9e14a558f8ab-39d7252b3fcmr6719775ab.0.1724269203369; Wed, 21 Aug 2024 12:40:03 -0700 (PDT) Received: from postal.iol.unh.edu (postal.iol.unh.edu. [132.177.123.84]) by smtp-relay.gmail.com with ESMTPS id e9e14a558f8ab-39d64204f0esm1605015ab.38.2024.08.21.12.40.03 (version=TLS1_2 cipher=ECDHE-ECDSA-AES128-GCM-SHA256 bits=128/128); Wed, 21 Aug 2024 12:40:03 -0700 (PDT) X-Relaying-Domain: iol.unh.edu Received: from iol.unh.edu (unknown [IPv6:2606:4100:3880:1257::1083]) by postal.iol.unh.edu (Postfix) with ESMTP id 5B729605C351; Wed, 21 Aug 2024 15:40:02 -0400 (EDT) From: jspewock@iol.unh.edu To: npratte@iol.unh.edu, paul.szczepanek@arm.com, thomas@monjalon.net, probb@iol.unh.edu, yoan.picchi@foss.arm.com, juraj.linkes@pantheon.tech, wathsala.vithanage@arm.com, Luca.Vizzarro@arm.com, alex.chapman@arm.com, Honnappa.Nagarahalli@arm.com Cc: dev@dpdk.org, Jeremy Spewock Subject: [RFC PATCH v2 5/5] dts: add functions for managing VFs to Node Date: Wed, 21 Aug 2024 15:38:41 -0400 Message-ID: <20240821193841.21033-6-jspewock@iol.unh.edu> X-Mailer: git-send-email 2.46.0 In-Reply-To: <20240821193841.21033-1-jspewock@iol.unh.edu> References: <20240821191557.18744-1-jspewock@iol.unh.edu> <20240821193841.21033-1-jspewock@iol.unh.edu> MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-BeenThere: dev@dpdk.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: DPDK patches and discussions List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: dev-bounces@dpdk.org From: Jeremy Spewock In order for test suites to create virtual functions there has to be functions in the API that developers can use. This patch adds the ability to create virtual functions to the Node API so that they are reachable within test suites. Bugzilla ID: 1500 Signed-off-by: Jeremy Spewock --- dts/framework/testbed_model/node.py | 96 ++++++++++++++++++++++++++++- 1 file changed, 94 insertions(+), 2 deletions(-) diff --git a/dts/framework/testbed_model/node.py b/dts/framework/testbed_model/node.py index 85d4eb1f7c..101a8edfbc 100644 --- a/dts/framework/testbed_model/node.py +++ b/dts/framework/testbed_model/node.py @@ -14,6 +14,7 @@ """ import os +import re import tarfile from abc import ABC from ipaddress import IPv4Interface, IPv6Interface @@ -24,9 +25,10 @@ OS, BuildTargetConfiguration, NodeConfiguration, + PortConfig, TestRunConfiguration, ) -from framework.exception import ConfigurationError +from framework.exception import ConfigurationError, InternalError from framework.logger import DTSLogger, get_dts_logger from framework.settings import SETTINGS @@ -39,7 +41,7 @@ ) from .linux_session import LinuxSession from .os_session import OSSession -from .port import Port +from .port import Port, VirtualFunction class Node(ABC): @@ -335,6 +337,96 @@ def _bind_port_to_driver(self, port: Port, for_dpdk: bool = True) -> None: verify=True, ) + def create_virtual_functions( + self, num: int, pf_port: Port, dpdk_driver: str | None = None + ) -> list[VirtualFunction]: + """Create virtual functions (VFs) from a given physical function (PF) on the node. + + Virtual functions will be created if there are not any currently configured on `pf_port`. + If there are greater than or equal to `num` VFs already configured on `pf_port`, those will + be used instead of creating more. In order to create VFs, the PF must be bound to its + kernel driver. This method will handle binding `pf_port` and any other ports in the test + run that reside on the same device back to their OS drivers if this was not done already. + VFs gathered in this method will be bound to `driver` if one is provided, or the DPDK + driver for `pf_port` and then added to `self.ports`. + + Args: + num: The number of VFs to create. Must be greater than 0. + pf_port: The PF to create the VFs on. + dpdk_driver: Optional driver to bind the VFs to after they are created. Defaults to the + DPDK driver of `pf_port`. + + Raises: + InternalError: If `num` is less than or equal to 0. + """ + if num <= 0: + raise InternalError( + "Method for creating virtual functions received a non-positive value." + ) + if not dpdk_driver: + dpdk_driver = pf_port.os_driver_for_dpdk + # Get any other port that is on the same device which DTS is aware of + all_device_ports = [ + p for p in self.ports if p.pci.split(".")[0] == pf_port.pci.split(".")[0] + ] + # Ports must be bound to the kernel driver in order to create VFs from them + for port in all_device_ports: + self._bind_port_to_driver(port, False) + # Some PMDs require the interface being up in order to make VFs + self.configure_port_state(port) + created_vfs = self.main_session.set_num_virtual_functions(num, pf_port) + # We don't need more then `num` VFs from the list + vf_pcis = self.main_session.get_pci_addr_of_vfs(pf_port)[:num] + devbind_info = self.main_session.send_command( + f"{self.path_to_devbind_script} -s", privileged=True + ).stdout + + ret = [] + + for pci in vf_pcis: + original_driver = re.search(f"{pci}.*drv=([\\d\\w-]*)", devbind_info) + os_driver = original_driver[1] if original_driver else pf_port.os_driver + vf_config = PortConfig( + self.name, pci, dpdk_driver, os_driver, pf_port.peer.node, pf_port.peer.pci + ) + vf_port = VirtualFunction(self.name, vf_config, created_vfs, pf_port) + self.main_session.update_ports([vf_port]) + self._bind_port_to_driver(vf_port) + self.ports.append(vf_port) + ret.append(vf_port) + return ret + + def get_vfs_on_port(self, pf_port: Port) -> list[VirtualFunction]: + """Get all virtual functions (VFs) that DTS is aware of on `pf_port`. + + Args: + pf_port: The port to search for the VFs on. + + Returns: + A list of VFs in the framework that were created/gathered from `pf_port`. + """ + return [p for p in self.ports if isinstance(p, VirtualFunction) and p.pf_port == pf_port] + + def remove_virtual_functions(self, pf_port: Port) -> None: + """Removes all virtual functions (VFs) created on `pf_port` by DTS. + + Finds all the VFs that were created from `pf_port` and either removes them if they were + created by the DTS framework or binds them back to their os_driver if they were preexisting + on the node. + + Args: + pf_port: Port to remove the VFs from. + """ + vf_ports = self.get_vfs_on_port(pf_port) + if any(vf.created_by_framework for vf in vf_ports): + self.main_session.set_num_virtual_functions(0, pf_port) + else: + self._logger.info("Skipping removing VFs since they were not created by DTS.") + # Bind all VFs that we are no longer using back to their original driver + for vf in vf_ports: + self._bind_port_to_driver(vf, for_dpdk=False) + self.ports = [p for p in self.ports if p not in vf_ports] + def create_session(node_config: NodeConfiguration, name: str, logger: DTSLogger) -> OSSession: """Factory for OS-aware sessions. -- 2.46.0