oneapi-src / oneapi-src/level-zero
Fix the "Initialization" in the Sysman Programming Guide
Nobody has claimed this yet.
- Dominant language
- C++
- Stars
- 335
- Forks
- 140
- Avg merge
- 12h 32m
- Merged PRs (30d)
- 5
Description
From https://spec.oneapi.io/level-zero/latest/sysman/PROG.html
"For compatibility, an application may also use the Level0 Core API to enumerate through available accelerator devices in the system. For each device handle, an application can cast it to a sysman device handle to manage the system resources of the device."
This cast is invalid when using ZesInit() as discussed in https://github.com/intel/compute-runtime/issues/686, it's only valid when using zeInit() + the env var to enable Sysman. I asked for the fix there last year but the issue was closed without the spec fix.
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Research direction
Start with the Initialization section of the Sysman Programming Guide at spec.oneapi.io/level-zero/latest/sysman/PROG.html, then read compute-runtime issue 686 for the compatibility details. Update the quoted statement so it matches the documented ZesInit() behavior, and verify the rendered guide no longer claims that the cast is valid in that case.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- cpp
- Domain
- documentation
- Issue type
- Documentation
- Difficulty
- 1/5
- Estimated time
- Under an hour
- Activity status
- Stale
- Clarity
- Mostly clear
- Newbie friendliness
- 45/100