Debian Codegraph @

tests/test_mlx5_devx_async_events.py

raw
1 # SPDX-License-Identifier: (GPL-2.0 OR Linux-OpenIB)
2 # Copyright (c) 2025 Nvidia Inc. All rights reserved. See COPYING file
3
4 """
5 Test module for mlx5 DevX Async Events.
6 """
7
8 from pyverbs.providers.mlx5.mlx5_enums import mlx5dv_devx_create_event_channel_flags
9 from pyverbs.providers.mlx5.mlx5dv_event import EventChannel, EventFD
10 from pyverbs.pyverbs_error import PyverbsError
11 from tests.mlx5_base import Mlx5DevxRcResources, Mlx5DevxTrafficBase
12 import tests.utils as u
13
14 import time
15 import sys
16
17
18 EVENT_COOKIE = 100
19 OMIT_EV_DATA = mlx5dv_devx_create_event_channel_flags.MLX5DV_DEVX_CREATE_EVENT_CHANNEL_FLAGS_OMIT_EV_DATA
20 POLL_EVENT_TIMEOUT = 10
21 CQ_OVERRUN = 0x1
22
23
24 def get_event(event_c, fd=None, count=1):
25 """
26 Polls given event channel 'count' number of times
27 :param event_c: Event channel
28 :param fd: File descriptor
29 :param count: Number of expected events
30 :return: List of event responses
31 """
32 events_resp = []
33 start_poll_t = time.perf_counter()
34
35 while count > 0 and (time.perf_counter() - start_poll_t < POLL_EVENT_TIMEOUT):
36 try:
37 event = event_c.get_event(fd=fd)
38 events_resp.append(event)
39 except PyverbsError as err:
40 raise err
41 count -= 1
42
43 if count > 0:
44 raise PyverbsError(f'Got timeout on polling ({count} EQEs remaining)')
45
46 return events_resp
47
48
49 class Mlx5EventsTrafficTest(Mlx5DevxTrafficBase):
50 """
51 Test various functionality of mlx5 events
52 """
53 def cq_error_event(self, with_fd=True):
54 """
55 Creates DEVX resources and executes traffic without polling the CQ,
56 which generates CQ error
57 """
58 from tests.mlx5_prm_structs import EventType
59 self.create_players(Mlx5DevxRcResources)
60 fd = EventFD() if with_fd else None
61 cookie = EVENT_COOKIE if not with_fd else None
62 flags = OMIT_EV_DATA if with_fd else 0
63 ec = EventChannel(self.server.ctx, flags=flags)
64 ec.subscribe([EventType.CQ_ERROR], cookie=cookie, obj=self.server.cq, fd=fd)
65 for _ in range(self.client.num_msgs):
66 # Post send/recv without polling the CQ in order to exceed its size for CQ error event
67 self.server.post_recv()
68 self.client.post_send()
69 return get_event(ec, fd)
70
71 def test_cq_error_event_fd(self):
72 """
73 CQ error event test with FD
74 """
75 comp_events = self.cq_error_event()
76 self.assertEqual(len(comp_events), 1)
77 self.assertEqual(comp_events[0], 1)
78
79 def test_cq_error_event_cookie(self):
80 """
81 CQ error event test with cookie
82 """
83 from tests.mlx5_prm_structs import SwEqe, CreateCqOut
84 comp_events = self.cq_error_event(with_fd=False)
85 self.assertEqual(len(comp_events), 1)
86 data = SwEqe(comp_events[0].data).event_data
87 cqn = CreateCqOut(self.server.cq.out_view).cqn
88 self.assertEqual(comp_events[0].cookie, EVENT_COOKIE)
89 self.assertEqual(data.cqn, cqn)
90 self.assertEqual(data.syndrome, CQ_OVERRUN)