Find the depth of cache objects matching cache level and type.
Return the depth of the topology level that contains cache objects whose attributes match cachelevel
and cachetype
.
This function is identical to calling hwloc_get_type_depth() with the corresponding type such as HWLOC_OBJ_L1ICACHE, except that it may also return a Unified cache when looking for an instruction cache.
- Returns
- the depth of the unique matching unified cache level is returned if
cachetype
is HWLOC_OBJ_CACHE_UNIFIED.
-
the depth of either a matching cache level or a unified cache level if
cachetype
is HWLOC_OBJ_CACHE_DATA or HWLOC_OBJ_CACHE_INSTRUCTION.
-
the depth of the matching level if
cachetype
is -1
but only one level matches.
-
HWLOC_TYPE_DEPTH_MULTIPLE if
cachetype
is -1
but multiple levels match.
-
HWLOC_TYPE_DEPTH_UNKNOWN if no cache level matches.