oneapi-src / oneapi-src/level-zero
Sub devices and Sysman API
Nobody has claimed this yet.
- Dominant language
- C++
- Stars
- 335
- Forks
- 140
- Avg merge
- 12h 32m
- Merged PRs (30d)
- 5
Description
Maybe just a clarification is needed. But I see this in the specification:
https://spec.oneapi.io/level-zero/latest/core/PROG.html#sub-device-support
** a sub-device can be partitioned into more sub-devices; e.g. down to a single slice.**
Let's say I wanted to enumerate all the sub-devices on a device, does this mean I need to recursively call zeDeviceGetSubDevices
until I get zero sub-devices or does the root device enumerate all possible sub-devices directly with a single call?
I ask because the Sysman API notes that
A Sysman device handle operates at the device level. If a sub-device device handle is passed to any of the Sysman functions, the result will be as if the device handle was used.
If there are sub-devices strictly under sub-devices, then what would a Sysman call with argument device.sub_device.sub_device refer to? device or device.sub_device?
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 linked Level Zero sub-device support specification and the Sysman API notes quoted in the issue. Determine whether sub-devices must be enumerated recursively and what a Sysman call receives for nested handles; done means the specification clearly defines both behaviors.
Written by the indexing model from the issue text.
Assessment
- Domain
- api, documentation
- Issue type
- Documentation
- Difficulty
- 5/5
- Estimated time
- Over a week
- Activity status
- Stale
- Clarity
- Needs clarification
- Newbie friendliness
- 25/100