Debian Codegraph @

NEWS

raw
1 SPDX-License-Identifier: BSD-3-Clause
2 Copyright © 2009 CNRS
3 Copyright © 2009-2026 Inria. All rights reserved.
4 Copyright © 2009-2013 Université Bordeaux
5 Copyright © 2009-2011 Cisco Systems, Inc. All rights reserved.
6 Copyright © 2020 Hewlett Packard Enterprise. All rights reserved.
7 See COPYING in top-level directory.
8
9 ===========================================================================
10
11 This file contains the main features as well as overviews of specific
12 bug fixes (and other actions) for each version of hwloc since version
13 0.9.
14
15
16 Version 2.14.0
17 --------------
18 * Disable the GL component (for graphics OS devices) since it hangs
19 on some platforms.
20 - Set HWLOC_GL=1 in the environment to reenable it.
21 * Use ARM MIDR to identify different kinds of CPU core on Linux,
22 instead of the frequency/capacity-based heuristics.
23 Remove NVIDIA-specific forcing of homogeneous cores when their
24 frequency varies slightly.
25 Thanks to Michael Kuron for the help.
26 * Use AMD SMI when available, instead of ROCm SMI, in the RSMI backend.
27 --disable-rsmi-amd or HWLOC_RSMI_BACKEND=rocm may be used to switch
28 back to ROCm.
29 - Add hwloc/amdsmi.h for interoperability.
30 - Properly implement the XGMIHops distance matrix when using AMD SMI.
31 Thanks to Edgar Leon for the help.
32 * Add CXI OS devices for Cray Slingshot NICs, e.g. cxi0,
33 thanks to Edgar Leon for the suggestion.
34 * Add --with-opencl=<dir> configure option.
35 * hwloc-info topology now reports the number of levels, PUs,
36 NUMA nodes and CPU kinds.
37 * Prevent some possible crashs in the levelzero backend due to
38 uninitialized structures.
39 * Many small fixes by Javid Khan, thanks.
40
41
42 Version 2.13
43 ------------
44 * CPU kind improvements
45 + Put Intel LP E-cores in the IntelLowPower cpukind in the x86 backend,
46 thanks to Dmitri N Mokhov for the patch.
47 + Adjust sysfs capacity on Intel CPUs on Linux 6.16+ together with
48 max frequencies when they differ because of Turbo Boost Max 3.0.
49 + Disable Linux cpukinds on AMD before Zen5 since these CPUs are
50 homogeneous and it may cause slowness on some platforms.
51 The new env var HWLOC_LINUX_CPUKINDS=1 may be used to reenable it.
52 Thanks to Benedikt Steinbusch and Jan André Reuter for the report.
53 * Fix CUDACoresPerMP on NVIDIA GPUs with compute capability 7.x.
54 * Tools
55 + Send the lstopo ASCII output to a pager (less by default).
56 + hwloc-patch now has a --dry-run option.
57 * Plugins are now supported for OpenCL, CUDA and XML components
58 on Windows using the HWLOC_ENABLE_PLUGINS CMake option,
59 thanks to Julian Hornich.
60 + HWLOC_BUILD_SHARED_LIBS is removed in favor of BUILD_SHARED_LIBS.
61 * FAQ
62 + "How do I find the local MCDRAM NUMA node on Intel Xeon Phi
63 processor?" is replaced with "How do I find the local HBM NUMA node
64 on heterogeneous memory systems?"
65 + Add "How do I convert between logical and OS/physical indexes?"
66 and further clarify that cpusets and nodesets contain physical indexes.
67 * Removals
68 + Drop support for Windows before 7 or Server 2008 R2.
69 + Remove the HWLOC_PCI_<domain>_<bus>_LOCALCPUS environment variables,
70 superseded with a single HWLOC_PCI_LOCALITY since 2.0.
71
72
73 Version 2.12.2
74 --------------
75 * Fix hwloc-gather-topology failure because of MemoryModules when
76 running as root. Thanks to Andrew Phelps for the report.
77 * Fix HWLOC_LOCAL_NUMANODE_FLAG_INTERSECT_LOCALITY for empty input
78 cpuset, thanks to Hadrien Grasland.
79 * Fix hwloc_distances_get_by_name() for distances with no kinds.
80 Thanks to Hadrien Grasland.
81 * Initialize distances grouping configuration for duplicated topology.
82 Thanks to Hadrien Grasland.
83 * Improve Windows CMake build to support ARM64, thanks to Chiwen Hui.
84
85
86 Version 2.12.1
87 --------------
88 * Add hwloc-calc's --default-nodes option to hwloc-bind and hwloc-info.
89 * Improve the --best-memattr "default" fallback, try to use "default"
90 memory nodes, and add verbose messages and warnings if some
91 performance info are incomplete or missing.
92 Thanks to Antoine Morvan for the report.
93 * Fix CPU and memory binding on different locations,
94 thanks to Antoine Morvan for the report.
95 * Add HWLOC_LOCAL_NUMANODE_FLAG_INTERSECT_LOCALITY and enable it by
96 default in hwloc-calc --local-memory for finding local NUMA nodes
97 that do not exactly match input locations.
98 Thanks to Antoine Morvan for the report.
99 * Fix a possible crash in the x86 backend when Qemu is configured to
100 expose multicore/thread CPUs that are actually single-core/thread.
101 Thanks to Georg Pfuetzenreuter.
102
103
104 Version 2.12.0
105 --------------
106 * Add hwloc_topology_get_default_nodeset() for the set of default
107 NUMA nodes.
108 - hwloc-calc now has --default-nodes option.
109 * Rework oneAPI LevelZero support to use zesInit() and avoid the need
110 to set ZES_ENABLE_SYSMAN=1 in the environment.
111 - zesDriverGetDeviceByUuidExp() is now required in the L0 runtime.
112 - ZES/Sysman variants were added in hwloc/levelzero.h to specifically
113 handle ZES/Sysman device handles.
114 * Fix the locality of AMD GPU partitions, thanks to Edgar Leon for
115 reporting and debugging the issue.
116 * Better detect Cray Slingshot NICs, thanks to Edgar Leon.
117 * Add support for Die objects and Module groups on Windows.
118 * Only filter-out Dies that are identical to their Packages
119 when it applies to all Dies.
120 * Improve hwloc-calc to handle CPU-less NUMA nodes or platforms with
121 heterogeneous memory without requiring --nodeset-output.
122 * hwloc-calc now accepts counting/listing cpukinds and memory tiers
123 with -N and -I cpukind/memorytier.
124 * The systemd-dbus-api output of hwloc-calc has changed, and
125 --nodeset-output-format was added, to support NUMA node outputs.
126 Thanks to Pierre Neyron.
127 * Update NVLink bandwidth and CUDA capabilities up to NVIDIA Blackwell.
128 * Fix some NUMA syscalls on Linux for platforms with old libc headers.
129 * Some minor fixes in distances.
130
131
132 Version 2.11.2
133 --------------
134 * Add missing CPU info attrs on aarch64 on Linux.
135 * Use ACPI CPPC on Linux to get better information about cpukinds,
136 at least on AMD CPUs.
137 * Fix crash when manipulating cpukinds after topology
138 duplication, thanks to Hadrien Grasland for the report.
139 * Fix missing input target checks in memattr functions,
140 thanks to Hadrien Grasland for the report.
141 * Fix a memory leak when ignoring NUMA distances on FreeBSD.
142 * Fix build failure on old Linux distributions without accessat().
143 * Fix non-Windows importing of XML topologies and CPUID dumps exported
144 on Windows.
145 * hwloc-calc --cpuset-output-format systemd-dbus-api now allows
146 to generate AllowedCPUs information for systemd slices.
147 See the hwloc-calc manpage for examples. Thanks to Pierre Neyron.
148 * Some fixes in manpage EXAMPLES and split them into subsections.
149
150
151 Version 2.11.1
152 --------------
153 * Fix bash completions, thanks Tavis Rudd.
154
155
156 Version 2.11.0
157 --------------
158 * API
159 + Add HWLOC_MEMBIND_WEIGHTED_INTERLEAVE memory binding policy on
160 Linux 6.9+. Thanks to Honggyu Kim for the patch.
161 - weighted_interleave_membind is added to membind support bits.
162 - The "weighted" policy is added to the hwloc-bind tool.
163 + Add hwloc_obj_set_subtype(). Thanks to Hadrien Grasland for the report.
164 * GPU support
165 + Don't hide the GPU NUMA node on NVIDIA Grace Hopper.
166 + Get Intel GPU OpenCL device locality.
167 + Add bandwidths between subdevices in the LevelZero XeLinkBandwidth
168 matrix.
169 + Fix PCI Gen4+ link speed of NVIDIA GPU obtained from NVML,
170 thanks to Akram Sbaih for the report.
171 * Windows support
172 + Fix Windows support when UNICODE is enabled, several hwloc features
173 were missing, thanks to Martin for the report.
174 + Fix the enabling of CUDA in Windows CMake build,
175 Thanks to Moritz Kreutzer for the patch.
176 + Fix CUDA/OpenCL test source path in Windows CMake.
177 * Tools
178 + Option --best-memattr may now return multiple nodes. Additional
179 configuration flags may be given to tweak its behavior.
180 + hwloc-info has a new --get-attr option to get a single attribute.
181 + hwloc-info now supports "levels", "support" and "topology"
182 special keywords for backward compatibility for hwloc 3.0.
183 + The --taskset command-line option is superseded by the new
184 --cpuset-output-format which also allows to export as list.
185 + hwloc-calc may now import bitmasks described as a list of bits
186 with the new "--cpuset-input-format list".
187 * Misc
188 + The MemoryTiersNr info attribute in the root object now says how many
189 memory tiers were built. Thanks to Antoine Morvan for the report.
190 + Fix the management of infinite cpusets in the bitmap printf/sscanf
191 API as well as in command-line tools.
192 + Add section "Compiling software on top of hwloc's C API" in the
193 documentation with examples for GNU Make and CMake,
194 thanks to Florent Pruvost for the help.
195
196
197 Version 2.10.0
198 --------------
199 * Heterogeneous Memory core improvements
200 + Better heuristics to identify the subtype of memory such as HBM,
201 DRAM, NVM, CXL-DRAM, etc.
202 + Build memory tiers, i.e. sets of NUMA nodes with the same subtype
203 and similar performance.
204 - NUMA node tier ranks are exposed in the new MemoryTier info
205 attribute (starts from 0 for highest bandwidth tier)..
206 + See the new Heterogeneous Memory section in the documentation.
207 * API
208 + Add hwloc_topology_free_group_object() to discard a Group created
209 by hwloc_topology_alloc_group_object().
210 * Linux backend
211 + Fix cpukinds on NVIDIA Grace to report identical cores even if they
212 actually have very small frequency differences.
213 Thanks to John C. Linford for the report.
214 + Add CXLDevice attributes to CXL DAX objects and NUMA nodes to show
215 which PCI device implements which window.
216 + Ignore buggy memory-side caches and memory attributes when fake NUMA
217 emulation is enabled on the Linux kernel command-line.
218 + Add more info attributes in MemoryModule Misc objects,
219 thanks to Zubiao Xiong for the patch.
220 + Get CPUModel and CPUFamily info attributes on LoongArch platforms.
221 * x86 backend
222 + Add support for new AMD CPUID leaf 0x80000026 for better detection
223 of Core Complex and Die on Zen4 processors.
224 + Improve Zhaoxin CPU topology detection.
225 * Tools
226 + Input locations and many command-line options (e.g. hwloc-calc -I -N -H,
227 lstopo --only) now accept filters such as "NUMA[HBM]" so that only
228 objects are that type and subtype are considered.
229 - NUMA[tier=1] is also accepted for selecting NUMA nodes depending
230 on their MemoryTier info attribute.
231 + Add --object-output to hwloc-calc to report the type as a prefix to
232 object indexes, e.g. Core:2 instead of 2 in the output of -I.
233 + hwloc-info --ancestor and --descendants now accepts kinds of objects
234 instead of single types.
235 - The new --first option only shows the first matching object.
236 + Add --children-of-pid to hwloc-ps to show a hierarchy of processes.
237 Thanks to Antoine Morvan for the suggestion.
238 + Add --misc-from to lstopo to add Misc objects described in a file.
239 - To be combined with the new hwloc-ps --lstopo-misc for a customizable
240 lstopo --top replacement.
241 * Misc
242 + lstopo may now configure the layout of memory object placed above,
243 for instance with --children-order memory:above:vert.
244 + Fix XML import from memory or stdin when using libxml2 2.12.
245 + Fix installation failures when configuring with --target,
246 thanks to Clement Foyer for the patch.
247 + Fix support for 128bit pointer architectures.
248 + Remove Netloc.
249
250
251 Version 2.9.3
252 -------------
253 * Handle Linux glibc allocation errors in binding routines (CVE-2022-47022).
254 * Fix hwloc-calc when searching objects on heterogeneous memory platforms,
255 thanks to Antoine Morvan for the report.
256 * Fix hwloc_get_next_child() when there are some memory-side caches.
257 * Don't crash if the topology is empty because Linux cgroups are wrong.
258 * Improve some hwloc-bind warnings in case of command-line parsing errors.
259 * Many documentation improvements all over the place, including:
260 + hwloc_topology_restrict() and hwloc_topology_insert_group() may reorder
261 children, causing the logical indexes of objects to change.
262
263
264 Version 2.9.2
265 -------------
266 * Don't forget L3i when defining filters for multiple levels of caches
267 with hwloc_topology_set_cache/icache_types_filter().
268 * Fix object total_memory after hwloc_topology_insert_group_object().
269 * Fix the (non-yet) exporting in synthetic description for complex memory
270 hierarchies with memory-side caches, etc.
271 * Fix some default size attributes when building synthetic topologies.
272 * Fix size units in hwloc-annotate.
273 * Improve bitmap reallocation error management in many functions.
274 * Documentation improvements:
275 + Better document return values of functions.
276 + Add "Error reporting" section (in hwloc.h and in the doxygen doc).
277 + Add FAQ entry "What may I disable to make hwloc faster?"
278 + Improve FAQ entries "Why is lstopo slow?" and
279 "I only need ..., why should I use hwloc?"
280 + Clarify how to deal with cpukinds in hwloc-calc and hwloc-bind
281 manpages.
282
283
284 Version 2.9.1
285 -------------
286 * Don't forget to apply object type filters to "perflevel" caches detected
287 on recent Mac OS X releases, thanks to Michel Lesoinne for the report.
288 * Fix a failed assertion in hwloc_topology_restrict() when some NUMA nodes
289 are removed because of HWLOC_RESTRICT_FLAG_REMOVE_CPULESS but no PUs are.
290 Thanks to Mark Grondona for reporting the issue.
291 * Mark HPE Cray Slingshot NICs with subtype "Slingshot".
292
293
294 Version 2.9.0
295 -------------
296 * Backends
297 + Expose the memory size of CXL memory devices (Type 3) on Linux.
298 + The LevelZero backend now reports the "XeLinkBandwidth" distance
299 matrix between L0 devices (and subdevices) when available.
300 + Add support for CUDA compute capability up to 9.0.
301 * Tools
302 + lstopo now switches to console mode when its output is redirected.
303 Graphical window mode may be forced back with --of window.
304 + hwloc-calc now accepts "numa" in -H, and I/O subtypes such as "gpu"
305 in -I and -N.
306
307
308 Version 2.8.0
309 -------------
310 * API
311 + Add HWLOC_TOPOLOGY_FLAG_NO_DISTANCES, _NO_MEMATTRS and _NO_CPUKINDS
312 to reduce the overhead when unneeded.
313 + Add separate Read/Write Bandwidth/Latency memory attributes and
314 implement them on Linux.
315 * Backends
316 + NUMA nodes may now have a subtype such as DRAM, HBM, SPM, or NVM
317 on heterogeneous memory platforms on Linux.
318 - Add DAXType and DAXParent attributes on Linux to tell where a
319 DAX device or its corresponding NUMA node come from (SPM for
320 Specific-Purpose or NVM for Non-Volatile Memory).
321 + Detect heterogeneous caches in hybrid CPUs on MacOS X,
322 thanks to Paul Bone for the help.
323 + Max frequencies are not ignored in Linux cpukinds anymore (they were
324 ignored in hwloc 2.7.0), but they may be slightly adjusted to avoid
325 reporting hybrid CPUs because Intel Turbo Boost Max 3.0.
326 - See the documentation of environment variable HWLOC_CPUKINDS_MAXFREQ.
327 + Hardwire the PCI locality of HPE Cray EX235a nodes.
328 * Tools
329 + lstopo and other tools may now load Linux and x86 cpuid topology files
330 from a tarball.
331 + lstopo may now replace the P# and L# index prefixes with custom strings
332 thanks to --os-index-prefix and --logical-index-prefix options.
333 * Misc
334 + Add --disable-readme to avoid regenerating the top-level hwloc README
335 file from the documentation.
336
337
338 Version 2.7.2
339 -------------
340 * Fix a crash when LevelZero devices have multiple subdevices,
341 e.g. on PonteVecchio GPUs, thanks to Jonathan Peyton.
342 * Fix a leak when importing cpukinds from XML,
343 thanks to Hui Zhou.
344
345
346 Version 2.7.1
347 -------------
348 * Workaround crashes when virtual machines report incoherent x86 CPUID
349 information about numbers of cores and threads.
350 Thanks to Peter Bense for the report.
351 * Use setenv() instead of putenv() when trying to force enable oneAPI L0
352 support, to avoid issues with applications that touch the environment,
353 thanks to Josh Hursey for the patch.
354 * Add some warnings at the end of configure when GPU libraries are
355 missing on the system or their path is missing in the environment.
356
357
358 Version 2.7.0
359 -------------
360 * Backends
361 + Add support for NUMA nodes and caches with more than 64 PUs across
362 multiple processor groups on Windows 11 and Windows Server 2022.
363 + Group objects are not created for Windows processor groups anymore,
364 except if HWLOC_WINDOWS_PROCESSOR_GROUP_OBJS=1 in the environment.
365 + Expose "Cluster" group objects on Linux kernel 5.16+ for CPUs
366 that share some internal cache or bus. This can be equivalent
367 to the L2 Cache level on some platforms (e.g. x86) or a specific
368 level between L2 and L3 on others (e.g. ARM Kungpeng 920).
369 Thanks to Jonathan Cameron for the help.
370 - HWLOC_DONT_MERGE_CLUSTER_GROUPS=1 may be set in the environment
371 to prevent these groups from being merged with identical caches, etc.
372 + Improve the oneAPI LevelZero backend:
373 - Expose subdevices such as "ze0.1" inside root OS devices ("ze0")
374 when the hardware contains multiple subdevices.
375 - Add many new attributes to describe device type, and the
376 numbers of slices, subslices, execution units and threads.
377 - Expose the memory information as LevelZeroHBM/DDR/MemorySize infos.
378 + Ignore the max frequencies of cores in Linux cpukinds when the
379 base frequencies are available (to avoid exposing hybrid CPUs
380 when Intel Turbo Boost Max 3.0 gives slightly different max
381 frequencies to CPU cores).
382 - May be reverted by setting HWLOC_CPUKINDS_MAXFREQ=1 in the environment.
383 * Tools
384 + Add --grey and --palette options to switch lstopo to greyscale or
385 white-background-only graphics, or to tune individual colors.
386 * Build
387 + Windows CMake builds now support non-MSVC compilers, detect several
388 features at build time, can build/run tests, etc.
389 Thanks to Michael Hirsch and Alexander Neumann .
390
391
392 Version 2.6.0
393 -------------
394 * Backends
395 + Expose two cpukinds for energy-efficient cores (icestorm) and
396 high-performance cores (firestorm) on Apple M1 on Mac OS X.
397 + Use sysfs CPU "capacity" to rank hybrid cores by efficiency
398 on Linux when available (mostly on recent ARM platforms for now).
399 + Improve HWLOC_MEMBIND_BIND (without the STRICT flag) on Linux kernel
400 >= 5.15: If more than one node is given, the kernel may now use all
401 of them instead of only the first one before falling back to others.
402 + Expose cache os_index when available on Linux, it may be needed
403 when using resctrl to configure cache partitioning, memory bandwidth
404 monitoring, etc.
405 + Add a "XGMIHops" distances matrix in the RSMI backend for AMD GPU
406 interconnected through XGMI links.
407 + Expose AMD GPU memory information (VRAM and GTT) in the RSMI backend.
408 + Add OS devices such as "bxi0" for Atos/Bull BXI HCAs on Linux.
409 * Tools
410 + lstopo has a better placement algorithm with respect to I/O
411 objects, see --children-order in the manpage for details.
412 + hwloc-annotate may now change object subtypes and cache or memory
413 sizes.
414 * Build
415 + Allow to specify the ROCm installation for building the RSMI backend:
416 - Use a custom installation path if specified with --with-rocm=<dir>.
417 - Use /opt/rocm-<version> if specified with --with-rocm-version=<version>
418 or the ROCM_VERSION environment variable.
419 - Try /opt/rocm if it exists.
420 - See "How do I enable ROCm SMI and select which version to use?"
421 in the FAQ for details.
422 + Add a CMakeLists for Windows under contrib/windows-cmake/ .
423 * Documentation
424 + Add FAQ entry "How do I create a custom heterogeneous and
425 asymmetric topology?"
426
427
428 Version 2.5.0
429 -------------
430 * API
431 + Add hwloc/windows.h to query Windows processor groups.
432 + Add hwloc_get_obj_with_same_locality() to convert between objects
433 with same locality, for instance NUMA nodes and Packages,
434 or OS devices within a PCI device.
435 + Add hwloc_distances_transform() to modify distances structures.
436 - hwloc-annotate and lstopo have new distances-transform options.
437 + hwloc_distances_add() is replaced with _add_create() followed by
438 _add_values() and _add_commit(). See hwloc/distances.h for details.
439 + Add topology flags to mitigate binding modifications during
440 hwloc discovery, especially on Windows:
441 - HWLOC_TOPOLOGY_FLAG_RESTRICT_TO_CPUBINDING and _MEMBINDING
442 restrict discovery to PUs and NUMA nodes inside the binding.
443 - HWLOC_TOPOLOGY_FLAG_DONT_CHANGE_BINDING prevents from ever
444 changing the binding during discovery.
445 * Backends
446 + Add a levelzero backend for oneAPI L0 devices, exposed as OS devices
447 of subtype "LevelZero" and name such as "ze0".
448 - Add hwloc/levelzero.h for interoperability between converting
449 between L0 API devices and hwloc cpusets or OS devices.
450 + Expose NEC Vector Engine cards on Linux as OS devices of subtype
451 "VectorEngine" and name "ve0", etc.
452 Thanks to Anara Kozhokanova, Tim Cramer and Erich Focht for the help.
453 + Add a NVLinkBandwidth distances structure between NVIDIA GPUs
454 (and POWER processor or NVSwitches) in the NVML backend,
455 and a XGMIBandwidth distances structure between AMD GPUs
456 in the RSMI backends.
457 - See "Topology Attributes: Distances, Memory Attributes and CPU Kinds"
458 in the documentation for details about these new distances.
459 + Add support for NUMA node 0 being offline in Linux, thanks to Jirka Hladky.
460 * Build
461 + Add --with-cuda-version=<version> or look at the CUDA_VERSION
462 environment variable to find the appropriate CUDA pkg-config files.
463 Thanks to Stephen Herbein for the suggestion.
464 - Also add --with-cuda=<dir> to specify the CUDA installation path
465 manually (and its NVML and OpenCL components).
466 Thanks to Andrea Bocci for the suggestion.
467 - See "How do I enable CUDA and select which CUDA version to use?"
468 in the FAQ for details.
469 * Tools
470 + lstopo now has a --windows-processor-groups option on Windows.
471 + hwloc-ps now has a --short-name option to avoid long/truncated
472 command path.
473 + hwloc-ps now has a --single-ancestor option to return a single
474 (possibly too large) object where a process is bound.
475 + hwloc-ps --pid-cmd may now query environment variables,
476 including MPI-specific variables to find out process ranks.
477
478
479 Version 2.4.1
480 -------------
481 * Fix AMD OpenCL device locality when PCI bus or device number >= 128.
482 Thanks to Edgar Leon for reporting the issue.
483 + Applications using any of the following inline functions must
484 be recompiled to get the fix: hwloc_opencl_get_device_pci_busid()
485 hwloc_opencl_get_device_cpuset(), hwloc_opencl_get_device_osdev().
486 * Fix the ranking of cpukinds on non-Windows systems,
487 thanks to Ivan Kochin for the report.
488 * Fix the insertion of custom Groups after loading the topology,
489 thanks to Scott Hicks.
490 * Add support for CPU0 being offline in Linux, thanks to Garrett Clay.
491 * Fix missing x86 Package and Core objects FreeBSD/NetBSD.
492 Thanks to Thibault Payet and Yuri Victorovich for the report.
493 * Fix the import of very large distances with heterogeneous object types.
494 * Fix a memory leak in the Linux backend,
495 thanks to Perceval Anichini.
496
497
498 Version 2.4.0
499 -------------
500 * API
501 + Add hwloc/cpukinds.h for reporting information about hybrid CPUs.
502 - Use Linux cpufreq frequencies to rank cores by efficiency.
503 - Use x86 CPUID hybrid leaf and future Linux kernels sysfs CPU type
504 files to identify Intel Atom and Core cores.
505 - Use the Windows native EfficiencyClass to separate kinds.
506 * Backends
507 + Properly handle Linux kernel 5.10+ exposing ACPI HMAT information
508 with knowledge of Generic Initiators.
509 * Tools
510 + lstopo has new --cpukinds and --no-cpukinds options for showing
511 CPU kinds or not in textual and graphical modes respectively.
512 + hwloc-calc has a new --cpukind option for filtering PUs by kind.
513 + hwloc-annotate has a new cpukind command for modifying CPU kinds.
514 * Misc
515 + Fix hwloc_bitmap_nr_ulongs(), thanks to Norbert Eicker.
516 + Add a documentation section about
517 "Topology Attributes: Distances, Memory Attributes and CPU Kinds".
518 + Silence some spurious warnings in the OpenCL backend and when showing
519 process binding with lstopo --ps.
520
521
522 Version 2.3.0
523 -------------
524 * API
525 + Add hwloc/memattrs.h for exposing latency/bandwidth information
526 between initiators (CPU sets for now) and target NUMA nodes,
527 typically on heterogeneous platforms.
528 - When available, bandwidths and latencies are read from the ACPI HMAT
529 table exposed by Linux kernel 5.2+.
530 - Attributes may also be customized to expose user-defined performance
531 information.
532 + Add hwloc_get_local_numanode_objs() for listing NUMA nodes that are
533 local to some locality.
534 + The new topology flag HWLOC_TOPOLOGY_FLAG_IMPORT_SUPPORT causes
535 support arrays to be loaded from XML exported with hwloc 2.3+.
536 - hwloc_topology_get_support() now returns an additional "misc"
537 array with feature "imported_support" set when support was imported.
538 + Add hwloc_topology_refresh() to refresh internal caches after modifying
539 the topology and before consulting the topology in a multithread context.
540 * Backends
541 + Add a ROCm SMI backend and a hwloc/rsmi.h helper file for getting
542 the locality of AMD GPUs, now exposed as "rsmi" OS devices.
543 Thanks to Mike Li.
544 + Remove POWER device-tree-based topology on Linux,
545 (it was disabled by default since 2.1).
546 * Tools
547 + Command-line options for specifying flags now understand comma-separated
548 lists of flag names (substrings).
549 + hwloc-info and hwloc-calc have new --local-memory --local-memory-flags
550 and --best-memattr options for reporting local memory nodes and filtering
551 by memory attributes.
552 + hwloc-bind has a new --best-memattr option for filtering by memory attributes
553 among the memory binding set.
554 + Tools that have a --restrict option may now receive a nodeset or
555 some custom flags for restricting the topology.
556 + lstopo now has a --thickness option for changing line thickness in the
557 graphical output.
558 + Fix lstopo drawing when autoresizing on Windows 10.
559 + Pressing the F5 key in lstopo X11 and Windows graphical/interactive outputs
560 now refreshes the display according to the current topology and binding.
561 + Add a tikz lstopo graphical backend to generate picture easily included into
562 LaTeX documents. Thanks to Clement Foyer.
563 * Misc
564 + The default installation path of the Bash completion file has changed to
565 ${datadir}/bash-completion/completions/hwloc. Thanks to Tomasz Kłoczko.
566
567
568 Version 2.2.0
569 -------------
570 * API
571 + Add hwloc_bitmap_singlify_by_core() to remove SMT from a given cpuset,
572 thanks to Florian Reynier for the suggestion.
573 + Add --enable-32bits-pci-domain to stop ignoring PCI devices with domain
574 >16bits (e.g. 10000:02:03.4). Enabling this option breaks the library ABI.
575 Thanks to Dylan Simon for the help.
576 * Backends
577 + Add support for Linux cgroups v2.
578 + Add NUMA support for FreeBSD.
579 + Add get_last_cpu_location support for FreeBSD.
580 + Remove support for Intel Xeon Phi (MIC, Knights Corner) co-processors.
581 * Tools
582 + Add --uid to filter the hwloc-ps output by uid on Linux.
583 + Add a GRAPHICAL OUTPUT section in the manpage of lstopo.
584 * Misc
585 + Use the native dlopen instead of libltdl,
586 unless --disable-plugin-dlopen is passed at configure time.
587
588
589 Version 2.1.0
590 -------------
591 * API
592 + Add a new "Die" object (HWLOC_OBJ_DIE) for upcoming x86 processors
593 with multiple dies per package, in the x86 and Linux backends.
594 + Add the new HWLOC_OBJ_MEMCACHE object type for memory-side caches.
595 - They are filtered-out by default, except in command-line tools.
596 - They are only available on very recent platforms running Linux 5.2+
597 and uptodate ACPI tables.
598 - The KNL MCDRAM in cache mode is still exposed as a L3 unless
599 HWLOC_KNL_MSCACHE_L3=0 in the environment.
600 + Add HWLOC_RESTRICT_FLAG_BYNODESET and _REMOVE_MEMLESS for restricting
601 topologies based on some memory nodes.
602 + Add hwloc_topology_set_components() for blacklisting some components
603 from being enabled in a topology.
604 + Add hwloc_bitmap_nr_ulongs() and hwloc_bitmap_from/to_ulongs(),
605 thanks to Junchao Zhang for the suggestion.
606 + Improve the API for dealing with disallowed resources
607 - HWLOC_TOPOLOGY_FLAG_WHOLE_SYSTEM is replaced with FLAG_INCLUDE_DISALLOWED
608 and --whole-system command-line options with --disallowed.
609 . Former names are still accepted for backward compatibility.
610 - Add hwloc_topology_allow() for changing allowed sets after load().
611 - Add the HWLOC_ALLOW=all environment variable to totally ignore
612 administrative restrictions such as Linux Cgroups.
613 - Add disallowed_pu and disallowed_numa bits to the discovery support
614 structure.
615 + Group objects have a new "dont_merge" attribute to prevent them from
616 being automatically merged with identical parent or children.
617 + Add more distances-related features:
618 - Add hwloc_distances_get_name() to retrieve a string describing
619 what a distances structure contain.
620 - Add hwloc_distances_get_by_name() to retrieve distances structures
621 based on their name.
622 - Add hwloc_distances_release_remove()
623 - Distances may now cover objects of different types with new kind
624 HWLOC_DISTANCES_KIND_HETEROGENEOUS_TYPES.
625 * Backends
626 + Add support for Linux 5.3 new sysfs cpu topology files with Die information.
627 + Add support for Intel v2 Extended Topology Enumeration in the x86 backend.
628 + Improve memory locality on Linux by using HMAT initiators (exposed
629 since Linux 5.2+), and NUMA distances for CPU-less NUMA nodes.
630 + The x86 backend now properly handles offline CPUs.
631 + Detect the locality of NVIDIA GPU OpenCL devices.
632 + Ignore NUMA nodes that correspond to NVIDIA GPU by default.
633 - They may be unignored if HWLOC_KEEP_NVIDIA_GPU_NUMA_NODES=1 in the environment.
634 - Fix their CPU locality and add info attributes to identify them.
635 Thanks to Max Katz and Edgar Leon for the help.
636 + Add support for IBM S/390 drawers.
637 + Rework the heuristics for discovering KNL Cluster and Memory modes
638 to stop assuming all CPUs are online (required for mOS support).
639 Thanks to Sharath K Bhat for testing patches.
640 + Ignore NUMA node information from AMD topoext in the x86 backend,
641 unless HWLOC_X86_TOPOEXT_NUMANODES=1 is set in the environment.
642 + Expose Linux DAX devices as hwloc Block OS devices.
643 + Remove support for /proc/cpuinfo-only topology discovery in Linux
644 kernel prior to 2.6.16.
645 + Disable POWER device-tree-based topology on Linux by default.
646 - It may be reenabled by setting HWLOC_USE_DT=1 in the environment.
647 + Discovery components are now divided in phases that may be individually
648 blacklisted.
649 - The linuxio component has been merged back into the linux component.
650 * Tools
651 + lstopo
652 - lstopo factorizes objects by default in the graphical output when
653 there are more than 4 identical children.
654 . New options --no-factorize and --factorize may be used to configure this.
655 . Hit the 'f' key to disable factorizing in interactive outputs.
656 - Both logical and OS/physical indexes are now displayed by default
657 for PU and NUMA nodes.
658 - The X11 and Windows interactive outputs support many keyboard
659 shortcuts to dynamically customize the attributes, legend, etc.
660 - Add --linespacing and change default margins and linespacing.
661 - Add --allow for changing allowed sets.
662 - Add a native SVG backend. Its graphical output may be slightly less
663 pretty than Cairo (still used by default if available) but the SVG
664 code provides attributes to manipulate objects from HTML/JS.
665 See dynamic_SVG_example.html for an example.
666 + Add --nodeset options to hwloc-calc for converting between cpusets and
667 nodesets.
668 + Add --no-smt to lstopo, hwloc-bind and hwloc-calc to ignore multiple
669 PU in SMT cores.
670 + hwloc-annotate may annotate multiple locations at once.
671 + Add a HTML/JS version of hwloc-ps. See contrib/hwloc-ps.www/README.
672 + Add bash completions.
673 * Misc
674 + Add several FAQ entries in "Compatibility between hwloc versions"
675 about API version, ABI, XML, Synthetic strings, and shmem topologies.
676
677
678 Version 2.0.4 (also included in 1.11.13 when appropriate)
679 -------------
680 * Add support for Linux 5.3 new sysfs cpu topology files with Die information.
681 * Add support for Intel v2 Extended Topology Enumeration in the x86 backend.
682 * Tiles, Modules and Dies are exposed as Groups for now.
683 + HWLOC_DONT_MERGE_DIE_GROUPS=1 may be set in the environment to prevent
684 Die groups from being automatically merged with identical parent or children.
685 * Ignore NUMA node information from AMD topoext in the x86 backend,
686 unless HWLOC_X86_TOPOEXT_NUMANODES=1 is set in the environment.
687 * Group objects have a new "dont_merge" attribute to prevent them from
688 being automatically merged with identical parent or children.
689
690
691 Version 2.0.3 (also included in 1.11.12 when appropriate)
692 -------------
693 * Fix build on Cygwin, thanks to Marco Atzeri for the patches.
694 * Fix a corner case of hwloc_topology_restrict() where children would
695 become out-of-order.
696 * Fix the return length of export_xmlbuffer() functions to always
697 include the ending \0.
698 * Fix lstopo --children-order argument parsing.
699
700
701 Version 2.0.2 (also included in 1.11.11 when appropriate)
702 -------------
703 * Add support for Hygon Dhyana processors in the x86 backend,
704 thanks to Pu Wen for the patch.
705 * Fix symbol renaming to also rename internal components,
706 thanks to Evan Ramos for the patch.
707 * Fix build on HP-UX, thanks to Richard Lloyd for reporting the issues.
708 * Detect PCI link speed without being root on Linux >= 4.13.
709 * Add HWLOC_VERSION* macros to the public headers,
710 thanks to Gilles Gouaillardet for the suggestion.
711
712
713 Version 2.0.1 (also included in 1.11.10 when relevant)
714 -------------
715 * Bump the library soname to 15:0:0 to avoid conflicts with hwloc 1.11.x
716 releases. The hwloc 2.0.0 soname was buggy (12:0:0), applications will
717 have to be recompiled.
718 * Serialize pciaccess discovery to fix concurrent topology loads in
719 multiple threads.
720 * Fix hwloc-dump-hwdata to only process SMBIOS information that correspond
721 to the KNL and KNM configuration.
722 * Add a heuristic for guessing KNL/KNM memory and cluster modes when
723 hwloc-dump-hwdata could not run as root earlier.
724 * Add --no-text lstopo option to remove text from some boxes in the
725 graphical output. Mostly useful for removing Group labels.
726 * Some minor fixes to memory binding.
727
728
729 Version 2.0.0
730 -------------
731 *** The ABI of the library has changed. ***
732 For instance some hwloc_obj fields were reordered, added or removed, see below.
733 + HWLOC_API_VERSION and hwloc_get_api_version() now give 0x00020000.
734 + See "How do I handle ABI breaks and API upgrades ?" in the FAQ
735 and "Upgrading to hwloc 2.0 API" in the documentation.
736 * Major API changes
737 + Memory, I/O and Misc objects are now stored in dedicated children lists,
738 not in the usual children list that is now only used for CPU-side objects.
739 - hwloc_get_next_child() may still be used to iterate over these 4 lists
740 of children at once.
741 - hwloc_obj_type_is_normal(), _memory() and _io() may be used to check
742 the kind of a given object type.
743 + Topologies always have at least one NUMA object. On non-NUMA machines,
744 a single NUMA object is added to describe the entire machine memory.
745 The NUMA level cannot be ignored anymore.
746 + The NUMA level is special since NUMA nodes are not in the main hierarchy
747 of objects anymore. Its depth is a fake negative depth that should not be
748 compared with normal levels.
749 - If all memory objects are attached to parents at the same depth,
750 it may be retrieved with hwloc_get_memory_parents_depth().
751 + The HWLOC_OBJ_CACHE type is replaced with 8 types HWLOC_OBJ_L[1-5]CACHE
752 and HWLOC_OBJ_L[1-3]ICACHE that remove the need to disambiguate levels
753 when looking for caches with _by_type() functions.
754 - New hwloc_obj_type_is_{,d,i}cache() functions may be used to check whether
755 a given type is a cache.
756 + Reworked ignoring/filtering API
757 - Replace hwloc_topology_ignore*() functions with hwloc_topology_set_type_filter()
758 and hwloc_topology_set_all_types_filter().
759 . Contrary to hwloc_topology_ignore_{type,all}_keep_structure() which
760 removed individual objects, HWLOC_TYPE_FILTER_KEEP_STRUCTURE only removes
761 entire levels (so that topology do not become too asymmetric).
762 - Remove HWLOC_TOPOLOGY_FLAG_ICACHES in favor of hwloc_topology_set_icache_types_filter()
763 with HWLOC_TYPE_FILTER_KEEP_ALL.
764 - Remove HWLOC_TOPOLOGY_FLAG_IO_DEVICES, _IO_BRIDGES and _WHOLE_IO in favor of
765 hwloc_topology_set_io_types_filter() with HWLOC_TYPE_FILTER_KEEP_ALL or
766 HWLOC_TYPE_FILTER_KEEP_IMPORTANT.
767 + The distance API has been completely reworked. It is now described
768 in hwloc/distances.h.
769 + Return values
770 - Most functions in hwloc/bitmap.h now return an int that may be negative
771 in case of failure to realloc/extend the internal storage of a bitmap.
772 - hwloc_obj_add_info() also returns an int in case allocations fail.
773 * Minor API changes
774 + Object attributes
775 - obj->memory is removed.
776 . local_memory and page_types attributes are now in obj->attr->numanode
777 . total_memory moves obj->total_memory.
778 - Objects do not have allowed_cpuset and allowed_nodeset anymore.
779 They are only available for the entire topology using
780 hwloc_topology_get_allowed_cpuset() and hwloc_topology_get_allowed_nodeset().
781 - Objects now have a "subtype" field that supersedes former "Type" and
782 "CoProcType" info attributes.
783 + Object and level depths are now signed ints.
784 + Object string printing and parsing
785 - hwloc_type_sscanf() deprecates the old hwloc_obj_type_sscanf().
786 - hwloc_type_sscanf_as_depth() is added to convert a type name into
787 a level depth.
788 - hwloc_obj_cpuset_snprintf() is deprecated in favor of hwloc_bitmap_snprintf().
789 + Misc objects
790 - Replace hwloc_topology_insert_misc_object_by_cpuset() with
791 hwloc_topology_insert_group_object() to precisely specify the location
792 of an additional hierarchy level in the topology.
793 - Misc objects have their own level and depth to iterate over all of them.
794 - Misc objects may now only be inserted as a leaf object with
795 hwloc_topology_insert_misc_object() which deprecates
796 hwloc_topology_insert_misc_object_by_parent().
797 + hwloc_topology_restrict() doesn't remove objects that contain memory
798 by default anymore.
799 - The list of existing restrict flags was modified.
800 + The discovery support array now contains some NUMA specific bits.
801 + XML export functions take an additional flags argument,
802 for instance for exporting XMLs that are compatible with hwloc 1.x.
803 + Functions diff_load_xml*(), diff_export_xml*() and diff_destroy() in
804 hwloc/diff.h do not need a topology as first parameter anymore.
805 + hwloc_parse_cpumap_file () superseded by hwloc_linux_read_path_as_cpumask()
806 in hwloc/linux.h.
807 + HWLOC_MEMBIND_DEFAULT and HWLOC_MEMBIND_FIRSTTOUCH were clarified.
808 * New APIs and Features
809 + Add hwloc/shmem.h for sharing topologies between processes running on
810 the same machine (for reducing the memory footprint).
811 + Add the experimental netloc subproject. It is disabled by default
812 and can be enabled with --enable-netloc.
813 It currently brings command-line tools to gather and visualize the
814 topology of InfiniBand fabrics, and an API to convert such topologies
815 into Scotch architectures for process mapping.
816 See the documentation for details.
817 * Removed APIs and features
818 + Remove the online_cpuset from struct hwloc_obj. Offline PUs get unknown
819 topologies on Linux nowadays, and wrong topology on Solaris. Other OS
820 do not support them. And one cannot do much about them anyway. Just keep
821 them in complete_cpuset.
822 + Remove the now-unused "System" object type HWLOC_OBJ_SYSTEM,
823 defined to MACHINE for backward compatibility.
824 + The almost-unused "os_level" attribute has been removed from the
825 hwloc_obj structure.
826 + Remove the custom interface for assembling the topologies of different
827 nodes as well as the hwloc-assembler tools.
828 + hwloc_topology_set_fsroot() is removed, the environment variable
829 HWLOC_FSROOT may be used for the same remote testing/debugging purpose.
830 + Remove the deprecated hwloc_obj_snprintf(), hwloc_obj_type_of_string(),
831 hwloc_distribute[v]().
832 * Remove Myrinet Express interoperability (hwloc/myriexpress.h).
833 + Remove Kerrighed support from the Linux backend.
834 + Remove Tru64 (OSF/1) support.
835 - Remove HWLOC_MEMBIND_REPLICATE which wasn't available anywhere else.
836 * Backend improvements
837 + Linux
838 - OS devices do not have to be attached through PCI anymore,
839 for instance enabling the discovery of NVDIMM block devices.
840 - Remove the dependency on libnuma.
841 - Add a SectorSize attribute to block OS devices.
842 + Mac OS X
843 - Fix detection of cores and hyperthreads.
844 - Add CPUVendor, Model, ... attributes.
845 + Windows
846 - Add get_area_memlocation().
847 * Tools
848 + lstopo and hwloc-info have a new --filter option matching the new filtering API.
849 + lstopo can be given --children-order=plain to force a basic displaying
850 of memory and normal children together below their parent.
851 + hwloc-distances was removed and replaced with lstopo --distances.
852 * Misc
853 + Exports
854 - Exporting to synthetic now ignores I/O and Misc objects.
855 + PCI discovery
856 - Separate OS device discovery from PCI discovery. Only the latter is disabled
857 with --disable-pci at configure time. Both may be disabled with --disable-io.
858 - The `linuxpci' component is now renamed into `linuxio'.
859 - The old `libpci' component name from hwloc 1.6 is not supported anymore,
860 only the `pci' name from hwloc 1.7 is now recognized.
861 - The HWLOC_PCI_<domain>_<bus>_LOCALCPUS environment variables are superseded
862 with a single HWLOC_PCI_LOCALITY where bus ranges may be specified.
863 - Do not set PCI devices and bridges name automatically. Vendor and device
864 names are already in info attributes.
865 + Components and discovery
866 - Add HWLOC_SYNTHETIC environment variable to enforce a synthetic topology
867 as if hwloc_topology_set_synthetic() had been called.
868 - HWLOC_COMPONENTS doesn't support xml or synthetic component attributes
869 anymore, they should be passed in HWLOC_XMLFILE or HWLOC_SYNTHETIC instead.
870 - HWLOC_COMPONENTS takes precedence over other environment variables
871 for selecting components.
872 + hwloc now requires a C99 compliant compiler.
873
874
875 Version 1.11.13 (also included in 2.0.4)
876 ---------------
877 * Add support for Linux 5.3 new sysfs cpu topology files with Die information.
878 * Add support for Intel v2 Extended Topology Enumeration in the x86 backend.
879 * Tiles, Modules and Dies are exposed as Groups for now.
880 + HWLOC_DONT_MERGE_DIE_GROUPS=1 may be set in the environment to prevent
881 Die groups from being automatically merged with identical parent or children.
882 * Ignore NUMA node information from AMD topoext in the x86 backend,
883 unless HWLOC_X86_TOPOEXT_NUMANODES=1 is set in the environment.
884 * Group objects have a new "dont_merge" attribute to prevent them from
885 being automatically merged with identical parent or children.
886
887
888 Version 1.11.12 (also included in 2.0.3)
889 ---------------
890 * Fix a corner case of hwloc_topology_restrict() where children would
891 become out-of-order.
892 * Fix the return length of export_xmlbuffer() functions to always
893 include the ending \0.
894
895
896 Version 1.11.11 (also included in 2.0.2)
897 ---------------
898 * Add support for Hygon Dhyana processors in the x86 backend,
899 thanks to Pu Wen for the patch.
900 * Fix symbol renaming to also rename internal components,
901 thanks to Evan Ramos for the patch.
902 * Fix build on HP-UX, thanks to Richard Lloyd for reporting the issues.
903 * Detect PCI link speed without being root on Linux >= 4.13.
904
905
906 Version 1.11.10 (also included in 2.0.1)
907 ---------------
908 * Fix detection of cores and hyperthreads on Mac OS X.
909 * Serialize pciaccess discovery to fix concurrent topology loads in
910 multiple threads.
911 * Fix first touch area memory binding on Linux when thread memory
912 binding is different.
913 * Some minor fixes to memory binding.
914 * Fix hwloc-dump-hwdata to only process SMBIOS information that correspond
915 to the KNL and KNM configuration.
916 * Add a heuristic for guessing KNL/KNM memory and cluster modes when
917 hwloc-dump-hwdata could not run as root earlier.
918 * Fix discovery of NVMe OS devices on Linux >= 4.0.
919 * Add get_area_memlocation() on Windows.
920 * Add CPUVendor, Model, ... attributes on Mac OS X.
921
922
923 Version 1.11.9
924 --------------
925 * Add support for Zhaoxin ZX-C and ZX-D processors in the x86 backend,
926 thanks to Jeff Zhao for the patch.
927 * Fix AMD Epyc 24-core L3 cache locality in the x86 backend.
928 * Don't crash in the x86 backend when the CPUID vendor string is unknown.
929 * Fix the missing pu discovery support bit on some OS.
930 * Fix the management of the lstopoStyle info attribute for custom colors.
931 * Add verbose warnings when failing to load hwloc v2.0+ XMLs.
932
933
934 Version 1.11.8
935 --------------
936 * Multiple Solaris improvements, thanks to Maureen Chew for the help:
937 + Detect caches on Sparc.
938 + Properly detect allowed/disallowed PUs and NUMA nodes with processor sets.
939 + Add hwloc_get_last_cpu_location() support for the current thread.
940 * Add support for CUDA compute capability 7.0 and fix support for 6.[12].
941 * Tools improvements
942 + Fix search for objects by physical index in command-line tools.
943 + Add missing "cpubind:get_thisthread_last_cpu_location" in the output
944 of hwloc-info --support.
945 + Add --pid and --name to specify target processes in hwloc-ps.
946 + Display thread names in lstopo and hwloc-ps on Linux.
947 * Doc improvements
948 + Add a FAQ entry about building on Windows.
949 + Install missing sub-manpage for hwloc_obj_add_info() and
950 hwloc_obj_get_info_by_name().
951
952
953 Version 1.11.7
954 --------------
955 * Fix hwloc-bind --membind for CPU-less NUMA nodes (again).
956 Thanks to Gilles Gouaillardet for reporting the issue.
957 * Fix a memory leak on IBM S/390 platforms running Linux.
958 * Fix a memory leak when forcing the x86 backend first on amd64/topoext
959 platforms running Linux.
960 * Command-line tools now support "hbm" instead "numanode" for filtering
961 only high-bandwidth memory nodes when selecting locations.
962 + hwloc-bind also support --hbm and --no-hbm for filtering only or
963 no HBM nodes.
964 Thanks to Nicolas Denoyelle for the suggestion.
965 * Add --children and --descendants to hwloc-info for listing object
966 children or object descendants of a specific type.
967 * Add --no-index, --index, --no-attrs, --attrs to disable/enable display
968 of index numbers or attributes in the graphical lstopo output.
969 * Try to gather hwloc-dump-hwdata output from all possible locations
970 in hwloc-gather-topology.
971 * Updates to the documentation of locations in hwloc(7) and
972 command-line tools manpages.
973
974
975 Version 1.11.6
976 --------------
977 * Make the Linux discovery about twice faster, especially on the CPU side,
978 by trying to avoid sysfs file accesses as much as possible.
979 * Add support for AMD Family 17h processors (Zen) SMT cores in the Linux
980 and x86 backends.
981 * Add the HWLOC_TOPOLOGY_FLAG_THISSYSTEM_ALLOWED_RESOURCES flag (and the
982 HWLOC_THISSYSTEM_ALLOWED_RESOURCES environment variable) for reading the
983 set of allowed resources from the local operating system even if the
984 topology was loaded from XML or synthetic.
985 * Fix hwloc_bitmap_set/clr_range() for infinite ranges that do not
986 overlap currently defined ranges in the bitmap.
987 * Don't reset the lstopo zoom scale when moving the X11 window.
988 * lstopo now has --flags for manually setting topology flags.
989 * hwloc_get_depth_type() returns HWLOC_TYPE_DEPTH_UNKNOWN for Misc objects.
990
991
992 Version 1.11.5
993 --------------
994 * Add support for Knights Mill Xeon Phi, thanks to Piotr Luc for the patch.
995 * Reenable distance gathering on Solaris, disabled by mistake since v1.0.
996 Thanks to TU Wien for the help.
997 * Fix hwloc_get_*obj*_inside_cpuset() functions to ignore objects with
998 empty CPU sets, for instance, CPU-less NUMA nodes such as KNL MCDRAM.
999 Thanks to Nicolas Denoyelle for the report.
1000 * Fix XML import of multiple distance matrices.
1001 * Add a FAQ entry about "hwloc is only a structural model, it ignores
1002 performance models, memory bandwidth, etc.?"
1003
1004
1005 Version 1.11.4
1006 --------------
1007 * Add MemoryMode and ClusterMode attributes in the Machine object on KNL.
1008 Add doc/examples/get-knl-modes.c for an example of retrieving them.
1009 Thanks to Grzegorz Andrejczuk.
1010 * Fix Linux build with -m32 with respect to libudev.
1011 Thanks to Paul Hargrove for reporting the issue.
1012 * Fix build with Visual Studio 2015, thanks to Eloi Gaudry for reporting
1013 the issue and providing the patch.
1014 * Don't forget to display OS device children in the graphical lstopo.
1015 * Fix a memory leak on Solaris, thanks to Bryon Gloden for the patch.
1016 * Properly handle realloc() failures, thanks to Bryon Gloden for reporting
1017 the issue.
1018 * Fix lstopo crash in ascii/fig/windows outputs when some objects have a
1019 lstopoStyle info attribute.
1020
1021
1022 Version 1.11.3
1023 --------------
1024 * Bug fixes
1025 + Fix a memory leak on Linux S/390 hosts with books.
1026 + Fix /proc/mounts parsing on Linux by using mntent.h.
1027 Thanks to Nathan Hjelm for reporting the issue.
1028 + Fix a x86 infinite loop on VMware due to the x2APIC feature being
1029 advertised without actually being fully supported.
1030 Thanks to Jianjun Wen for reporting the problem and testing the patch.
1031 + Fix the return value of hwloc_alloc() on mmap() failure.
1032 Thanks to Hugo Brunie for reporting the issue.
1033 + Fix the return value of command-line tools in some error cases.
1034 + Do not break individual thread bindings during x86 backend discovery in a
1035 multithreaded process. Thanks to Farouk Mansouri for the report.
1036 + Fix hwloc-bind --membind for CPU-less NUMA nodes.
1037 + Fix some corner cases in the XML export/import of application userdata.
1038 * API Improvements
1039 + Add HWLOC_MEMBIND_BYNODESET flag so that membind() functions accept
1040 either cpusets or nodesets.
1041 + Add hwloc_get_area_memlocation() to check where pages are actually
1042 allocated. Only implemented on Linux for now.
1043 - There's no _nodeset() variant, but the new flag HWLOC_MEMBIND_BYNODESET
1044 is supported.
1045 + Make hwloc_obj_type_sscanf() parse back everything that may be outputted
1046 by hwloc_obj_type_snprintf().
1047 * Detection Improvements
1048 + Allow the x86 backend to add missing cache levels, so that it completes
1049 what the Solaris backend lacks.
1050 Thanks to Ryan Zezeski for reporting the issue.
1051 + Do not filter-out FibreChannel PCI adapters by default anymore.
1052 Thanks to Matt Muggeridge for the report.
1053 + Add support for CUDA compute capability 6.x.
1054 * Tools
1055 + Add --support to hwloc-info to list supported features, just like with
1056 hwloc_topology_get_support().
1057 - Also add --objects and --topology to explicitly switch between the
1058 default modes.
1059 + Add --tid to let hwloc-bind operate on individual threads on Linux.
1060 + Add --nodeset to let hwloc-bind report memory binding as NUMA node sets.
1061 + hwloc-annotate and lstopo don't drop application userdata from XMLs anymore.
1062 - Add --cu to hwloc-annotate to drop these application userdata.
1063 + Make the hwloc-dump-hwdata dump directory configurable through configure
1064 options such as --runstatedir or --localstatedir.
1065 * Misc Improvements
1066 + Add systemd service template contrib/systemd/hwloc-dump-hwdata.service
1067 for launching hwloc-dump-hwdata at boot on Linux.
1068 Thanks to Grzegorz Andrejczuk.
1069 + Add HWLOC_PLUGINS_BLACKLIST environment variable to prevent some plugins
1070 from being loaded. Thanks to Alexandre Denis for the suggestion.
1071 + Small improvements for various Windows build systems,
1072 thanks to Jonathan L Peyton and Marco Atzeri.
1073
1074
1075 Version 1.11.2
1076 --------------
1077 * Improve support for Intel Knights Landing Xeon Phi on Linux:
1078 + Group local NUMA nodes of normal memory (DDR) and high-bandwidth memory
1079 (MCDRAM) together through "Cluster" groups so that the local MCDRAM is
1080 easy to find.
1081 - See "How do I find the local MCDRAM NUMA node on Intel Knights
1082 Landing Xeon Phi?" in the documentation.
1083 - For uniformity across all KNL configurations, always have a NUMA node
1084 object even if the host is UMA.
1085 + Fix the detection of the memory-side cache:
1086 - Add the hwloc-dump-hwdata superuser utility to dump SMBIOS information
1087 into /var/run/hwloc/ as root during boot, and load this dumped
1088 information from the hwloc library at runtime.
1089 - See "Why do I need hwloc-dump-hwdata for caches on Intel Knights
1090 Landing Xeon Phi?" in the documentation.
1091 Thanks to Grzegorz Andrejczuk for the patches and for the help.
1092 * The x86 and linux backends may now be combined for discovering CPUs
1093 through x86 CPUID and memory from the Linux kernel.
1094 This is useful for working around buggy CPU information reported by Linux
1095 (for instance the AMD Bulldozer/Piledriver bug below).
1096 Combination is enabled by passing HWLOC_COMPONENTS=x86 in the environment.
1097 * Fix L3 cache sharing on AMD Opteron 63xx (Piledriver) and 62xx (Bulldozer)
1098 in the x86 backend. Thanks to many users who helped.
1099 * Fix the overzealous L3 cache sharing fix added to the x86 backend in 1.11.1
1100 for AMD Opteron 61xx (Magny-Cours) processors.
1101 * The x86 backend may now add the info attribute Inclusive=0 or 1 to caches
1102 it discovers, or to caches discovered by other backends earlier.
1103 Thanks to Guillaume Beauchamp for the patch.
1104 * Fix the management on alloc_membind() allocation failures on AIX, HP-UX
1105 and OSF/Tru64.
1106 * Fix spurious failures to load with ENOMEM on AIX in case of Misc objects
1107 below PUs.
1108 * lstopo improvements in X11 and Windows graphical mode:
1109 + Add + - f 1 shortcuts to manually zoom-in, zoom-out, reset the scale,
1110 or fit the entire window.
1111 + Display all keyboard shortcuts in the console.
1112 * Debug messages may be disabled at runtime by passing HWLOC_DEBUG_VERBOSE=0
1113 in the environment when --enable-debug was passed to configure.
1114 * Add a FAQ entry "What are these Group objects in my topology?".
1115
1116
1117 Version 1.11.1
1118 --------------
1119 * Detection fixes
1120 + Hardwire the topology of Fujitsu K-computer, FX10, FX100 servers to
1121 workaround buggy Linux kernels.
1122 Thanks to Takahiro Kawashima and Gilles Gouaillardet.
1123 + Fix L3 cache information on AMD Opteron 61xx Magny-Cours processors
1124 in the x86 backend. Thanks to Guillaume Beauchamp for the patch.
1125 + Detect block devices directly attached to PCI without a controller,
1126 for instance NVMe disks. Thanks to Barry M. Tannenbaum.
1127 + Add the PCISlot attribute to all PCI functions instead of only the
1128 first one.
1129 * Miscellaneous internal fixes
1130 + Ignore PCI bridges that could fail assertions by reporting buggy
1131 secondary-subordinate bus numbers
1132 Thanks to George Bosilca for reporting the issue.
1133 + Fix an overzealous assertion when inserting an intermediate Group object
1134 while Groups are totally ignored.
1135 + Fix a memory leak on Linux on AMD processors with dual-core compute units.
1136 Thanks to Bob Benner.
1137 + Fix a memory leak on failure to load a xml diff file.
1138 + Fix some segfaults when inputting an invalid synthetic description.
1139 + Fix a segfault when plugins fail to find core symbols.
1140 Thanks to Guy Streeter.
1141 * Many fixes and improvements in the Windows backend:
1142 + Fix the discovery of more than 32 processors and multiple processor
1143 groups. Thanks to Barry M. Tannenbaum for the help.
1144 + Add thread binding set support in case of multiple process groups.
1145 + Add thread binding get support.
1146 + Add get_last_cpu_location() support for the current thread.
1147 + Disable the unsupported process binding in case of multiple processor
1148 groups.
1149 + Fix/update the Visual Studio support under contrib/windows.
1150 Thanks to Eloi Gaudry for the help.
1151 * Tools fixes
1152 + Fix a segfault when displaying logical indexes in the graphical lstopo.
1153 Thanks to Guillaume Mercier for reporting the issue.
1154 + Fix lstopo linking with X11 libraries, for instance on Mac OS X.
1155 Thanks to Scott Atchley and Pierre Ramet for reporting the issue.
1156 + hwloc-annotate, hwloc-diff and hwloc-patch do not drop unavailable
1157 resources from the output anymore and those may be annotated as well.
1158 + Command-line tools may now import XML from the standard input with -i -.xml
1159 + Add missing documentation for the hwloc-info --no-icaches option.
1160
1161
1162 Version 1.11.0
1163 --------------
1164 * API
1165 + Socket objects are renamed into Package to align with the terminology
1166 used by processor vendors. The old HWLOC_OBJ_SOCKET type and "Socket"
1167 name are still supported for backward compatibility.
1168 + HWLOC_OBJ_NODE is replaced with HWLOC_OBJ_NUMANODE for clarification.
1169 HWLOC_OBJ_NODE is still supported for backward compatibility.
1170 "Node" and "NUMANode" strings are supported as in earlier releases.
1171 * Detection improvements
1172 + Add support for Intel Knights Landing Xeon Phi.
1173 Thanks to Grzegorz Andrejczuk and Lukasz Anaczkowski.
1174 + Add Vendor, Model, Revision, SerialNumber, Type and LinuxDeviceID
1175 info attributes to Block OS devices on Linux. Thanks to Vineet Pedaballe
1176 for the help.
1177 - Add --disable-libudev to avoid dependency on the libudev library.
1178 + Add "MemoryModule" Misc objects with information about DIMMs, on Linux
1179 when privileged and when I/O is enabled.
1180 Thanks to Vineet Pedaballe for the help.
1181 + Add a PCISlot attribute to PCI devices on Linux when supported to
1182 identify the physical PCI slot where the board is plugged.
1183 + Add CPUStepping info attribute on x86 processors,
1184 thanks to Thomas Röhl for the suggestion.
1185 + Ignore the device-tree on non-Power architectures to avoid buggy
1186 detection on ARM. Thanks to Orion Poplawski for reporting the issue.
1187 + Work-around buggy Xeon E5v3 BIOS reporting invalid PCI-NUMA affinity
1188 for the PCI links on the second processor.
1189 + Add support for CUDA compute capability 5.x, thanks Benjamin Worpitz.
1190 + Many fixes to the x86 backend
1191 - Add L1i and fix L2/L3 type on old AMD processors without topoext support.
1192 - Fix Intel CPU family and model numbers when basic family isn't 6 or 15.
1193 - Fix package IDs on recent AMD processors.
1194 - Fix misc issues due to incomplete APIC IDs on x2APIC processors.
1195 - Avoid buggy discovery on old SGI Altix UVs with non-unique APIC IDs.
1196 + Gather total machine memory on NetBSD.
1197 * Tools
1198 + lstopo
1199 - Collapse identical PCI devices unless --no-collapse is given.
1200 This avoids gigantic outputs when a PCI device contains dozens of
1201 identical virtual functions.
1202 - The ASCII art output is now called "ascii", for instance in
1203 "lstopo -.ascii".
1204 The former "txt" extension is retained for backward compatibility.
1205 - Automatically scales graphical box width to the inner text in Cairo,
1206 ASCII and Windows outputs.
1207 - Add --rect to lstopo to force rectangular layout even for NUMA nodes.
1208 - Add --restrict-flags to configure the behavior of --restrict.
1209 - Objects may have a "Type" info attribute to specify a better type name
1210 and display it in lstopo.
1211 - Really export all verbose information to the given output file.
1212 + hwloc-annotate
1213 - May now operate on all types of objects, including I/O.
1214 - May now insert Misc objects in the topology.
1215 - Do not drop instruction caches and I/O devices from the output anymore.
1216 + Fix lstopo path in hwloc-gather-topology after install.
1217 * Misc
1218 + Fix hwloc/cudart.h for machines with multiple PCI domains,
1219 thanks to Imre Kerr for reporting the problem.
1220 + Fix PCI Bridge-specific depth attribute.
1221 + Fix hwloc_bitmap_intersect() for two infinite bitmaps.
1222 + Fix some corner cases in the building of levels on large NUMA machines
1223 with non-uniform NUMA groups and I/Os.
1224 + Improve the performance of object insertion by cpuset for large
1225 topologies.
1226 + Prefix verbose XML import errors with the source name.
1227 + Improve pkg-config checks and error messages.
1228 + Fix excluding after a component with an argument in the HWLOC_COMPONENTS
1229 environment variable.
1230 * Documentation
1231 + Fix the recommended way in documentation and examples to allocate memory
1232 on some node, it should use HWLOC_MEMBIND_BIND.
1233 Thanks to Nicolas Bouzat for reporting the issue.
1234 + Add a "Miscellaneous objects" section in the documentation.
1235 + Add a FAQ entry "What happens to my topology if I disable symmetric
1236 multithreading, hyper-threading, etc. ?" to the documentation.
1237
1238
1239 Version 1.10.1
1240 --------------
1241 * Actually remove disallowed NUMA nodes from nodesets when the whole-system
1242 flag isn't enabled.
1243 * Fix the gathering of PCI domains. Thanks to James Custer for reporting
1244 the issue and providing a patch.
1245 * Fix the merging of identical parent and child in presence of Misc objects.
1246 Thanks to Dave Love for reporting the issue.
1247 * Fix some misordering of children when merging with ignore_keep_structure()
1248 in partially allowed topologies.
1249 * Fix an overzealous assertion in the debug code when running on a single-PU
1250 host with I/O. Thanks to Thomas Van Doren for reporting the issue.
1251 * Don't forget to setup NUMA node object nodesets in x86 backend (for BSDs)
1252 and OSF/Tru64 backend.
1253 * Fix cpuid-x86 build error with gcc -O3 on x86-32. Thanks to Thomas Van Doren
1254 for reporting the issue.
1255 * Fix support for future very large caches in the x86 backend.
1256 * Fix vendor/device names for SR-IOV PCI devices on Linux.
1257 * Fix an unlikely crash in case of buggy hierarchical distance matrix.
1258 * Fix PU os_index on some AIX releases. Thanks to Hendryk Bockelmann and
1259 Erik Schnetter for helping debugging.
1260 * Fix hwloc_bitmap_isincluded() in case of infinite sets.
1261 * Change hwloc-ls.desktop into a lstopo.desktop and only install it if
1262 lstopo is built with Cairo/X11 support. It cannot work with a non-graphical
1263 lstopo or hwloc-ls.
1264 * Add support for the renaming of Socket into Package in future releases.
1265 * Add support for the replacement of HWLOC_OBJ_NODE with HWLOC_OBJ_NUMANODE
1266 in future releases.
1267 * Clarify the documentation of distance matrices in hwloc.h and in the manpage
1268 of the hwloc-distances. Thanks to Dave Love for the suggestion.
1269 * Improve some error messages by displaying more information about the
1270 hwloc library in use.
1271 * Document how to deal with the ABI break when upgrading to the upcoming 2.0
1272 See "How do I handle ABI breaks and API upgrades ?" in the FAQ.
1273
1274
1275 Version 1.10.0
1276 --------------
1277 * API
1278 + Add hwloc_topology_export_synthetic() to export a topology to a
1279 synthetic string without using lstopo. See the Synthetic topologies
1280 section in the documentation.
1281 + Add hwloc_topology_set/get_userdata() to let the application save
1282 a private pointer in the topology whenever it needs a way to find
1283 its own object corresponding to a topology.
1284 + Add hwloc_get_numanode_obj_by_os_index() and document that this function
1285 as well as hwloc_get_pu_obj_by_os_index() are good at converting
1286 nodesets and cpusets into objects.
1287 + hwloc_distrib() does not ignore any objects anymore when there are
1288 too many of them. They get merged with others instead.
1289 Thanks to Tim Creech for reporting the issue.
1290 * Tools
1291 + hwloc-bind --get <command-line> now executes the command after displaying
1292 the binding instead of ignoring the command entirely.
1293 Thanks to John Donners for the suggestion.
1294 + Clarify that memory sizes shown in lstopo are local by default
1295 unless specified (total memory added in the root object).
1296 * Synthetic topologies
1297 + Synthetic topology descriptions may now specify attributes such as
1298 memory sizes and OS indexes. See the Synthetic topologies section
1299 in the documentation.
1300 + lstopo now exports in this fully-detailed format by default.
1301 The new option --export-synthetic-flags may be used to revert
1302 back the old format.
1303 * Documentation
1304 + Add the doc/examples/ subdirectory with several real-life examples,
1305 including the already existing hwloc-hello.C for basics.
1306 Thanks to Rob Aulwes for the suggestion.
1307 + Improve the documentation of CPU and memory binding in the API.
1308 + Add a FAQ entry about operating system errors, especially on AMD
1309 platforms with buggy cache information.
1310 + Add a FAQ entry about loading many topologies in a single program.
1311 * Misc
1312 + Work around buggy Linux kernels reporting 2 sockets instead
1313 1 socket with 2 NUMA nodes for each Xeon E5 v3 (Haswell) processor.
1314 + pciutils/libpci support is now removed since libpciaccess works
1315 well and there's also a Linux-specific PCI backend. For the record,
1316 pciutils was GPL and therefore disabled by default since v1.6.2.
1317 + Add --disable-cpuid configure flag to work around buggy processor
1318 simulators reporting invalid CPUID information.
1319 Thanks for Andrew Friedley for reporting the issue.
1320 + Fix a racy use of libltdl when manipulating multiple topologies in
1321 different threads.
1322 Thanks to Andra Hugo for reporting the issue and testing patches.
1323 + Fix some build failures in private/misc.h.
1324 Thanks to Pavan Balaji and Ralph Castain for the reports.
1325 + Fix failures to detect X11/Xutil.h on some Solaris platforms.
1326 Thanks to Siegmar Gross for reporting the failure.
1327 + The plugin ABI has changed, this release will not load plugins
1328 built against previous hwloc releases.
1329
1330
1331 Version 1.9.1
1332 -------------
1333 * Fix a crash when the PCI locality is invalid. Attach to the root object
1334 instead. Thanks to Nicolas Denoyelle for reporting the issue.
1335 * Fix -f in lstopo manpage. Thanks to Jirka Hladky for reporting the issue.
1336 * Fix hwloc_obj_type_sscanf() and others when strncasecmp() is not properly
1337 available. Thanks to Nick Papior Andersen for reporting the problem.
1338 * Mark Linux file descriptors as close-on-exec to avoid leaks on exec.
1339 * Fix some minor memory leaks.
1340
1341
1342 Version 1.9.0
1343 -------------
1344 * API
1345 + Add hwloc_obj_type_sscanf() to extend hwloc_obj_type_of_string() with
1346 type-specific attributes such as Cache/Group depth and Cache type.
1347 hwloc_obj_type_of_string() is moved to hwloc/deprecated.h.
1348 + Add hwloc_linux_get_tid_last_cpu_location() for retrieving the
1349 last CPU where a Linux thread given by TID ran.
1350 + Add hwloc_distrib() to extend the old hwloc_distribute[v]() functions.
1351 hwloc_distribute[v]() is moved to hwloc/deprecated.h.
1352 + Don't mix total and local memory when displaying verbose object attributes
1353 with hwloc_obj_attr_snprintf() or in lstopo.
1354 * Backends
1355 + Add CPUVendor, CPUModelNumber and CPUFamilyNumber info attributes for
1356 x86, ia64 and Xeon Phi sockets on Linux, to extend the x86-specific
1357 support added in v1.8.1. Requested by Ralph Castain.
1358 + Add many CPU- and Platform-related info attributes on ARM and POWER
1359 platforms, in the Machine and Socket objects.
1360 + Add CUDA info attributes describing the number of multiprocessors and
1361 cores and the size of the global, shared and L2 cache memories in CUDA
1362 OS devices.
1363 + Add OpenCL info attributes describing the number of compute units and
1364 the global memory size in OpenCL OS devices.
1365 + The synthetic backend now accepts extended types such as L2Cache, L1i or
1366 Group3. lstopo also exports synthetic strings using these extended types.
1367 * Tools
1368 + lstopo
1369 - Do not overwrite output files by default anymore.
1370 Pass -f or --force to enforce it.
1371 - Display OpenCL, CUDA and Xeon Phi numbers of cores and memory sizes
1372 in the graphical output.
1373 - Fix export to stdout when specifying a Cairo-based output type
1374 with --of.
1375 + hwloc-ps
1376 - Add -e or --get-last-cpu-location to report where processes/threads
1377 run instead of where they are bound.
1378 - Report locations as likely-more-useful objects such as Cores or Sockets
1379 instead of Caches when possible.
1380 + hwloc-bind
1381 - Fix failure on Windows when not using --pid.
1382 - Add -e as a synonym to --get-last-cpu-location.
1383 + hwloc-distrib
1384 - Add --reverse to distribute using last objects first and singlify
1385 into last bits first. Thanks to Jirka Hladky for the suggestion.
1386 + hwloc-info
1387 - Report unified caches when looking for data or instruction cache
1388 ancestor objects.
1389 * Misc
1390 + Add experimental Visual Studio support under contrib/windows.
1391 Thanks to Eloi Gaudry for his help and for providing the first draft.
1392 + Fix some overzealous assertions and warnings about the ordering of
1393 objects on a level with respect to cpusets. The ordering is only
1394 guaranteed for complete cpusets (based on the first bit in sets).
1395 + Fix some memory leaks when importing xml diffs and when exporting a
1396 "too complex" entry.
1397
1398
1399 Version 1.8.1
1400 -------------
1401 * Fix the cpuid code on Windows 64bits so that the x86 backend gets
1402 enabled as expected and can populate CPU information.
1403 Thanks to Robin Scher for reporting the problem.
1404 * Add CPUVendor/CPUModelNumber/CPUFamilyNumber attributes when running
1405 on x86 architecture. Thanks to Ralph Castain for the suggestion.
1406 * Work around buggy BIOS reporting duplicate NUMA nodes on Linux.
1407 Thanks to Jeff Becker for reporting the problem and testing the patch.
1408 * Add a name to the lstopo graphical window. Thanks to Michael Prokop
1409 for reporting the issue.
1410
1411
1412 Version 1.8.0
1413 -------------
1414 * New components
1415 + Add the "linuxpci" component that always works on Linux even when
1416 libpciaccess and libpci aren't available (and even with a modified
1417 file-system root). By default the old "pci" component runs first
1418 because "linuxpci" lacks device names (obj->name is always NULL).
1419 * API
1420 + Add the topology difference API in hwloc/diff.h for manipulating
1421 many similar topologies.
1422 + Add hwloc_topology_dup() for duplicating an entire topology.
1423 + hwloc.h and hwloc/helper.h have been reorganized to clarify the
1424 documentation sections. The actual inline code has moved out of hwloc.h
1425 into the new hwloc/inlines.h.
1426 + Deprecated functions are now in hwloc/deprecated.h, and not in the
1427 official documentation anymore.
1428 * Tools
1429 + Add hwloc-diff and hwloc-patch tools together with the new diff API.
1430 + Add hwloc-compress-dir to (de)compress an entire directory of XML files
1431 using hwloc-diff and hwloc-patch.
1432 + Object colors in the graphical output of lstopo may be changed by adding
1433 a "lstopoStyle" info attribute. See CUSTOM COLORS in the lstopo(1) manpage
1434 for details. Thanks to Jirka Hladky for discussing the idea.
1435 + hwloc-gather-topology may now gather I/O-related files on Linux when
1436 --io is given. Only the linuxpci component supports discovering I/O
1437 objects from these extended tarballs.
1438 + hwloc-annotate now supports --ri to remove/replace info attributes with
1439 a given name.
1440 + hwloc-info supports "root" and "all" special locations for dumping
1441 information about the root object.
1442 + lstopo now supports --append-legend to append custom lines of text
1443 to the legend in the graphical output. Thanks to Jirka Hladky for
1444 discussing the idea.
1445 + hwloc-calc and friends have a more robust parsing of locations given
1446 on the command-line and they report useful error messages about it.
1447 + Add --whole-system to hwloc-bind, hwloc-calc, hwloc-distances and
1448 hwloc-distrib, and add --restrict to hwloc-bind for uniformity among
1449 tools.
1450 * Misc
1451 + Calling hwloc_topology_load() or hwloc_topology_set_*() on an already
1452 loaded topology now returns an error (deprecated since release 1.6.1).
1453 + Fix the initialisation of cpusets and nodesets in Group objects added
1454 when inserting PCI hostbridges.
1455 + Never merge Group objects that were added explicitly by the user with
1456 hwloc_custom_insert_group_object_by_parent().
1457 + Add a sanity check during dynamic plugin loading to prevent some
1458 crashes when hwloc is dynamically loaded by another plugin mechanisms.
1459 + Add --with-hwloc-plugins-path to specify the install/load directories
1460 of plugins.
1461 + Add the MICSerialNumber info attribute to the root object when running
1462 hwloc inside a Xeon Phi to match the same attribute in the MIC OS device
1463 when running in the host.
1464
1465
1466 Version 1.7.2
1467 -------------
1468 * Do not create invalid block OS devices on very old Linux kernel such
1469 as RHEL4 2.6.9.
1470 * Fix PCI subvendor/device IDs.
1471 * Fix the management of Misc objects inserted by parent.
1472 Thanks to Jirka Hladky for reporting the problem.
1473 * Add a Port<n>State into attribute to OpenFabrics OS devices.
1474 * Add a MICSerialNumber info attribute to Xeon PHI/MIC OS devices.
1475 * Improve verbose error messages when failing to load from XML.
1476
1477
1478 Version 1.7.1
1479 -------------
1480 * Fix a failed assertion in the distance grouping code when loading a XML
1481 file that already contains some groups.
1482 Thanks to Laercio Lima Pilla for reporting the problem.
1483 * Remove unexpected Group objects when loading XML topologies with I/O
1484 objects and NUMA distances.
1485 Thanks to Elena Elkina for reporting the problem and testing patches.
1486 * Fix PCI link speed discovery when using libpciaccess.
1487 * Fix invalid libpciaccess virtual function device/vendor IDs when using
1488 SR-IOV PCI devices on Linux.
1489 * Fix GL component build with old NVCtrl releases.
1490 Thanks to Jirka Hladky for reporting the problem.
1491 * Fix embedding breakage caused by libltdl.
1492 Thanks to Pavan Balaji for reporting the problem.
1493 * Always use the system-wide libltdl instead of shipping one inside hwloc.
1494 * Document issues when enabling plugins while embedding hwloc in another
1495 project, in the documentation section Embedding hwloc in Other Software.
1496 * Add a FAQ entry "How to get useful topology information on NetBSD?"
1497 in the documentation.
1498 * Somes fixes in the renaming code for embedding.
1499 * Miscellaneous minor build fixes.
1500
1501
1502 Version 1.7.0
1503 -------------
1504 * New operating system backends
1505 + Add BlueGene/Q compute node kernel (CNK) support. See the FAQ in the
1506 documentation for details. Thanks to Jeff Hammond, Christopher Samuel
1507 and Erik Schnetter for their help.
1508 + Add NetBSD support, thanks to Aleksej Saushev.
1509 * New I/O device discovery
1510 + Add co-processor OS devices such as "mic0" for Intel Xeon Phi (MIC)
1511 on Linux. Thanks to Jerome Vienne for helping.
1512 + Add co-processor OS devices such as "cuda0" for NVIDIA CUDA-capable GPUs.
1513 + Add co-processor OS devices such as "opencl0d0" for OpenCL GPU devices
1514 on the AMD OpenCL implementation.
1515 + Add GPU OS devices such as ":0.0" for NVIDIA X11 displays.
1516 + Add GPU OS devices such as "nvml0" for NVIDIA GPUs.
1517 Thanks to Marwan Abdellah and Stefan Eilemann for helping.
1518 These new OS devices have some string info attributes such as CoProcType,
1519 GPUModel, etc. to better identify them.
1520 See the I/O Devices and Attributes documentation sections for details.
1521 * New components
1522 + Add the "opencl", "cuda", "nvml" and "gl" components for I/O device
1523 discovery.
1524 + "nvml" also improves the discovery of NVIDIA GPU PCIe link speed.
1525 All of these new components may be built as plugins. They may also be
1526 disabled entirely by passing --disable-opencl/cuda/nvml/gl to configure.
1527 See the I/O Devices, Components and Plugins, and FAQ documentation
1528 sections for details.
1529 * API
1530 + Add hwloc_topology_get_flags().
1531 + Add hwloc/plugins.h for building external plugins.
1532 See the Adding new discovery components and plugins section.
1533 * Interoperability
1534 + Add hwloc/opencl.h, hwloc/nvml.h, hwloc/gl.h and hwloc/intel-mic.h
1535 to retrieve the locality of OS devices that correspond to AMD OpenCL
1536 GPU devices or indexes, to NVML devices or indexes, to NVIDIA X11
1537 displays, or to Intel Xeon Phi (MIC) device indexes.
1538 + Add new helpers in hwloc/cuda.h and hwloc/cudart.h to convert
1539 between CUDA devices or indexes and hwloc OS devices.
1540 + Add hwloc_ibv_get_device_osdev() and clarify the requirements
1541 of the OpenFabrics Verbs helpers in hwloc/openfabrics-verbs.h.
1542 * Tools
1543 + hwloc-info is not only a synonym of lstopo -s anymore, it also
1544 dumps information about objects given on the command-line.
1545 * Documentation
1546 + Add a section "Existing components and plugins".
1547 + Add a list of common OS devices in section "Software devices".
1548 + Add a new FAQ entry "Why is lstopo slow?" about lstopo slowness
1549 issues because of GPUs.
1550 + Clarify the documentation of inline helpers in hwloc/myriexpress.h
1551 and hwloc/openfabrics-verbs.h.
1552 * Misc
1553 + Improve cache detection on AIX.
1554 + The HWLOC_COMPONENTS variable now excludes the components whose
1555 names are prefixed with '-'.
1556 + lstopo --ignore PU now works when displaying the topology in
1557 graphical and textual mode (not when exporting to XML).
1558 + Make sure I/O options always appear in lstopo usage, not only when
1559 using pciutils/libpci.
1560 + Remove some unneeded Linux specific includes from some interoperability
1561 headers.
1562 + Fix some inconsistencies in hwloc-distrib and hwloc-assembler-remote
1563 manpages. Thanks to Guy Streeter for the report.
1564 + Fix a memory leak on AIX when getting memory binding.
1565 + Fix many small memory leaks on Linux.
1566 + The `libpci' component is now called `pci' but the old name is still
1567 accepted in the HWLOC_COMPONENTS variable for backward compatibility.
1568
1569
1570 Version 1.6.2
1571 -------------
1572 * Use libpciaccess instead of pciutils/libpci by default for I/O discovery.
1573 pciutils/libpci is only used if --enable-libpci is given to configure
1574 because its GPL license may taint hwloc. See the Installation section
1575 in the documentation for details.
1576 * Fix get_cpubind on Solaris when bound to a single PU with
1577 processor_bind(). Thanks to Eugene Loh for reporting the problem
1578 and providing a patch.
1579
1580
1581 Version 1.6.1
1582 -------------
1583 * Fix some crash or buggy detection in the x86 backend when Linux
1584 cgroups/cpusets restrict the available CPUs.
1585 * Fix the pkg-config output with --libs --static.
1586 Thanks to Erik Schnetter for reporting one of the problems.
1587 * Fix the output of hwloc-calc -H --hierarchical when using logical
1588 indexes in the output.
1589 * Calling hwloc_topology_load() multiple times on the same topology
1590 is officially deprecated. hwloc will warn in such cases.
1591 * Add some documentation about existing plugins/components, package
1592 dependencies, and I/O devices specification on the command-line.
1593
1594
1595 Version 1.6.0
1596 -------------
1597 * Major changes
1598 + Reorganize the backend infrastructure to support dynamic selection
1599 of components and dynamic loading of plugins. For details, see the
1600 new documentation section Components and plugins.
1601 - The HWLOC_COMPONENTS variable lets one replace the default discovery
1602 components.
1603 - Dynamic loading of plugins may be enabled with --enable-plugins
1604 (except on AIX and Windows). It will build libxml2 and libpci
1605 support as separated modules. This helps reducing the dependencies
1606 of the core hwloc library when distributed as a binary package.
1607 * Backends
1608 + Add CPUModel detection on Darwin and x86/FreeBSD.
1609 Thanks to Robin Scher for providing ways to implement this.
1610 + The x86 backend now adds CPUModel info attributes to socket objects
1611 created by other backends that do not natively support this attribute.
1612 + Fix detection on FreeBSD in case of cpuset restriction. Thanks to
1613 Sebastian Kuzminsky for reporting the problem.
1614 * XML
1615 + Add hwloc_topology_set_userdata_import/export_callback(),
1616 hwloc_export_obj_userdata() and _userdata_base64() to let
1617 applications specify how to save/restore the custom data they placed
1618 in the userdata private pointer field of hwloc objects.
1619 * Tools
1620 + Add hwloc-annotate program to add string info attributes to XML
1621 topologies.
1622 + Add --pid-cmd to hwloc-ps to append the output of a command to each
1623 PID line. May be used for showing Open MPI process ranks, see the
1624 hwloc-ps(1) manpage for details.
1625 + hwloc-bind now exits with an error if binding fails; the executable
1626 is not launched unless binding suceeeded or --force was given.
1627 + Add --quiet to hwloc-calc and hwloc-bind to hide non-fatal error
1628 messages.
1629 + Fix command-line pid support in windows tools.
1630 + All programs accept --verbose as a synonym to -v.
1631 * Misc
1632 + Fix some DIR descriptor leaks on Linux.
1633 + Fix I/O device lists when some were filtered out after a XML import.
1634 + Fix the removal of I/O objects when importing a I/O-enabled XML topology
1635 without any I/O topology flag.
1636 + When merging objects with HWLOC_IGNORE_TYPE_KEEP_STRUCTURE or
1637 lstopo --merge, compare object types before deciding which one of two
1638 identical object to remove (e.g. keep sockets in favor of caches).
1639 + Add some GUID- and LID-related info attributes to OpenFabrics
1640 OS devices.
1641 + Only add CPUType socket attributes on Solaris/Sparc. Other cases
1642 don't report reliable information (Solaris/x86), and a replacement
1643 is available as the Architecture string info in the Machine object.
1644 + Add missing Backend string info on Solaris in most cases.
1645 + Document object attributes and string infos in a new Attributes
1646 section in the documentation.
1647 + Add a section about Synthetic topologies in the documentation.
1648
1649
1650 Version 1.5.2 (some of these changes are in 1.6.2 but not in 1.6)
1651 -------------
1652 * Use libpciaccess instead of pciutils/libpci by default for I/O discovery.
1653 pciutils/libpci is only used if --enable-libpci is given to configure
1654 because its GPL license may taint hwloc. See the Installation section
1655 in the documentation for details.
1656 * Fix get_cpubind on Solaris when bound to a single PU with
1657 processor_bind(). Thanks to Eugene Loh for reporting the problem
1658 and providing a patch.
1659 * Fix some DIR descriptor leaks on Linux.
1660 * Fix I/O device lists when some were filtered out after a XML import.
1661 * Add missing Backend string info on Solaris in most cases.
1662 * Fix the removal of I/O objects when importing a I/O-enabled XML topology
1663 without any I/O topology flag.
1664 * Fix the output of hwloc-calc -H --hierarchical when using logical
1665 indexes in the output.
1666 * Fix the pkg-config output with --libs --static.
1667 Thanks to Erik Schnetter for reporting one of the problems.
1668
1669
1670 Version 1.5.1
1671 -------------
1672 * Fix block OS device detection on Linux kernel 3.3 and later.
1673 Thanks to Guy Streeter for reporting the problem and testing the fix.
1674 * Fix the cpuid code in the x86 backend (for FreeBSD). Thanks to
1675 Sebastian Kuzminsky for reporting problems and testing patches.
1676 * Fix 64bit detection on FreeBSD.
1677 * Fix some corner cases in the management of the thissystem flag with
1678 respect to topology flags and environment variables.
1679 * Fix some corner cases in command-line parsing checks in hwloc-distrib
1680 and hwloc-distances.
1681 * Make sure we do not miss some block OS devices on old Linux kernels
1682 when a single PCI device has multiple IDE hosts/devices behind it.
1683 * Do not disable I/O devices or instruction caches in hwloc-assembler output.
1684
1685
1686 Version 1.5.0
1687 -------------
1688 * Backends
1689 + Do not limit the number of processors to 1024 on Solaris anymore.
1690 + Gather total machine memory on FreeBSD. Thanks to Cyril Roelandt.
1691 + XML topology files do not depend on the locale anymore. Float numbers
1692 such as NUMA distances or PCI link speeds now always use a dot as a
1693 decimal separator.
1694 + Add instruction caches detection on Linux, AIX, Windows and Darwin.
1695 + Add get_last_cpu_location() support for the current thread on AIX.
1696 + Support binding on AIX when threads or processes were bound with
1697 bindprocessor(). Thanks to Hendryk Bockelmann for reporting the issue
1698 and testing patches, and to Farid Parpia for explaining the binding
1699 interfaces.
1700 + Improve AMD topology detection in the x86 backend (for FreeBSD) using
1701 the topoext feature.
1702 * API
1703 + Increase HWLOC_API_VERSION to 0x00010500 so that API changes may be
1704 detected at build-time.
1705 + Add a cache type attribute describind Data, Instruction and Unified
1706 caches. Caches with different types but same depth (for instance L1d
1707 and L1i) are placed on different levels.
1708 + Add hwloc_get_cache_type_depth() to retrieve the hwloc level depth of
1709 of the given cache depth and type, for instance L1i or L2.
1710 It helps disambiguating the case where hwloc_get_type_depth() returns
1711 HWLOC_TYPE_DEPTH_MULTIPLE.
1712 + Instruction caches are ignored unless HWLOC_TOPOLOGY_FLAG_ICACHES is
1713 passed to hwloc_topology_set_flags() before load.
1714 + Add hwloc_ibv_get_device_osdev_by_name() OpenFabrics helper in
1715 openfabrics-verbs.h to find the hwloc OS device object corresponding to
1716 an OpenFabrics device.
1717 * Tools
1718 + Add lstopo-no-graphics, a lstopo built without graphical support to
1719 avoid dependencies on external libraries such as Cairo and X11. When
1720 supported, graphical outputs are only available in the original lstopo
1721 program.
1722 - Packagers splitting lstopo and lstopo-no-graphics into different
1723 packages are advised to use the alternatives system so that lstopo
1724 points to the best available binary.
1725 + Instruction caches are enabled in lstopo by default. Use --no-icaches
1726 to disable them.
1727 + Add -t/--threads to show threads in hwloc-ps.
1728 * Removal of obsolete components
1729 + Remove the old cpuset interface (hwloc/cpuset.h) which is deprecated and
1730 superseded by the bitmap API (hwloc/bitmap.h) since v1.1.
1731 hwloc_cpuset and nodeset types are still defined, but all hwloc_cpuset_*
1732 compatibility wrappers are now gone.
1733 + Remove Linux libnuma conversion helpers for the deprecated and
1734 broken nodemask_t interface.
1735 + Remove support for "Proc" type name, it was superseded by "PU" in v1.0.
1736 + Remove hwloc-mask symlinks, it was replaced by hwloc-calc in v1.0.
1737 * Misc
1738 + Fix PCIe 3.0 link speed computation.
1739 + Non-printable characters are dropped from strings during XML export.
1740 + Fix importing of escaped characters with the minimalistic XML backend.
1741 + Assert hwloc_is_thissystem() in several I/O related helpers.
1742 + Fix some memory leaks in the x86 backend for FreeBSD.
1743 + Minor fixes to ease native builds on Windows.
1744 + Limit the number of retries when operating on all threads within a
1745 process on Linux if the list of threads is heavily getting modified.
1746
1747
1748 Version 1.4.3
1749 -------------
1750 * This release is only meant to fix the pciutils license issue when upgrading
1751 to hwloc v1.5 or later is not possible. It contains several other minor
1752 fixes but ignores many of them that are only in v1.5 or later.
1753 * Use libpciaccess instead of pciutils/libpci by default for I/O discovery.
1754 pciutils/libpci is only used if --enable-libpci is given to configure
1755 because its GPL license may taint hwloc. See the Installation section
1756 in the documentation for details.
1757 * Fix PCIe 3.0 link speed computation.
1758 * Fix importing of escaped characters with the minimalistic XML backend.
1759 * Fix a memory leak in the x86 backend.
1760
1761
1762 Version 1.4.2
1763 -------------
1764 * Fix build on Solaris 9 and earlier when fabsf() is not a compiler
1765 built-in. Thanks to Igor Galić for reporting the problem.
1766 * Fix support for more than 32 processors on Windows. Thanks to Hartmut
1767 Kaiser for reporting the problem.
1768 * Fix process-wide binding and cpulocation routines on Linux when some
1769 threads disappear in the meantime. Thanks to Vlad Roubtsov for reporting
1770 the issue.
1771 * Make installed scripts executable. Thanks to Jirka Hladky for reporting
1772 the problem.
1773 * Fix libtool revision management when building for Windows. This fix was
1774 also released as hwloc v1.4.1.1 Windows builds. Thanks to Hartmut Kaiser
1775 for reporting the problem.
1776 * Fix the __hwloc_inline keyword in public headers when compiling with a
1777 C++ compiler.
1778 * Add Port info attribute to network OS devices inside OpenFabrics PCI
1779 devices so as to identify which interface corresponds to which port.
1780 * Document requirements for interoperability helpers: I/O devices discovery
1781 is required for some of them; the topology must match the current host
1782 for most of them.
1783
1784
1785 Version 1.4.1 (contains all 1.3.2 changes)
1786 -------------
1787 * Fix hwloc_alloc_membind, thanks Karl Napf for reporting the issue.
1788 * Fix memory leaks in some get_membind() functions.
1789 * Fix helpers converting from Linux libnuma to hwloc (hwloc/linux-libnuma.h)
1790 in case of out-of-order NUMA node ids.
1791 * Fix some overzealous assertions in the distance grouping code.
1792 * Workaround BIOS reporting empty I/O locality in CUDA and OpenFabrics
1793 helpers on Linux. Thanks to Albert Solernou for reporting the problem.
1794 * Install a valgrind suppressions file hwloc-valgrind.supp (see the FAQ).
1795 * Fix memory binding documentation. Thanks to Karl Napf for reporting the
1796 issues.
1797
1798
1799 Version 1.4.0 (does not contain all 1.3.2 changes)
1800 -------------
1801 * Major features
1802 + Add "custom" interface and "assembler" tools to build multi-node
1803 topology. See the Multi-node Topologies section in the documentation
1804 for details.
1805 * Interface improvements
1806 + Add symmetric_subtree object attribute to ease assumptions when consulting
1807 regular symmetric topologies.
1808 + Add a CPUModel and CPUType info attribute to Socket objects on Linux
1809 and Solaris.
1810 + Add hwloc_get_obj_index_inside_cpuset() to retrieve the "logical" index
1811 of an object within a subtree of the topology.
1812 + Add more NVIDIA CUDA helpers in cuda.h and cudart.h to find hwloc objects
1813 corresponding to CUDA devices.
1814 * Discovery improvements
1815 + Add a group object above partial distance matrices to make sure
1816 the matrices are available in the final topology, except when this
1817 new object would contradict the existing hierarchy.
1818 + Grouping by distances now also works when loading from XML.
1819 + Fix some corner cases in object insertion, for instance when dealing
1820 with NUMA nodes without any CPU.
1821 * Backends
1822 + Implement hwloc_get_area_membind() on Linux.
1823 + Honor I/O topology flags when importing from XML.
1824 + Further improve XML-related error checking and reporting.
1825 + Hide synthetic topology error messages unless HWLOC_SYNTHETIC_VERBOSE=1.
1826 * Tools
1827 + Add synthetic exporting of symmetric topologies to lstopo.
1828 + lstopo --horiz and --vert can now be applied to some specific object types.
1829 + lstopo -v -p now displays distance matrices with physical indexes.
1830 + Add hwloc-distances utility to list distances.
1831 * Documentation
1832 + Fix and/or document the behavior of most inline functions in hwloc/helper.h
1833 when the topology contains some I/O or Misc objects.
1834 + Backend documentation enhancements.
1835 * Bug fixes
1836 + Fix missing last bit in hwloc_linux_get_thread_cpubind().
1837 Thanks to Carolina Gómez-Tostón Gutiérrez for reporting the issue.
1838 + Fix FreeBSD build without cpuid support.
1839 + Fix several Windows build issues.
1840 + Fix inline keyword definition in public headers.
1841 + Fix dependencies in the embedded library.
1842 + Improve visibility support detection. Thanks to Dave Love for providing
1843 the patch.
1844 + Remove references to internal symbols in the tools.
1845
1846
1847 Version 1.3.3
1848 -------------
1849 * This release is only meant to fix the pciutils license issue when upgrading
1850 to hwloc v1.4 or later is not possible. It contains several other minor
1851 fixes but ignores many of them that are only in v1.4 or later.
1852 * Use libpciaccess instead of pciutils/libpci by default for I/O discovery.
1853 pciutils/libpci is only used if --enable-libpci is given to configure
1854 because its GPL license may taint hwloc. See the Installation section
1855 in the documentation for details.
1856
1857
1858 Version 1.3.2
1859 -------------
1860 * Fix missing last bit in hwloc_linux_get_thread_cpubind().
1861 Thanks to Carolina Gómez-Tostón Gutiérrez for reporting the issue.
1862 * Fix build with -mcmodel=medium. Thanks to Devendar Bureddy for reporting
1863 the issue.
1864 * Fix build with Solaris Studio 12 compiler when XML is disabled.
1865 Thanks to Paul H. Hargrove for reporting the problem.
1866 * Fix installation with old GNU sed, for instance on Red Hat 8.
1867 Thanks to Paul H. Hargrove for reporting the problem.
1868 * Fix PCI locality when Linux cgroups restrict the available CPUs.
1869 * Fix floating point issue when grouping by distance on mips64 architecture.
1870 Thanks to Paul H. Hargrove for reporting the problem.
1871 * Fix conversion from/to Linux libnuma when some NUMA nodes have no memory.
1872 * Fix support for gccfss compilers with broken ffs() support. Thanks to
1873 Paul H. Hargrove for reporting the problem and providing a patch.
1874 * Fix FreeBSD build without cpuid support.
1875 * Fix several Windows build issues.
1876 * Fix inline keyword definition in public headers.
1877 * Fix dependencies in the embedded library.
1878 * Detect when a compiler such as xlc may not report compile errors
1879 properly, causing some configure checks to be wrong. Thanks to
1880 Paul H. Hargrove for reporting the problem and providing a patch.
1881 * Improve visibility support detection. Thanks to Dave Love for providing
1882 the patch.
1883 * Remove references to internal symbols in the tools.
1884 * Fix installation on systems with limited command-line size.
1885 Thanks to Paul H. Hargrove for reporting the problem.
1886 * Further improve XML-related error checking and reporting.
1887
1888
1889 Version 1.3.1
1890 -------------
1891 * Fix pciutils detection with pkg-config when not installed in standard
1892 directories.
1893 * Fix visibility options detection with the Solaris Studio compiler.
1894 Thanks to Igor Galić and Terry Dontje for reporting the problems.
1895 * Fix support for old Linux sched.h headers such as those found
1896 on Red Hat 8. Thanks to Paul H. Hargrove for reporting the problems.
1897 * Fix inline and attribute support for Solaris compilers. Thanks to
1898 Dave Love for reporting the problems.
1899 * Print a short summary at the end of the configure output. Thanks to
1900 Stefan Eilemann for the suggestion.
1901 * Add --disable-libnuma configure option to disable libnuma-based
1902 memory binding support on Linux. Thanks to Rayson Ho for the
1903 suggestion.
1904 * Make hwloc's configure script properly obey $PKG_CONFIG. Thanks to
1905 Nathan Phillip Brink for raising the issue.
1906 * Silence some harmless pciutils warnings, thanks to Paul H. Hargrove
1907 for reporting the problem.
1908 * Fix the documentation with respect to hwloc_pid_t and hwloc_thread_t
1909 being either pid_t and pthread_t on Unix, or HANDLE on Windows.
1910
1911
1912 Version 1.3.0
1913 -------------
1914 * Major features
1915 + Add I/O devices and bridges to the topology using the pciutils
1916 library. Only enabled after setting the relevant flag with
1917 hwloc_topology_set_flags() before hwloc_topology_load(). See the
1918 I/O Devices section in the documentation for details.
1919 * Discovery improvements
1920 + Add associativity to the cache attributes.
1921 + Add support for s390/z11 "books" on Linux.
1922 + Add the HWLOC_GROUPING_ACCURACY environment variable to relax
1923 distance-based grouping constraints. See the Environment Variables
1924 section in the documentation for details about grouping behavior
1925 and configuration.
1926 + Allow user-given distance matrices to remove or replace those
1927 discovered by the OS backend.
1928 * XML improvements
1929 + XML is now always supported: a minimalistic custom import/export
1930 code is used when libxml2 is not available. It is only guaranteed
1931 to read XML files generated by hwloc.
1932 + hwloc_topology_export_xml() and export_xmlbuffer() now return an
1933 integer.
1934 + Add hwloc_free_xmlbuffer() to free the buffer allocated by
1935 hwloc_topology_export_xmlbuffer().
1936 + Hide XML topology error messages unless HWLOC_XML_VERBOSE=1.
1937 * Minor API updates
1938 + Add hwloc_obj_add_info to customize object info attributes.
1939 * Tools
1940 + lstopo now displays I/O devices by default. Several options are
1941 added to configure the I/O discovery.
1942 + hwloc-calc and hwloc-bind now accept I/O devices as input.
1943 + Add --restrict option to hwloc-calc and hwloc-distribute.
1944 + Add --sep option to change the output field separator in hwloc-calc.
1945 + Add --whole-system option to hwloc-ps.
1946
1947
1948 Version 1.2.2
1949 -------------
1950 * Fix build on AIX 5.2, thanks Utpal Kumar Ray for the report.
1951 * Fix XML import of very large page sizes or counts on 32bits platform,
1952 thanks to Karsten Hopp for the RedHat ticket.
1953 * Fix crash when administrator limitations such as Linux cgroup require
1954 to restrict distance matrices. Thanks to Ake Sandgren for reporting the
1955 problem.
1956 * Fix the removal of objects such as AMD Magny-Cours dual-node sockets
1957 in case of administrator restrictions.
1958 * Improve error reporting and messages in case of wrong synthetic topology
1959 description.
1960 * Several other minor internal fixes and documentation improvements.
1961
1962
1963 Version 1.2.1
1964 -------------
1965 * Improve support of AMD Bulldozer "Compute-Unit" modules by detecting
1966 logical processors with different core IDs on Linux.
1967 * Fix hwloc-ps crash when listing processes from another Linux cpuset.
1968 Thanks to Carl Smith for reporting the problem.
1969 * Fix build on AIX and Solaris. Thanks to Carl Smith and Andreas Kupries
1970 for reporting the problems.
1971 * Fix cache size detection on Darwin. Thanks to Erkcan Özcan for reporting
1972 the problem.
1973 * Make configure fail if --enable-xml or --enable-cairo is given and
1974 proper support cannot be found. Thanks to Andreas Kupries for reporting
1975 the XML problem.
1976 * Fix spurious L1 cache detection on AIX. Thanks to Hendryk Bockelmann
1977 for reporting the problem.
1978 * Fix hwloc_get_last_cpu_location(THREAD) on Linux. Thanks to Gabriele
1979 Fatigati for reporting the problem.
1980 * Fix object distance detection on Solaris.
1981 * Add pthread_self weak symbol to ease static linking.
1982 * Minor documentation fixes.
1983
1984
1985 Version 1.2.0
1986 -------------
1987 * Major features
1988 + Expose latency matrices in the API as an array of distance structures
1989 within objects. Add several helpers to find distances.
1990 + Add hwloc_topology_set_distance_matrix() and environment variables
1991 to provide a matrix of distances between a given set of objects.
1992 + Add hwloc_get_last_cpu_location() and hwloc_get_proc_last_cpu_location()
1993 to retrieve the processors where a process or thread recently ran.
1994 - Add the corresponding --get-last-cpu-location option to hwloc-bind.
1995 + Add hwloc_topology_restrict() to restrict an existing topology to a
1996 given cpuset.
1997 - Add the corresponding --restrict option to lstopo.
1998 * Minor API updates
1999 + Add hwloc_bitmap_list_sscanf/snprintf/asprintf to convert between bitmaps
2000 and strings such as 4-5,7-9,12,15-
2001 + hwloc_bitmap_set/clr_range() now support infinite ranges.
2002 + Clarify the difference between inserting Misc objects by cpuset or by
2003 parent.
2004 + hwloc_insert_misc_object_by_cpuset() now returns NULL in case of error.
2005 * Discovery improvements
2006 + x86 backend (for freebsd): add x2APIC support
2007 + Support standard device-tree phandle, to get better support on e.g. ARM
2008 systems providing it.
2009 + Detect cache size on AIX. Thanks Christopher and IBM.
2010 + Improve grouping to support asymmetric topologies.
2011 * Tools
2012 + Command-line tools now support "all" and "root" special locations
2013 consisting in the entire topology, as well as type names with depth
2014 attributes such as L2 or Group4.
2015 + hwloc-calc improvements:
2016 - Add --number-of/-N option to report the number of objects of a given
2017 type or depth.
2018 - -I is now equivalent to --intersect for listing the indexes of
2019 objects of a given type or depth that intersects the input.
2020 - Add -H to report the output as a hierarchical combination of types
2021 and depths.
2022 + Add --thissystem to lstopo.
2023 + Add lstopo-win, a console-less lstopo variant on Windows.
2024 * Miscellaneous
2025 + Remove C99 usage from code base.
2026 + Rename hwloc-gather-topology.sh into hwloc-gather-topology
2027 + Fix AMD cache discovery on freebsd when there is no L3 cache, thanks
2028 Andriy Gapon for the fix.
2029
2030
2031 Version 1.1.2
2032 -------------
2033 * Fix a segfault in the distance-based grouping code when some objects
2034 are not placed in any group. Thanks to Bernd Kallies for reporting
2035 the problem and providing a patch.
2036 * Fix the command-line parsing of hwloc-bind --mempolicy interleave.
2037 Thanks to Guy Streeter for reporting the problem.
2038 * Stop truncating the output in hwloc_obj_attr_snprintf() and in the
2039 corresponding lstopo output. Thanks to Guy Streeter for reporting the
2040 problem.
2041 * Fix object levels ordering in synthetic topologies.
2042 * Fix potential incoherency between device tree and kernel information,
2043 when SMT is disabled on Power machines.
2044 * Fix and document the behavior of hwloc_topology_set_synthetic() in case
2045 of invalid argument. Thanks to Guy Streeter for reporting the problem.
2046 * Add some verbose error message reporting when it looks like the OS
2047 gives erroneous information.
2048 * Do not include unistd.h and stdint.h in public headers on Windows.
2049 * Move config.h files into their own subdirectories to avoid name
2050 conflicts when AC_CONFIG_HEADERS adds -I's for them.
2051 * Remove the use of declaring variables inside "for" loops.
2052 * Some other minor fixes.
2053 * Many minor documentation fixes.
2054
2055
2056 Version 1.1.1
2057 -------------
2058 * Add hwloc_get_api_version() which returns the version of hwloc used
2059 at runtime. Thanks to Guy Streeter for the suggestion.
2060 * Fix the number of hugepages reported for NUMA nodes on Linux.
2061 * Fix hwloc_bitmap_to_ulong() right after allocating the bitmap.
2062 Thanks to Bernd Kallies for reporting the problem.
2063 * Fix hwloc_bitmap_from_ith_ulong() to properly zero the first ulong.
2064 Thanks to Guy Streeter for reporting the problem.
2065 * Fix hwloc_get_membind_nodeset() on Linux.
2066 Thanks to Bernd Kallies for reporting the problem and providing a patch.
2067 * Fix some file descriptor leaks in the Linux discovery.
2068 * Fix the minimum width of NUMA nodes, caches and the legend in the graphical
2069 lstopo output. Thanks to Jirka Hladky for reporting the problem.
2070 * Various fixes to bitmap conversion from/to taskset-strings.
2071 * Fix and document snprintf functions behavior when the buffer size is too
2072 small or zero. Thanks to Guy Streeter for reporting the problem.
2073 * Fix configure to avoid spurious enabling of the cpuid backend.
2074 Thanks to Tim Anderson for reporting the problem.
2075 * Cleanup error management in hwloc-gather-topology.sh.
2076 Thanks to Jirka Hladky for reporting the problem and providing a patch.
2077 * Add a manpage and usage for hwloc-gather-topology.sh on Linux.
2078 Thanks to Jirka Hladky for providing a patch.
2079 * Memory binding documentation enhancements.
2080
2081
2082 Version 1.1.0
2083 -------------
2084
2085 * API
2086 + Increase HWLOC_API_VERSION to 0x00010100 so that API changes may be
2087 detected at build-time.
2088 + Add a memory binding interface.
2089 + The cpuset API (hwloc/cpuset.h) is now deprecated. It is replaced by
2090 the bitmap API (hwloc/bitmap.h) which offers the same features with more
2091 generic names since it applies to CPU sets, node sets and more.
2092 Backward compatibility with the cpuset API and ABI is still provided but
2093 it will be removed in a future release.
2094 Old types (hwloc_cpuset_t, ...) are still available as a way to clarify
2095 what kind of hwloc_bitmap_t each API function manipulates.
2096 Upgrading to the new API only requires to replace hwloc_cpuset_ function
2097 calls with the corresponding hwloc_bitmap_ calls, with the following
2098 renaming exceptions:
2099 - hwloc_cpuset_cpu -> hwloc_bitmap_only
2100 - hwloc_cpuset_all_but_cpu -> hwloc_bitmap_allbut
2101 - hwloc_cpuset_from_string -> hwloc_bitmap_sscanf
2102 + Add an `infos' array in each object to store couples of info names and
2103 values. It enables generic storage of things like the old dmi board infos
2104 that were previously stored in machine specific attributes.
2105 + Add linesize cache attribute.
2106 * Features
2107 + Bitmaps (and thus CPU sets and node sets) are dynamically (re-)allocated,
2108 the maximal number of CPUs (HWLOC_NBMAXCPUS) has been removed.
2109 + Improve the distance-based grouping code to better support irregular
2110 distance matrices.
2111 + Add support for device-tree to get cache information (useful on Power
2112 architectures).
2113 * Helpers
2114 + Add NVIDIA CUDA helpers in cuda.h and cudart.h to ease interoperability
2115 with CUDA Runtime and Driver APIs.
2116 + Add Myrinet Express helper in myriexpress.h to ease interoperability.
2117 * Tools
2118 + lstopo now displays physical/OS indexes by default in graphical mode
2119 (use -l to switch back to logical indexes). The textual output still uses
2120 logical by default (use -p to switch to physical indexes).
2121 + lstopo prefixes logical indexes with `L#' and physical indexes with `P#'.
2122 Physical indexes are also printed as `P#N' instead of `phys=N' within
2123 object attributes (in parentheses).
2124 + Add a legend at the bottom of the lstopo graphical output, use --no-legend
2125 to remove it.
2126 + Add hwloc-ps to list process' bindings.
2127 + Add --membind and --mempolicy options to hwloc-bind.
2128 + Improve tools command-line options by adding a generic --input option
2129 (and more) which replaces the old --xml, --synthetic and --fsys-root.
2130 + Cleanup lstopo output configuration by adding --output-format.
2131 + Add --intersect in hwloc-calc, and replace --objects with --largest.
2132 + Add the ability to work on standard input in hwloc-calc.
2133 + Add --from, --to and --at in hwloc-distrib.
2134 + Add taskset-specific functions and command-line tools options to
2135 manipulate CPU set strings in the format of the taskset program.
2136 + Install hwloc-gather-topology.sh on Linux.
2137
2138
2139 Version 1.0.3
2140 -------------
2141
2142 * Fix support for Linux cpuset when emulated by a cgroup mount point.
2143 * Remove unneeded runtime dependency on libibverbs.so in the library and
2144 all utils programs.
2145 * Fix hwloc_cpuset_to_linux_libnuma_ulongs in case of non-linear OS-indexes
2146 for NUMA nodes.
2147 * lstopo now displays physical/OS indexes by default in graphical mode
2148 (use -l to switch back to logical indexes). The textual output still uses
2149 logical by default (use -p to switch to physical indexes).
2150
2151
2152 Version 1.0.2
2153 -------------
2154
2155 * Public headers can now be included directly from C++ programs.
2156 * Solaris fix for non-contiguous cpu numbers. Thanks to Rolf vandeVaart for
2157 reporting the issue.
2158 * Darwin 10.4 fix. Thanks to Olivier Cessenat for reporting the issue.
2159 * Revert 1.0.1 patch that ignored sockets with unknown ID values since it
2160 only slightly helped POWER7 machines with old Linux kernels while it
2161 prevents recent kernels from getting the complete POWER7 topology.
2162 * Fix hwloc_get_common_ancestor_obj().
2163 * Remove arch-specific bits in public headers.
2164 * Some fixes in the lstopo graphical output.
2165 * Various man page clarifications and minor updates.
2166
2167
2168 Version 1.0.1
2169 -------------
2170
2171 * Various Solaris fixes. Thanks to Yannick Martin for reporting the issue.
2172 * Fix "non-native" builds on x86 platforms (e.g., when building 32
2173 bit executables with compilers that natively build 64 bit).
2174 * Ignore sockets with unknown ID values (which fixes issues on POWER7
2175 machines). Thanks to Greg Bauer for reporting the issue.
2176 * Various man page clarifications and minor updates.
2177 * Fixed memory leaks in hwloc_setup_group_from_min_distance_clique().
2178 * Fix cache type filtering on MS Windows 7. Thanks to Αλέξανδρος
2179 Παπαδογιαννάκ for reporting the issue.
2180 * Fixed warnings when compiling with -DNDEBUG.
2181
2182
2183 Version 1.0.0
2184 -------------
2185
2186 * The ABI of the library has changed.
2187 * Backend updates
2188 + Add FreeBSD support.
2189 + Add x86 cpuid based backend.
2190 + Add Linux cgroup support to the Linux cpuset code.
2191 + Support binding of entire multithreaded process on Linux.
2192 + Fix and enable Group support in Windows.
2193 + Cleanup XML export/import.
2194 * Objects
2195 + HWLOC_OBJ_PROC is renamed into HWLOC_OBJ_PU for "Processing Unit",
2196 its stringified type name is now "PU".
2197 + Use new HWLOC_OBJ_GROUP objects instead of MISC when grouping
2198 objects according to NUMA distances or arbitrary OS aggregation.
2199 + Rework memory attributes.
2200 + Add different cpusets in each object to specify processors that
2201 are offline, unavailable, ...
2202 + Cleanup the storage of object names and DMI infos.
2203 * Features
2204 + Add support for looking up specific PID topology information.
2205 + Add hwloc_topology_export_xml() to export the topology in a XML file.
2206 + Add hwloc_topology_get_support() to retrieve the supported features
2207 for the current topology context.
2208 + Support non-SYSTEM object as the root of the tree, use MACHINE in
2209 most common cases.
2210 + Add hwloc_get_*cpubind() routines to retrieve the current binding
2211 of processes and threads.
2212 * API
2213 + Add HWLOC_API_VERSION to help detect the currently used API version.
2214 + Add missing ending "e" to *compare* functions.
2215 + Add several routines to emulate PLPA functions.
2216 + Rename and rework the cpuset and/or/xor/not/clear operators to output
2217 their result in a dedicated argument instead of modifying one input.
2218 + Deprecate hwloc_obj_snprintf() in favor of hwloc_obj_type/attr_snprintf().
2219 + Clarify the use of parent and ancestor in the API, do not use father.
2220 + Replace hwloc_get_system_obj() with hwloc_get_root_obj().
2221 + Return -1 instead of HWLOC_OBJ_TYPE_MAX in the API since the latter
2222 isn't public.
2223 + Relax constraints in hwloc_obj_type_of_string().
2224 + Improve displaying of memory sizes.
2225 + Add 0x prefix to cpuset strings.
2226 * Tools
2227 + lstopo now displays logical indexes by default, use --physical to
2228 revert back to OS/physical indexes.
2229 + Add colors in the lstopo graphical outputs to distinguish between online,
2230 offline, reserved, ... objects.
2231 + Extend lstopo to show cpusets, filter objects by type, ...
2232 + Renamed hwloc-mask into hwloc-calc which supports many new options.
2233 * Documentation
2234 + Add a hwloc(7) manpage containing general information.
2235 + Add documentation about how to switch from PLPA to hwloc.
2236 + Cleanup the distributed documentation files.
2237 * Miscellaneous
2238 + Many compilers warning fixes.
2239 + Cleanup the ABI by using the visibility attribute.
2240 + Add project embedding support.
2241
2242
2243 Version 0.9.4 (unreleased)
2244 -------------
2245
2246 * Fix reseting colors to normal in lstopo -.txt output.
2247 * Fix Linux pthread_t binding error report.
2248
2249
2250 Version 0.9.3
2251 -------------
2252
2253 * Fix autogen.sh to work with Autoconf 2.63.
2254 * Fix various crashes in particular conditions:
2255 - xml files with root attributes
2256 - offline CPUs
2257 - partial sysfs support
2258 - unparseable /proc/cpuinfo
2259 - ignoring NUMA level while Misc level have been generated
2260 * Tweak documentation a bit
2261 * Do not require the pthread library for binding the current thread on Linux
2262 * Do not erroneously consider the sched_setaffinity prototype is the old version
2263 when there is actually none.
2264 * Fix _syscall3 compilation on archs for which we do not have the
2265 sched_setaffinity system call number.
2266 * Fix AIX binding.
2267 * Fix libraries dependencies: now only lstopo depends on libtermcap, fix
2268 binutils-gold link
2269 * Have make check always build and run hwloc-hello.c
2270 * Do not limit size of a cpuset.
2271
2272
2273 Version 0.9.2
2274 -------------
2275
2276 * Trivial documentation changes.
2277
2278
2279 Version 0.9.1
2280 -------------
2281
2282 * Re-branded to "hwloc" and moved to the Open MPI project, relicensed under the
2283 BSD license.
2284 * The prefix of all functions and tools is now hwloc, and some public
2285 functions were also renamed for real.
2286 * Group NUMA nodes into Misc objects according to their physical distance
2287 that may be reported by the OS/BIOS.
2288 May be ignored by setting HWLOC_IGNORE_DISTANCES=1 in the environment.
2289 * Ignore offline CPUs on Solaris.
2290 * Improved binding support on AIX.
2291 * Add HP-UX support.
2292 * CPU sets are now allocated/freed dynamically.
2293 * Add command line options to tune the lstopo graphical output, add
2294 semi-graphical textual output
2295 * Extend topobind to support multiple cpusets or objects on the command
2296 line as topomask does.
2297 * Add an Infiniband-specific helper hwloc/openfabrics-verbs.h to retrieve
2298 the physical location of IB devices.
2299
2300
2301 Version 0.9 (formerly named "libtopology")
2302 -----------
2303
2304 * First release.