@@ -78,7 +78,7 @@ system.
78
78
there is not much reason to upgrade to use a later
79
79
version of Libevent.
80
80
81
- * `PMIx <https://pmix .org/ >`_
81
+ * `Open PMIx <https://docs.openpmix .org/ >`_
82
82
83
83
* This library is required; Open MPI will not build without it.
84
84
* **Minimum version required when building without PRRTE: **
@@ -122,16 +122,16 @@ system.
122
122
.. warning :: If you are building the PRRTE that is embedded in the
123
123
Open MPI |ompi_ver | distribution:
124
124
125
- * If you are also building the PMIx that is embedded in
125
+ * If you are also building the Open PMIx that is embedded in
126
126
the Open MPI |ompi_ver | distribution, that
127
127
combination of packages is supported.
128
128
129
- * If you are building against an external PMIx
130
- installation (i.e., a version of PMIx that is not
129
+ * If you are building against an external Open PMIx
130
+ installation (i.e., a version of Open PMIx that is not
131
131
embedded in the Open MPI |ompi_ver | distribution),
132
132
you should check `the PRRTE project documentation
133
133
<https://docs.prrte.org/> `_ to see what minimum
134
- version of PMIx is required.
134
+ version of Open PMIx is required.
135
135
136
136
* If your environment uses another MPI application launcher (e.g.,
137
137
Slurm users can use the ``srun `` launcher to "direct launch" Open
@@ -177,11 +177,11 @@ These support libraries have dependencies upon each other:
177
177
178
178
The higher-level boxes depend on the lower-level boxes. Specifically:
179
179
180
- * Open MPI depends on PRRTE, PMIx, Hwloc, and Libevent (i.e.,
180
+ * Open MPI depends on PRRTE, Open PMIx, Hwloc, and Libevent (i.e.,
181
181
everything).
182
- * PRRTE depends on PMIx, Hwloc, and Libevent (i.e., everything except
182
+ * PRRTE depends on Open PMIx, Hwloc, and Libevent (i.e., everything except
183
183
Open MPI).
184
- * PMIx depends on Hwloc and Libevent.
184
+ * Open PMIx depends on Hwloc and Libevent.
185
185
* Hwloc does not depend on anything.
186
186
* Libevent does not depend on anything.
187
187
@@ -201,7 +201,7 @@ consider if:
201
201
202
202
* Loading the Open MPI shared library causes the loading of Libevent
203
203
shared library vA.B.C.
204
- * But then the subsequent loading of the PMIx shared library causes
204
+ * But then the subsequent loading of the Open PMIx shared library causes
205
205
the loading of Libevent shared library vX.Y.Z.
206
206
207
207
Since there are now two different versions of the Libevent shared
@@ -266,33 +266,33 @@ Build example 1
266
266
#. ``configure `` will ignore the PRRTE library that is bundled in the
267
267
Open MPI source tree and will use the PRRTE that is already
268
268
installed in ``/usr/local ``.
269
- #. ``configure `` will also ignore the bundled PMIx, Hwloc, and
269
+ #. ``configure `` will also ignore the bundled Open PMIx, Hwloc, and
270
270
Libevent libraries in the Open MPI source tree.
271
271
272
272
* If ``configure `` is unable to find header files and libraries for
273
- PMIx, Hwloc, and Libevent elsewhere on the build machine (i.e.,
274
- assumedly the same PMIx, Hwloc, and Libevent than the PRRTE in
273
+ Open PMIx, Hwloc, and Libevent elsewhere on the build machine (i.e.,
274
+ assumedly the same Open PMIx, Hwloc, and Libevent than the PRRTE in
275
275
``/usr/local `` is using), this is an error: ``configure `` will
276
276
abort, and therefore refuse to build Open MPI.
277
277
278
278
Build example 2
279
279
^^^^^^^^^^^^^^^
280
280
281
281
``configure `` does *not * find PRRTE on the build machine, but *does *
282
- find PMIx development headers and libraries in ``/opt/local ``. This
282
+ find Open PMIx development headers and libraries in ``/opt/local ``. This
283
283
will cause the following to occur:
284
284
285
285
#. ``configure `` will set up to build the PRRTE library that is
286
286
bundled in the Open MPI source tree.
287
- #. ``configure `` will ignore the PMIx library that is bundled in the
288
- Open MPI source tree and will use the PMIx that is already
287
+ #. ``configure `` will ignore the Open PMIx library that is bundled in the
288
+ Open MPI source tree and will use the Open PMIx that is already
289
289
installed in ``/opt/local ``.
290
290
#. ``configure `` will also ignore the bundled Hwloc and Libevent
291
291
libraries in the Open MPI source tree.
292
292
293
293
* If ``configure `` is unable to find header files and libraries for
294
294
Hwloc and Libevent elsewhere on the build machine (i.e.,
295
- assumedly the same Hwloc and Libevent than the PMIx in
295
+ assumedly the same Hwloc and Libevent than the Open PMIx in
296
296
``/opt/local `` is using), this is an error: ``configure `` will
297
297
abort, and therefore refuse to build Open MPI.
298
298
@@ -303,7 +303,7 @@ Build example 3
303
303
Libevent on the build machine. This will cause the following to
304
304
occur:
305
305
306
- #. ``configure `` will set up to build the PRRTE, PMIx, and Hwloc
306
+ #. ``configure `` will set up to build the PRRTE, Open PMIx, and Hwloc
307
307
libraries that are bundled in the Open MPI source tree.
308
308
#. ``configure `` will ignore the Libevent library that is bundled in
309
309
the Open MPI source tree and will use the Libevent that is already
@@ -435,10 +435,10 @@ your environment, you can use :ref:`command line options to override
435
435
its default behavior
436
436
<label-building-ompi-cli-options-required-support-libraries>`.
437
437
438
- For example, if PMIx and/or PRRTE are installed such that the default
438
+ For example, if Open PMIx and/or PRRTE are installed such that the default
439
439
header file and linker search paths will not find them, you can
440
440
provide command line options telling Open MPI's ``configure `` where to
441
- search. Here's an example ``configure `` invocation where PMIx and
441
+ search. Here's an example ``configure `` invocation where Open PMIx and
442
442
PRRTE have both been installed to ``/opt/open-mpi-stuff ``:
443
443
444
444
.. code-block :: sh
@@ -480,7 +480,7 @@ versions of the required libraries.
480
480
-----------------------------
481
481
482
482
If you are an Open MPI packager, we **strongly ** suggest that your
483
- Open MPI package should not include Hwloc, Libevent, PMIx, or PRRTE.
483
+ Open MPI package should not include Hwloc, Libevent, Open PMIx, or PRRTE.
484
484
Instead, it should depend on external, independently-built versions of
485
485
these packages.
486
486
0 commit comments