cuda.core.system.register_events#

cuda.core.system.register_events( events: SystemEventType | int | list[SystemEventType | int], ) → RegisteredSystemEvents#

Starts recording of events on test system.

For Linux only.

All events that occurred before this call are not recorded. Wait for events using the RegisteredSystemEvents.wait() method on the result.

Examples

>>> from cuda.core import system
>>> events = system.register_events([
...     SystemEventType.SYSTEM_EVENT_TYPE_GPU_DRIVER_UNBIND,
... ])
>>> while event := events.wait(timeout_ms=10000):
...     print(f"Event {event.event_type} occurred.")

Parameters:: events (SystemEventType, int, or list of SystemEventType or int) – The event type or list of event types to register for this device.
Returns:: An object representing the registered events. Call RegisteredSystemEvents.wait() on this object to wait for events.
Return type:: RegisteredSystemEvents
Raises:: cuda.core.system.NotSupportedError – None of the requested event types are registered.