hwloc 2.11.0 final

Signed-off-by: Brice Goglin <[email protected]>

index.php

@@ -92,9 +92,9 @@ function pr($name, $url, $comma) {
 news("Open MPI v4.1.6 released",
      "Bug fix release",
      "https://www.mail-archive.com/[email protected]/msg00158.html");
-news("hwloc 2.10.0",
+news("hwloc 2.11.0",
      "Major release",
-     "https://www.mail-archive.com/[email protected]/msg00164.html");
+     "https://www.mail-archive.com/[email protected]/msg00166.html");
 ?>
 </td>
 </tr>

projects/hwloc/doc/index.php

@@ -36,7 +36,7 @@ function print_docs($desc, $letterpdf, $a4pdf, $html) {
 
 #########################################################
 
-$versions = array();
+$versions = array("v2.11.0");
 $first = 1;
 foreach ($versions as $key => $v) {
 #    print_docs("Release $v (stable" . (!$first ? ", old" : "") . ")",

projects/hwloc/doc/v2.11.0rc1/a00164.php → projects/hwloc/doc/v2.11.0/a00164.php

@@ -89,8 +89,7 @@
 
 <p>Kinds of distance matrices. </p>
 <p>The <code>kind</code> attribute of struct <a class="el" href="a00268.php" title="Matrix of distances between a set of objects.">hwloc_distances_s</a> is a OR'ed set of kinds.</p>
-<p>A kind of format HWLOC_DISTANCES_KIND_FROM_* specifies where the distance information comes from, if known.</p>
-<p>A kind of format HWLOC_DISTANCES_KIND_MEANS_* specifies whether values are latencies or bandwidths, if applicable. </p>
+<p>Each distance matrix may have only one kind among HWLOC_DISTANCES_KIND_FROM_* specifying where distance information comes from, and one kind among HWLOC_DISTANCES_KIND_MEANS_* specifying whether values are latencies or bandwidths. </p>
 <table class="fieldtable">
 <tr><th colspan="2">Enumerator</th></tr><tr><td class="fieldname"><a id="ggab1bb10d3adb85b52cdc6fe5a7f74f108a90dc38248c8d5392d4dd3e88f391e984" name="ggab1bb10d3adb85b52cdc6fe5a7f74f108a90dc38248c8d5392d4dd3e88f391e984"></a>HWLOC_DISTANCES_KIND_FROM_OS&#160;</td><td class="fielddoc"><p>These distances were obtained from the operating system or hardware. </p>
 </td></tr>

projects/hwloc/doc/v2.11.0rc1/a00166.php → projects/hwloc/doc/v2.11.0/a00166.php

@@ -63,7 +63,7 @@
 <div class="line">    err = <a class="code hl_function" href="a00166.php#ga1f5a29760ebb8f9af831e645315f553c">hwloc_distances_add_commit</a>(topology, handle, flags);</div>
 <div class="line">}</div>
 <div class="ttc" id="aa00166_php_ga1f5a29760ebb8f9af831e645315f553c"><div class="ttname"><a href="a00166.php#ga1f5a29760ebb8f9af831e645315f553c">hwloc_distances_add_commit</a></div><div class="ttdeci">int hwloc_distances_add_commit(hwloc_topology_t topology, hwloc_distances_add_handle_t handle, unsigned long flags)</div><div class="ttdoc">Commit a new distances structure.</div></div>
-<div class="ttc" id="aa00166_php_ga554a4c1e315265f961830e2b616e4989"><div class="ttname"><a href="a00166.php#ga554a4c1e315265f961830e2b616e4989">hwloc_distances_add_handle_t</a></div><div class="ttdeci">void * hwloc_distances_add_handle_t</div><div class="ttdoc">Handle to a new distances structure during its addition to the topology.</div><div class="ttdef"><b>Definition</b> distances.h:348</div></div>
+<div class="ttc" id="aa00166_php_ga554a4c1e315265f961830e2b616e4989"><div class="ttname"><a href="a00166.php#ga554a4c1e315265f961830e2b616e4989">hwloc_distances_add_handle_t</a></div><div class="ttdeci">void * hwloc_distances_add_handle_t</div><div class="ttdoc">Handle to a new distances structure during its addition to the topology.</div><div class="ttdef"><b>Definition</b> distances.h:347</div></div>
 <div class="ttc" id="aa00166_php_ga823d38fa8d21dc338497fb0f79c96704"><div class="ttname"><a href="a00166.php#ga823d38fa8d21dc338497fb0f79c96704">hwloc_distances_add_create</a></div><div class="ttdeci">hwloc_distances_add_handle_t hwloc_distances_add_create(hwloc_topology_t topology, const char *name, unsigned long kind, unsigned long flags)</div><div class="ttdoc">Create a new empty distances structure.</div></div>
 <div class="ttc" id="aa00166_php_ga8c9715481b0bce344c8a33c6e6a56469"><div class="ttname"><a href="a00166.php#ga8c9715481b0bce344c8a33c6e6a56469">hwloc_distances_add_values</a></div><div class="ttdeci">int hwloc_distances_add_values(hwloc_topology_t topology, hwloc_distances_add_handle_t handle, unsigned nbobjs, hwloc_obj_t *objs, hwloc_uint64_t *values, unsigned long flags)</div><div class="ttdoc">Specify the objects and values in a new empty distances structure.</div></div>
 </div><!-- fragment --><p> If <code>err</code> is <code>0</code> at the end, then addition was successful. </p>
@@ -99,7 +99,7 @@
 
 <p>Flags for adding a new distances to a topology. </p>
 <table class="fieldtable">
-<tr><th colspan="2">Enumerator</th></tr><tr><td class="fieldname"><a id="gga22428b6bab271411e3834e6b4ca22e37a7f6baba797d70538d03c9d13052c62ab" name="gga22428b6bab271411e3834e6b4ca22e37a7f6baba797d70538d03c9d13052c62ab"></a>HWLOC_DISTANCES_ADD_FLAG_GROUP&#160;</td><td class="fielddoc"><p>Try to group objects based on the newly provided distance information. This is ignored for distances between objects of different types. </p>
+<tr><th colspan="2">Enumerator</th></tr><tr><td class="fieldname"><a id="gga22428b6bab271411e3834e6b4ca22e37a7f6baba797d70538d03c9d13052c62ab" name="gga22428b6bab271411e3834e6b4ca22e37a7f6baba797d70538d03c9d13052c62ab"></a>HWLOC_DISTANCES_ADD_FLAG_GROUP&#160;</td><td class="fielddoc"><p>Try to group objects based on the newly provided distance information. Grouping is only performed when the distances structure contains latencies, and when all objects are of the same type. </p>
 </td></tr>
 <tr><td class="fieldname"><a id="gga22428b6bab271411e3834e6b4ca22e37a5233ccf631c3bc53dd5c3e7a5d5c9b77" name="gga22428b6bab271411e3834e6b4ca22e37a5233ccf631c3bc53dd5c3e7a5d5c9b77"></a>HWLOC_DISTANCES_ADD_FLAG_GROUP_INACCURATE&#160;</td><td class="fielddoc"><p>If grouping, consider the distance values as inaccurate and relax the comparisons during the grouping algorithms. The actual accuracy may be modified through the HWLOC_GROUPING_ACCURACY environment variable (see <a class="el" href="a00345.php">Environment Variables</a>). </p>
 </td></tr>
@@ -192,7 +192,7 @@
 <p>Create a new empty distances structure. </p>
 <p>Create an empty distances structure to be filled with <a class="el" href="a00166.php#ga8c9715481b0bce344c8a33c6e6a56469" title="Specify the objects and values in a new empty distances structure.">hwloc_distances_add_values()</a> and then committed with <a class="el" href="a00166.php#ga1f5a29760ebb8f9af831e645315f553c" title="Commit a new distances structure.">hwloc_distances_add_commit()</a>.</p>
 <p>Parameter <code>name</code> is optional, it may be <code>NULL</code>. Otherwise, it will be copied internally and may later be freed by the caller.</p>
-<p><code>kind</code> specifies the kind of distance as a OR'ed set of <a class="el" href="a00164.php#gab1bb10d3adb85b52cdc6fe5a7f74f108" title="Kinds of distance matrices.">hwloc_distances_kind_e</a>. Kind <a class="el" href="a00164.php#ggab1bb10d3adb85b52cdc6fe5a7f74f108aa6cf2b6dfcf148b65952f811814efbe1" title="This distances structure covers objects of different types. This may apply to the &quot;NVLinkBandwidth&quot; s...">HWLOC_DISTANCES_KIND_HETEROGENEOUS_TYPES</a> will be automatically set according to objects having different types in <a class="el" href="a00166.php#ga8c9715481b0bce344c8a33c6e6a56469" title="Specify the objects and values in a new empty distances structure.">hwloc_distances_add_values()</a>.</p>
+<p><code>kind</code> specifies the kind of distance as a OR'ed set of <a class="el" href="a00164.php#gab1bb10d3adb85b52cdc6fe5a7f74f108" title="Kinds of distance matrices.">hwloc_distances_kind_e</a>. Only one kind of meaning and one kind of provenance may be given if appropriate (e.g. <a class="el" href="a00164.php#ggab1bb10d3adb85b52cdc6fe5a7f74f108a41b19f141a3c0ffe85f9affaca4b0293" title="Distance values are similar to bandwidths between objects. Values are higher for closer objects,...">HWLOC_DISTANCES_KIND_MEANS_BANDWIDTH</a> and <a class="el" href="a00164.php#ggab1bb10d3adb85b52cdc6fe5a7f74f108a0148d7f9be833a04f5a55455437c227b" title="These distances were provided by the user.">HWLOC_DISTANCES_KIND_FROM_USER</a>). Kind <a class="el" href="a00164.php#ggab1bb10d3adb85b52cdc6fe5a7f74f108aa6cf2b6dfcf148b65952f811814efbe1" title="This distances structure covers objects of different types. This may apply to the &quot;NVLinkBandwidth&quot; s...">HWLOC_DISTANCES_KIND_HETEROGENEOUS_TYPES</a> will be automatically set according to objects having different types in <a class="el" href="a00166.php#ga8c9715481b0bce344c8a33c6e6a56469" title="Specify the objects and values in a new empty distances structure.">hwloc_distances_add_values()</a>.</p>
 <p><code>flags</code> must be <code>0</code> for now.</p>
 <dl class="section return"><dt>Returns</dt><dd>A hwloc_distances_add_handle_t that should then be passed to <a class="el" href="a00166.php#ga8c9715481b0bce344c8a33c6e6a56469" title="Specify the objects and values in a new empty distances structure.">hwloc_distances_add_values()</a> and <a class="el" href="a00166.php#ga1f5a29760ebb8f9af831e645315f553c" title="Commit a new distances structure.">hwloc_distances_add_commit()</a>.</dd>
 <dd>

projects/hwloc/doc/v2.11.0rc1/a00256.php → projects/hwloc/doc/v2.11.0/a00256.php

@@ -307,7 +307,7 @@
         </tr>
       </table>
 </div><div class="memdoc">
-<p>Interleave policy is supported. </p>
+<p>Weighted interleave policy is supported. </p>
 
 </div>
 </div>

projects/hwloc/doc/v2.11.0rc1/a00268.php → projects/hwloc/doc/v2.11.0/a00268.php

@@ -45,8 +45,8 @@
 </table>
 <a name="details" id="details"></a><h2 class="groupheader">Detailed Description</h2>
 <div class="textblock"><p>Matrix of distances between a set of objects. </p>
-<p>This matrix often contains latencies between NUMA nodes (as reported in the System Locality Distance Information Table (SLIT) in the ACPI specification), which may or may not be physically accurate. It corresponds to the latency for accessing the memory of one node from a core in another node. The corresponding kind is <a class="el" href="a00164.php#ggab1bb10d3adb85b52cdc6fe5a7f74f108a90dc38248c8d5392d4dd3e88f391e984" title="These distances were obtained from the operating system or hardware.">HWLOC_DISTANCES_KIND_FROM_OS</a> | <a class="el" href="a00164.php#ggab1bb10d3adb85b52cdc6fe5a7f74f108a0148d7f9be833a04f5a55455437c227b" title="These distances were provided by the user.">HWLOC_DISTANCES_KIND_FROM_USER</a>. The name of this distances structure is "NUMALatency". Others distance structures include and "XGMIBandwidth", "XGMIHops", "XeLinkBandwidth" and "NVLinkBandwidth".</p>
-<p>The matrix may also contain bandwidths between random sets of objects, possibly provided by the user, as specified in the <code>kind</code> attribute.</p>
+<p>The most common matrix contains latencies between NUMA nodes (as reported in the System Locality Distance Information Table (SLIT) in the ACPI specification), which may or may not be physically accurate. It corresponds to the latency for accessing the memory of one node from a core in another node. The corresponding kind is <a class="el" href="a00164.php#ggab1bb10d3adb85b52cdc6fe5a7f74f108afd6a3503fbc8f7c1a31235373cefc4c6" title="Distance values are similar to latencies between objects. Values are smaller for closer objects,...">HWLOC_DISTANCES_KIND_MEANS_LATENCY</a> | <a class="el" href="a00164.php#ggab1bb10d3adb85b52cdc6fe5a7f74f108a0148d7f9be833a04f5a55455437c227b" title="These distances were provided by the user.">HWLOC_DISTANCES_KIND_FROM_USER</a>. The name of this distances structure is "NUMALatency".</p>
+<p>The matrix may also contain bandwidths between random sets of objects, possibly provided by the user, as specified in the <code>kind</code> attribute. Others common distance structures include and "XGMIBandwidth", "XGMIHops", "XeLinkBandwidth" and "NVLinkBandwidth".</p>
 <p>Pointers <code>objs</code> and <code>values</code> should not be replaced, reallocated, freed, etc. However callers are allowed to modify <code>kind</code> as well as the contents of <code>objs</code> and <code>values</code> arrays. For instance, if there is a single NUMA node per Package, <a class="el" href="a00156.php#gab5df3ad1e8565ea0c2cf06412f6f6233" title="Return an object of a different type with same locality.">hwloc_get_obj_with_same_locality()</a> may be used to convert between them and replace NUMA nodes in the <code>objs</code> array with the corresponding Packages. See also <a class="el" href="a00164.php#gabcadd041f3072999d68f2d94e38670f7" title="Apply a transformation to a distances structure.">hwloc_distances_transform()</a> for applying some transformations to the structure. </p>
 </div><h2 class="groupheader">Field Documentation</h2>
 <a id="aef9c83cf467da1b1fa4c36493febb3b5" name="aef9c83cf467da1b1fa4c36493febb3b5"></a>

projects/hwloc/index.php

@@ -16,15 +16,12 @@
 <div style="float: right; clear: both"><!-- "clear: both" prevents news from going near the float image above -->
 <?php
 # Lists are not mirrored - use an absolute URL
-news("hwloc 2.11.0rc1",
-     "Beta release",
-     "https://www.mail-archive.com/[email protected]/msg00165.html");
-news("hwloc 2.10.0",
+news("hwloc 2.11.0",
      "Major release",
-     "https://www.mail-archive.com/[email protected]/msg00164.html");
+     "https://www.mail-archive.com/[email protected]/msg00166.html");
 news("Upgrading to v2.0 API",
      "Guide for Porting your Code",
-     "doc/v2.10.0/a00351.php");
+     "doc/v2.11.0/a00359.php");
 news("XML topology database",
      "Repository of XML topologies",
      "https://hwloc.gitlabpages.inria.fr/xmls/");

software/hwloc/current/version.inc

@@ -7,7 +7,7 @@
 # $last_dir: the directory of the last release on that series
 # (relative to $topdir/software/hwloc/$series_dir or $topdir/projects/hwloc/doc)
 #
-$series_dir = "v2.10";
+$series_dir = "v2.11";
 
 include_once("$topdir/software/hwloc/$series_dir/version.inc");
 

software/hwloc/v2.11/version.inc

@@ -11,8 +11,8 @@ $download_prefix="https://download.open-mpi.org/release/hwloc/v" . $release_seri
 $s3_prefix = "release/hwloc/v" . $release_series . "/";
 
 /* releases must be ordered newest to oldest */
-$releases = array();
+$releases = array("2.11.0");
 /* prereleases must be ordered newest to oldest.  All prereleases
    will be shown, so make an empty array when the official release
    is added to releases above */
-$prereleases = array("2.11.0rc1");
+$prereleases = array();