From 6ef87b5fed52c6642802e5ee2d1208f707e4e5a8 Mon Sep 17 00:00:00 2001 From: Jeff Squyres Date: Fri, 27 Oct 2023 15:53:59 -0400 Subject: [PATCH 1/2] docs: clarify --enable-mca-dso Add explicit text statting that --enable-mca-dso (with no LIST/argument value) will build *all* components as DSO. Signed-off-by: Jeff Squyres (cherry picked from commit cd4f1b97777931a1796e8af38caf513d2d9fbb03) --- .../configure-cli-options/installation.rst | 11 +++++++++-- 1 file changed, 9 insertions(+), 2 deletions(-) diff --git a/docs/installing-open-mpi/configure-cli-options/installation.rst b/docs/installing-open-mpi/configure-cli-options/installation.rst index 05da73ef917..2a6be26bd1b 100644 --- a/docs/installing-open-mpi/configure-cli-options/installation.rst +++ b/docs/installing-open-mpi/configure-cli-options/installation.rst @@ -193,7 +193,10 @@ 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 @@ -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 @@ -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:: From 28d1603d8efaac99d6fd823137f2f5ce127b6496 Mon Sep 17 00:00:00 2001 From: Jeff Squyres Date: Fri, 27 Oct 2023 15:54:40 -0400 Subject: [PATCH 2/2] docs: fix spacing error Fix a whitespace error that caused some text to render incorrectly. No content changes. Signed-off-by: Jeff Squyres (cherry picked from commit 940a414757c04a6575533406ea55cc3c71425425) --- docs/installing-open-mpi/configure-cli-options/installation.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/installing-open-mpi/configure-cli-options/installation.rst b/docs/installing-open-mpi/configure-cli-options/installation.rst index 2a6be26bd1b..7a11c75f77d 100644 --- a/docs/installing-open-mpi/configure-cli-options/installation.rst +++ b/docs/installing-open-mpi/configure-cli-options/installation.rst @@ -202,7 +202,7 @@ be used with ``configure``: * ``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