From cb3a260c27f4c3235061b12b3d9eef80d4ba83d9 Mon Sep 17 00:00:00 2001 From: Brice Goglin Date: Wed, 4 Dec 2024 11:11:17 +0100 Subject: [PATCH] levelzero.h: we always return the root/parent device, not a subdevice Refs #698 Signed-off-by: Brice Goglin --- include/hwloc/levelzero.h | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/include/hwloc/levelzero.h b/include/hwloc/levelzero.h index 2c972fe06..c1b438456 100644 --- a/include/hwloc/levelzero.h +++ b/include/hwloc/levelzero.h @@ -166,6 +166,10 @@ hwloc_levelzero_get_sysman_device_cpuset(hwloc_topology_t topology __hwloc_attri * topology. If not, the locality of the object may still be found using * hwloc_levelzero_get_device_cpuset(). * + * \note If the input ZE device is actually a subdevice, then its parent + * (root device) is actually translated, i.e. the main hwloc OS device + * is returned instead of one of its children. + * * \note The corresponding hwloc PCI device may be found by looking * at the result parent pointer (unless PCI devices are filtered out). * @@ -231,6 +235,10 @@ hwloc_levelzero_get_device_osdev(hwloc_topology_t topology, ze_device_handle_t d * topology. If not, the locality of the object may still be found using * hwloc_levelzero_get_device_cpuset(). * + * \note If the input ZES device is actually a subdevice, then its parent + * (root device) is actually translated, i.e. the main hwloc OS device + * is returned instead of one of its children. + * * \note The corresponding hwloc PCI device may be found by looking * at the result parent pointer (unless PCI devices are filtered out). */