Debian Codegraph @

tests/test_mlx5_rdma_ctrl.py

raw
1 # SPDX-License-Identifier: (GPL-2.0 OR Linux-OpenIB)
2 # Copyright (c) 2025 Mellanox Technologies, Inc. All rights reserved. See COPYING file
3 """
4 Test module for Pyverbs' privileged context.
5 """
6 import unittest
7 import errno
8
9 from pyverbs.providers.mlx5.mlx5dv import Mlx5DevxObj
10 from pyverbs.pyverbs_error import PyverbsRDMAError
11 from tests.mlx5_base import Mlx5RcResources, Mlx5PrivilegedRC
12 from tests.utils import requires_root
13 from tests.base import RDMATestCase
14 import tests.utils as u
15
16
17 class Mlx5RdmaCtrl(Mlx5PrivilegedRC):
18 def __init__(self, dev_name, ib_port, gid_index, msg_size=1024, **kwargs):
19 """
20 Initialize mlx5 DV privileged context resources based on Mlx5PrivilegedRC.
21 :param dev_name: Device name to be used
22 :param ib_port: IB port of the device to use
23 :param gid_index: Which GID index to use
24 :param msg_size: The resource msg size
25 :param kwargs: General arguments
26 """
27 self.rdma_ctrl_obj = None
28 super().__init__(dev_name, ib_port, gid_index, msg_size=msg_size, **kwargs)
29
30 def get_vhca_id(self):
31 from tests.mlx5_prm_structs import QueryHcaCapIn, QueryCmdHcaCapOut
32 try:
33 query_cap_in = QueryHcaCapIn(op_mod=0x1)
34 query_cap_out = QueryCmdHcaCapOut(self.ctx.devx_general_cmd(
35 query_cap_in, len(QueryCmdHcaCapOut())))
36
37 if query_cap_out.status:
38 raise PyverbsRDMAError('Failed to query general HCA CAPs with syndrome '
39 f'({query_cap_out.syndrome}')
40
41 except PyverbsRDMAError as ex:
42 if ex.error_code in [errno.EOPNOTSUPP, errno.EPROTONOSUPPORT]:
43 raise unittest.SkipTest(f'mlx5dv_query_port() isn\'t supported')
44 raise ex
45
46 return query_cap_out.capability.vhca_id
47
48 def create_rdma_ctrl_obj(self, vhca_id):
49 """
50 Create rdma ctrl obj.
51 :param vhca_id: vhca id to control on.
52 """
53 from tests.mlx5_prm_structs import CreateGeneralObjIn, GeneralObjInCmdHdr, \
54 CreateGeneralObjOut, RdmaCtrlObj, DevxOps, DevxGeneralObjTypes
55 rdma_ctrl_obj_in = CreateGeneralObjIn(general_obj_in_cmd_hdr=GeneralObjInCmdHdr(
56 opcode=DevxOps.MLX5_CMD_OP_CREATE_GENERAL_OBJECT,
57 obj_type=DevxGeneralObjTypes.MLX5_OBJ_TYPE_RDMA_CTRL),
58 obj_context=RdmaCtrlObj(other_vhca_id=vhca_id))
59 self.rdma_ctrl_obj = Mlx5DevxObj(self.ctx, rdma_ctrl_obj_in, len(CreateGeneralObjOut()))
60 rdma_ctrl_obj_out = CreateGeneralObjOut(self.rdma_ctrl_obj.out_view)
61
62 if rdma_ctrl_obj_out.general_obj_out_cmd_hdr.status:
63 raise PyverbsRDMAError(f'Failed to create rdma ctrl obj with syndrome \
64 {rdma_ctrl_obj_out.general_obj_out_cmd_hdr.syndrome}')
65
66
67 class PrivilegeContextTestCase(RDMATestCase):
68 def tearDown(self):
69 """
70 Cleans up resources if manual cleanup is needed.
71 """
72 if self.client and self.client.rdma_ctrl_obj:
73 self.client.rdma_ctrl_obj.close()
74 super().tearDown()
75
76 @u.skip_unsupported
77 @requires_root()
78 def test_mlx5_rdma_ctrl_obj_traffic(self):
79 """
80 This test case verifies the functionality of Privilege RC traffic by executing the following
81 steps:
82 1. Initialize the client with Privilege RC context and server with regular RC context.
83 2. Get the VHCA ID of the client.
84 3. Create the RDMA control object on the client side (on privilege context).
85 4. Run the traffic between client and server.
86 """
87 self.client = Mlx5RdmaCtrl(**self.dev_info)
88 self.server = Mlx5RcResources(**self.dev_info)
89 vhca_id = self.client.get_vhca_id()
90 self.client.create_rdma_ctrl_obj(vhca_id)
91 self.pre_run()
92 self.sync_remote_attr()
93 u.traffic(client=self.client, server=self.server,iters=self.iters,
94 gid_idx=self.gid_index, port=self.ib_port, is_cq_ex=True)