It also gathers various system attributes such as cache and memory information as well as the locality of I/O devices such as network interfaces, InfiniBand HCAs or GPUs.
hwloc primarily aims at helping applications with gathering information about increasingly complex parallel computing platforms so as to exploit them accordingly and efficiently. For instance, two tasks that tightly cooperate should probably be placed onto cores sharing a cache. However, two independent memory-intensive tasks should better be spread out onto different sockets so as to maximize their memory throughput.
hwloc may also help many applications just by providing a portable CPU and memory binding API and a reliable way to find out how many cores and/or hardware threads are available.
| Modifier and Type | Class and Description |
|---|---|
| public static class | HWLoc.
Contains the function pointers loaded from the HWLOC |
| Modifier and Type | Field and Description |
|---|---|
| private static final Pattern | |
| private static final SharedLibrary | |
| public static final long | HWLOC_ALLOW_FLAG_ALL
|
| public static final long | HWLOC_ALLOW_FLAG_CUSTOM
|
| public static final long | HWLOC_ALLOW_FLAG_LOCAL_RESTRICTIONS
|
| public static final int | |
| public static final int | |
| public static final int | HWLOC_CPUBIND_NOMEMBIND
|
| public static final int | HWLOC_CPUBIND_PROCESS
|
| public static final int | HWLOC_CPUBIND_STRICT
|
| public static final int | HWLOC_CPUBIND_THREAD
|
| public static final long | HWLOC_DISTANCES_ADD_FLAG_GROUP
|
| public static final long | HWLOC_DISTANCES_ADD_FLAG_GROUP_INACCURATE
|
| public static final long | HWLOC_DISTANCES_KIND_FROM_OS
|
| public static final long | HWLOC_DISTANCES_KIND_FROM_USER
|
| public static final long | HWLOC_DISTANCES_KIND_HETEROGENEOUS_TYPES
|
| public static final long | HWLOC_DISTANCES_KIND_MEANS_BANDWIDTH
|
| public static final long | HWLOC_DISTANCES_KIND_MEANS_LATENCY
|
| public static final int | HWLOC_DISTANCES_TRANSFORM_LINKS
|
| public static final int | HWLOC_DISTANCES_TRANSFORM_MERGE_SWITCH_PORTS
|
| public static final int | HWLOC_DISTANCES_TRANSFORM_REMOVE_NULL
|
| public static final int | HWLOC_DISTANCES_TRANSFORM_TRANSITIVE_CLOSURE
|
| public static final long | HWLOC_DISTRIB_FLAG_REVERSE
|
| public static final long | HWLOC_LOCAL_NUMANODE_FLAG_ALL
|
| public static final long | HWLOC_LOCAL_NUMANODE_FLAG_LARGER_LOCALITY
|
| public static final long | HWLOC_LOCAL_NUMANODE_FLAG_SMALLER_LOCALITY
|
| public static final int | HWLOC_LOCATION_TYPE_CPUSET
|
| public static final int | HWLOC_LOCATION_TYPE_OBJECT
|
| public static final long | HWLOC_MEMATTR_FLAG_HIGHER_FIRST
|
| public static final long | HWLOC_MEMATTR_FLAG_LOWER_FIRST
|
| public static final long | HWLOC_MEMATTR_FLAG_NEED_INITIATOR
|
| public static final int | |
| public static final int | |
| public static final int | |
| public static final int | |
| public static final int | |
| public static final int | |
| public static final int | |
| public static final int | |
| public static final int | HWLOC_MEMBIND_BIND
|
| public static final int | HWLOC_MEMBIND_BYNODESET
|
| public static final int | HWLOC_MEMBIND_DEFAULT
|
| public static final int | HWLOC_MEMBIND_FIRSTTOUCH
|
| public static final int | HWLOC_MEMBIND_INTERLEAVE
|
| public static final int | HWLOC_MEMBIND_MIGRATE
|
| public static final int | HWLOC_MEMBIND_MIXED
|
| public static final int | HWLOC_MEMBIND_NEXTTOUCH
|
| public static final int | HWLOC_MEMBIND_NOCPUBIND
|
| public static final int | HWLOC_MEMBIND_PROCESS
|
| public static final int | HWLOC_MEMBIND_STRICT
|
| public static final int | HWLOC_MEMBIND_THREAD
|
| public static final long | HWLOC_MODIFY_INFOS_OP_ADD
|
| public static final long | HWLOC_MODIFY_INFOS_OP_ADD_UNIQUE
|
| public static final long | HWLOC_MODIFY_INFOS_OP_REMOVE
|
| public static final long | HWLOC_MODIFY_INFOS_OP_REPLACE
|
| public static final int | HWLOC_OBJ_BRIDGE
|
| public static final int | |
| public static final int | |
| public static final int | HWLOC_OBJ_CACHE_DATA
|
| public static final int | HWLOC_OBJ_CACHE_INSTRUCTION
|
| public static final int | HWLOC_OBJ_CACHE_UNIFIED
|
| public static final int | HWLOC_OBJ_CORE
|
| public static final int | HWLOC_OBJ_DIE
|
| public static final int | HWLOC_OBJ_GROUP
|
| public static final int | HWLOC_OBJ_L1CACHE
|
| public static final int | HWLOC_OBJ_L1ICACHE
|
| public static final int | HWLOC_OBJ_L2CACHE
|
| public static final int | HWLOC_OBJ_L2ICACHE
|
| public static final int | HWLOC_OBJ_L3CACHE
|
| public static final int | HWLOC_OBJ_L3ICACHE
|
| public static final int | HWLOC_OBJ_L4CACHE
|
| public static final int | HWLOC_OBJ_L5CACHE
|
| public static final int | HWLOC_OBJ_MACHINE
|
| public static final int | HWLOC_OBJ_MEMCACHE
|
| public static final int | HWLOC_OBJ_MISC
|
| public static final int | HWLOC_OBJ_NUMANODE
|
| public static final int | HWLOC_OBJ_OS_DEVICE
|
| public static final long | HWLOC_OBJ_OSDEV_COPROC
|
| public static final long | HWLOC_OBJ_OSDEV_DMA
|
| public static final long | HWLOC_OBJ_OSDEV_GPU
|
| public static final long | HWLOC_OBJ_OSDEV_MEMORY
|
| public static final long | HWLOC_OBJ_OSDEV_NETWORK
|
| public static final long | HWLOC_OBJ_OSDEV_OPENFABRICS
|
| public static final long | HWLOC_OBJ_OSDEV_STORAGE
|
| public static final int | HWLOC_OBJ_PACKAGE
|
| public static final int | HWLOC_OBJ_PCI_DEVICE
|
| public static final int | |
| public static final long | |
| public static final long | |
| public static final long | |
| public static final long | |
| public static final long | |
| public static final long | |
| public static final int | HWLOC_OBJ_TYPE_MAX
|
| public static final int | HWLOC_OBJ_TYPE_MIN
|
| public static final long | HWLOC_RESTRICT_FLAG_ADAPT_IO
|
| public static final long | HWLOC_RESTRICT_FLAG_ADAPT_MISC
|
| public static final long | HWLOC_RESTRICT_FLAG_BYNODESET
|
| public static final long | HWLOC_RESTRICT_FLAG_REMOVE_CPULESS
|
| public static final long | HWLOC_RESTRICT_FLAG_REMOVE_MEMLESS
|
| public static final long | HWLOC_TOPOLOGY_COMPONENTS_FLAG_BLACKLIST
|
| public static final long | HWLOC_TOPOLOGY_DIFF_APPLY_REVERSE
|
| public static final int | HWLOC_TOPOLOGY_DIFF_OBJ_ATTR
|
| public static final int | HWLOC_TOPOLOGY_DIFF_OBJ_ATTR_INFO
|
| public static final int | HWLOC_TOPOLOGY_DIFF_OBJ_ATTR_NAME
|
| public static final int | HWLOC_TOPOLOGY_DIFF_OBJ_ATTR_SIZE
|
| public static final int | HWLOC_TOPOLOGY_DIFF_TOO_COMPLEX
|
| public static final long | HWLOC_TOPOLOGY_EXPORT_SYNTHETIC_FLAG_IGNORE_MEMORY
|
| public static final long | HWLOC_TOPOLOGY_EXPORT_SYNTHETIC_FLAG_NO_ATTRS
|
| public static final long | HWLOC_TOPOLOGY_EXPORT_SYNTHETIC_FLAG_NO_EXTENDED_TYPES
|
| public static final long | HWLOC_TOPOLOGY_EXPORT_SYNTHETIC_FLAG_V1
|
| public static final long | HWLOC_TOPOLOGY_EXPORT_XML_FLAG_V2
|
| public static final long | HWLOC_TOPOLOGY_FLAG_DONT_CHANGE_BINDING
|
| public static final long | HWLOC_TOPOLOGY_FLAG_IMPORT_SUPPORT
|
| public static final long | HWLOC_TOPOLOGY_FLAG_INCLUDE_DISALLOWED
|
| public static final long | HWLOC_TOPOLOGY_FLAG_IS_THISSYSTEM
|
| public static final long | HWLOC_TOPOLOGY_FLAG_NO_CPUKINDS
|
| public static final long | HWLOC_TOPOLOGY_FLAG_NO_DISTANCES
|
| public static final long | HWLOC_TOPOLOGY_FLAG_NO_MEMATTRS
|
| public static final long | HWLOC_TOPOLOGY_FLAG_RESTRICT_TO_CPUBINDING
|
| public static final long | HWLOC_TOPOLOGY_FLAG_RESTRICT_TO_MEMBINDING
|
| public static final long | HWLOC_TOPOLOGY_FLAG_THISSYSTEM_ALLOWED_RESOURCES
|
| public static final int | HWLOC_TYPE_DEPTH_BRIDGE
|
| public static final int | HWLOC_TYPE_DEPTH_MEMCACHE
|
| public static final int | HWLOC_TYPE_DEPTH_MISC
|
| public static final int | HWLOC_TYPE_DEPTH_MULTIPLE
|
| public static final int | HWLOC_TYPE_DEPTH_NUMANODE
|
| public static final int | HWLOC_TYPE_DEPTH_OS_DEVICE
|
| public static final int | HWLOC_TYPE_DEPTH_PCI_DEVICE
|
| public static final int | HWLOC_TYPE_DEPTH_UNKNOWN
|
| public static final int | HWLOC_TYPE_FILTER_KEEP_ALL
|
| public static final int | HWLOC_TYPE_FILTER_KEEP_IMPORTANT
|
| public static final int | HWLOC_TYPE_FILTER_KEEP_NONE
|
| public static final int | HWLOC_TYPE_FILTER_KEEP_STRUCTURE
|
| public static final int | |
| public static final int |
| Access | Constructor and Description |
|---|---|
| protected |
| Modifier and Type | Method and Description |
|---|---|
| public static SharedLibrary | |
| public static ByteBuffer | |
| public static ByteBuffer | |
| public static ByteBuffer | |
| public static int | |
| public static long | |
| public static long | |
| public static int | |
| public static int | |
| public static int | |
| public static int | |
| public static int | |
| public static int | |
| public static int | |
| public static int | |
| public static long | |
| public static void | |
| public static int | |
| public static int | |
| public static void | |
| public static int | |
| public static int | |
| public static int | |
| public static boolean | |
| public static boolean | |
| public static boolean | |
| public static boolean | |
| public static boolean | |
| public static boolean | |
| public static int | |
| public static int | |
| public static int | |
| public static int | |
| public static int | |
| public static int | |
| public static int | |
| public static int | |
| public static int | |
| public static int | |
| public static int | |
| public static int | |
| public static int | |
| public static int | |
| public static int | |
| public static int | |
| public static int | |
| public static int | |
| public static int | |
| public static int | |
| public static int | |
| public static int | |
| public static int | |
| public static int | |
| public static long | |
| public static long | |
| public static int | |
| public static int | |
| public static int | |
| public static void | |
| public static boolean | |
| public static int | |
| public static int | |
| public static int | hwloc_cpukinds_get_info(long topology, int kind_index, long cpuset, IntBuffer efficiency, PointerBuffer infosp, long flags)
|
| public static int | |
| public static int | hwloc_cpukinds_register(long topology, long cpuset, int forced_efficiency, hwloc_infos_s infos, long flags)
|
| public static int | |
| public static int | |
| public static int | |
| public static long | |
| public static long | |
| public static int | hwloc_distances_add_values(long topology, long handle, int nbobjs, PointerBuffer objs, LongBuffer values, long flags)
|
| public static int | |
| public static int | hwloc_distances_get_by_depth(long topology, int depth, IntBuffer nr, PointerBuffer distances, long kind, long flags)
|
| public static int | hwloc_distances_get_by_name(long topology, ByteBuffer name, IntBuffer nr, PointerBuffer distances, long flags)
|
| public static int | hwloc_distances_get_by_name(long topology, CharSequence name, IntBuffer nr, PointerBuffer distances, long flags)
|
| public static int | hwloc_distances_get_by_type(long topology, int type, IntBuffer nr, PointerBuffer distances, long kind, long flags)
|
| public static String | |
| public static int | |
| public static int | hwloc_distances_obj_pair_values(hwloc_distances_s distances, hwloc_obj obj1, hwloc_obj obj2, LongBuffer value1to2, LongBuffer value2to1)
|
| public static void | |
| public static int | |
| public static int | |
| public static int | |
| public static int | |
| public static int | hwloc_distances_transform(long topology, hwloc_distances_s distances, int transform, long transform_attr, long flags)
|
| public static int | hwloc_distrib(long topology, PointerBuffer roots, int n_roots, PointerBuffer set, int n, int until, long flags)
|
| public static int | hwloc_export_obj_userdata(long reserved, long topology, hwloc_obj obj, ByteBuffer name, ByteBuffer buffer)
|
| public static int | hwloc_export_obj_userdata(long reserved, long topology, hwloc_obj obj, CharSequence name, ByteBuffer buffer)
|
| public static int | hwloc_export_obj_userdata_base64(long reserved, long topology, hwloc_obj obj, ByteBuffer name, ByteBuffer buffer)
|
| public static int | hwloc_export_obj_userdata_base64(long reserved, long topology, hwloc_obj obj, CharSequence name, ByteBuffer buffer)
|
| public static int | |
| public static void | |
| public static hwloc_obj | |
| public static hwloc_obj | |
| public static int | |
| public static int | |
| public static int | |
| public static hwloc_obj | |
| public static int | |
| public static hwloc_obj | |
| public static int | |
| public static hwloc_obj | |
| public static int | |
| public static int | |
| public static hwloc_obj | |
| public static String | |
| public static int | |
| public static int | |
| public static int | hwloc_get_local_numanode_objs(long topology, hwloc_location location, IntBuffer nr, PointerBuffer nodes, long flags)
|
| public static int | |
| public static int | |
| public static int | |
| public static int | |
| public static int | |
| public static int | |
| public static hwloc_obj | |
| public static hwloc_obj | |
| public static hwloc_obj | |
| public static hwloc_obj | |
| public static hwloc_obj | |
| public static hwloc_obj | |
| public static hwloc_obj | |
| public static hwloc_obj | |
| public static hwloc_obj | |
| public static hwloc_obj | |
| public static hwloc_obj | |
| public static hwloc_obj | |
| public static hwloc_obj | |
| public static hwloc_obj | |
| public static hwloc_obj | |
| public static hwloc_obj | |
| public static hwloc_obj | |
| public static int | |
| public static hwloc_obj | |
| public static hwloc_obj | |
| public static hwloc_obj | hwloc_get_obj_with_same_locality(long topology, hwloc_obj src, int type, ByteBuffer subtype, ByteBuffer nameprefix, long flags)
|
| public static hwloc_obj | hwloc_get_obj_with_same_locality(long topology, hwloc_obj src, int type, CharSequence subtype, CharSequence nameprefix, long flags)
|
| public static hwloc_obj | |
| public static hwloc_obj | |
| public static int | |
| public static int | |
| public static int | |
| public static int | |
| public static int | |
| public static int | |
| public static hwloc_obj | |
| public static hwloc_obj | |
| public static hwloc_obj | |
| public static int | |
| public static int | |
| public static int | |
| public static int | |
| public static int | |
| public static int | |
| public static int | hwloc_memattr_get_best_initiator(long topology, int attribute, hwloc_obj target, long flags, hwloc_location.
|
| public static int | hwloc_memattr_get_best_target(long topology, int attribute, hwloc_location initiator, long flags, PointerBuffer best_target, LongBuffer value)
|
| public static int | |
| public static int | |
| public static int | |
| public static int | hwloc_memattr_get_initiators(long topology, int attribute, hwloc_obj target_node, long flags, IntBuffer nr, hwloc_location.
|
| public static int | |
| public static int | hwloc_memattr_get_targets(long topology, int attribute, hwloc_location initiator, long flags, IntBuffer nr, PointerBuffer targets, LongBuffer values)
|
| public static int | hwloc_memattr_get_value(long topology, int attribute, hwloc_obj target_node, hwloc_location initiator, long flags, LongBuffer value)
|
| public static int | |
| public static int | |
| public static int | hwloc_memattr_set_value(long topology, int attribute, hwloc_obj target_node, hwloc_location initiator, long flags, long value)
|
| public static int | |
| public static int | |
| public static int | |
| public static int | |
| public static int | |
| public static int | |
| public static int | |
| public static String | |
| public static boolean | |
| public static boolean | |
| public static boolean | |
| public static boolean | |
| public static boolean | |
| public static boolean | |
| public static boolean | |
| public static int | |
| public static String | |
| public static int | |
| public static int | |
| public static int | |
| public static int | |
| public static int | |
| public static int | |
| public static int | |
| public static int | |
| public static int | |
| public static int | |
| public static hwloc_obj | |
| public static int | |
| public static void | |
| public static void | |
| public static int | |
| public static int | |
| public static int | |
| public static int | |
| public static int | |
| public static int | hwloc_topology_diff_export_xmlbuffer(long diff, ByteBuffer refname, PointerBuffer xmlbuffer, IntBuffer buflen)
|
| public static int | hwloc_topology_diff_export_xmlbuffer(long diff, CharSequence refname, PointerBuffer xmlbuffer, IntBuffer buflen)
|
| public static int | |
| public static int | |
| public static int | |
| public static int | |
| public static int | |
| public static int | |
| public static int | |
| public static int | hwloc_topology_export_xmlbuffer(long topology, PointerBuffer xmlbuffer, IntBuffer buflen, long flags)
|
| public static long | |
| public static long | |
| public static long | |
| public static long | |
| public static int | |
| public static long | |
| public static hwloc_infos_s | |
| public static hwloc_topology_support | |
| public static long | |
| public static long | |
| public static int | |
| public static long | |
| public static int | |
| public static hwloc_obj | |
| public static hwloc_obj | |
| public static hwloc_obj | |
| public static boolean | |
| public static int | |
| public static int | |
| public static int | |
| public static int | |
| public static int | |
| public static int | |
| public static int | |
| public static int | |
| public static int | |
| public static int | |
| public static int | |
| public static int | |
| public static int | |
| public static int | |
| public static int | |
| public static void | |
| public static void | hwloc_topology_set_userdata_export_callback(long topology, topology_set_userdata_export_callbackI export_cb)
|
| public static void | hwloc_topology_set_userdata_import_callback(long topology, topology_set_userdata_import_callbackI import_cb)
|
| public static int | |
| public static int | |
| public static int | |
| public static int | |
| public static int | |
| public static int | |
| public static long | |
| public static long | |
| public static int | |
| public static int | |
| public static int | |
| public static int | |
| public static int | |
| public static int | |
| public static int | |
| public static int | |
| public static int | |
| public static int | |
| public static int | |
| public static int | nhwloc_cpukinds_get_info(long topology, int kind_index, long cpuset, long efficiency, long infosp, long flags)
|
| public static int | |
| public static long | |
| public static int | nhwloc_distances_add_values(long topology, long handle, int nbobjs, long objs, long values, long flags)
|
| public static int | |
| public static int | nhwloc_distances_get_by_depth(long topology, int depth, long nr, long distances, long kind, long flags)
|
| public static int | |
| public static int | nhwloc_distances_get_by_type(long topology, int type, long nr, long distances, long kind, long flags)
|
| public static long | |
| public static void | |
| public static int | |
| public static int | nhwloc_distances_transform(long topology, long distances, int transform, long transform_attr, long flags)
|
| public static int | nhwloc_export_obj_userdata(long reserved, long topology, long obj, long name, long buffer, long length)
|
| public static int | nhwloc_export_obj_userdata_base64(long reserved, long topology, long obj, long name, long buffer, long length)
|
| public static int | |
| public static void | |
| public static int | |
| public static int | |
| public static int | |
| public static int | |
| public static int | |
| public static int | |
| public static long | |
| public static long | nhwloc_get_obj_with_same_locality(long topology, long src, int type, long subtype, long nameprefix, long flags)
|
| public static int | |
| public static int | |
| public static int | |
| public static int | nhwloc_memattr_get_best_initiator(long topology, int attribute, long target, long flags, long best_initiator, long value)
|
| public static int | nhwloc_memattr_get_best_target(long topology, int attribute, long initiator, long flags, long best_target, long value)
|
| public static int | |
| public static int | |
| public static int | nhwloc_memattr_get_initiators(long topology, int attribute, long target_node, long flags, long nr, long initiators, long values)
|
| public static int | |
| public static int | nhwloc_memattr_get_targets(long topology, int attribute, long initiator, long flags, long nr, long targets, long values)
|
| public static int | nhwloc_memattr_get_value(long topology, int attribute, long target_node, long initiator, long flags, long value)
|
| public static int | |
| public static int | nhwloc_memattr_set_value(long topology, int attribute, long target_node, long initiator, long flags, long value)
|
| public static int | |
| public static int | |
| public static int | |
| public static int | |
| public static long | |
| public static int | |
| public static long | |
| public static int | |
| public static int | |
| public static int | |
| public static int | |
| public static int | |
| public static int | |
| public static int | |
| public static int | |
| public static int | |
| public static long | |
| public static long | |
| public static int | |
| public static int | |
| public static long | |
| public static long | |
| public static int | |
| public static int | |
| public static void | |
| public static void | |
| public static int | |
| public static int | |
| public static int |