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 SystemEvents.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 SsystemEventType or int) – The event type or list of event types to register for this device.
Returns:: An object representing the registered events. Call SystemEvents.wait() on this object to wait for events.
Return type:: SystemEvents
Raises:: cuda.core.system.NotSupportedError – None of the requested event types are registered.