Skip to content

Commit

Permalink
Merge pull request #12028 from jsquyres/pr/v5.0.x/docs-enable-mca-dso…
Browse files Browse the repository at this point in the history
…-improvements

v5.0.x: docs: enable --enable-mca-dso description
  • Loading branch information
janjust authored Nov 9, 2023
2 parents 317d1eb + 28d1603 commit 1e9b325
Showing 1 changed file with 10 additions and 3 deletions.
13 changes: 10 additions & 3 deletions docs/installing-open-mpi/configure-cli-options/installation.rst
Original file line number Diff line number Diff line change
Expand Up @@ -193,13 +193,16 @@ be used with ``configure``:
options, but have no impact on the selection logic described below.
Only affirmative options change the selection process.

``LIST`` is a comma-delimited list of Open MPI frameworks and/or
If ``LIST`` is not specified (e.g., ``--enable-mca-dso`` with no
``LIST``), or if ``LIST`` is the special value ``yes``, then *all*
components will be selected. If ``LIST`` is specified, it is a
comma-delimited list of Open MPI frameworks and/or
framework+component tuples. Examples:

* ``btl`` specifies the entire BTL framework
* ``btl-tcp`` specifies just the TCP component in the BTL framework
* ``mtl,btl-tcp`` specifies the entire MTL framework and the TCP
component in the BTL framework
component in the BTL framework

Open MPI's ``configure`` script uses the values of these two options
when evaluating each component to determine how it should be built
Expand All @@ -213,7 +216,7 @@ be used with ``configure``:
#. Otherwise, ``configure`` uses the global default build behavior.

At each level of the selection process, if the component is
specified to be built as both a static and dso component, the static
specified to be built as both a static and DSO component, the static
option will win.

.. note:: As of Open MPI |ompi_ver|, ``configure``'s global default
Expand All @@ -234,6 +237,10 @@ be used with ``configure``:

shell$ ./configure

#. Build all components as DSOs::

shell$ ./configure --enable-mca-dso

#. Build all components as static, except the TCP BTL, which will be
built as a DSO::

Expand Down

0 comments on commit 1e9b325

Please sign in to comment.