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