oneapi-src / oneapi-src/level-zero
zesDriverEventListen[Ex] timeout return code
Dieses Issue hat noch niemand übernommen.
- Vorherrschende Sprache
- C++
- Sterne
- 335
- Forks
- 140
- Ø Merge
- 12 Std. 32 Min.
- Gemergte PRs (30 T.)
- 5
Beschreibung
I suggest adding an explicit timeout return code for zesDriverEventListen[Ex] calls. Right now, the user has to infer a timeout occurred when ze_result_t == ZE_SUCCESS and pNumDeviceEvents = 0. The specification isn't 100% clear that a timeout will result in the pNumDeviceEvents being cleared. An explicit error code leaves no doubt. The spec is also ambitious in stating that the timeout will only occur once the time expires. It seems like an -EINTR or similar type error could cause a timeout to occur before the time expires. Perhaps the spec should allow for a timeout to occur before the time expires?
https://spec.oneapi.com/level-zero/latest/sysman/api.html#zesdrivereventlistenex
Beitragsleitfaden
Erste Schritte
- Lies das ganze Issue und danach den Beitragsleitfaden des Projekts.
- Schreib ins Issue, dass du es übernimmst — das erspart doppelte Arbeit.
- Forke das Repository und arbeite in einem Branch.
- Öffne einen Pull Request, der die Issue-Nummer nennt.
Rechercherichtung
Beginnen Sie mit dem im Issue verlinkten Abschnitt der zesDriverEventListen[Ex]-Spezifikation und überprüfen Sie die aktuelle Formulierung zu Timeout und Rückgabecode. Ermitteln Sie, ob ein explizites Timeout-Ergebnis und das Verhalten vor Ablauf der angeforderten Zeit vorgesehen sind, und dokumentieren Sie die vereinbarten API-Semantiken; abgeschlossen ist dies, wenn die Spezifikation eindeutig ist und die Änderung die Zustimmung der Maintainer erhalten hat.
Vom Indexierungsmodell aus dem Issue-Text verfasst.
Bewertung
- Tech-Stack
- cpp
- Bereich
- api
- Issue-Typ
- Feature
- Schwierigkeit
- 5/5
- Geschätzter Aufwand
- Über eine Woche
- Aktivitätsstatus
- Veraltet
- Klarheit
- Größtenteils klar
- Anfängerfreundlichkeit
- 30/100