hwloc: clarify --with-hwloc behavior
Clarify in README what --with-hwloc does in its different use cases. Also, ensure that the behavior when specifying `--with-hwloc` is the same as if that option is not specified at all. This is what we did in Open MPI <= v3.x; looks like we inadvertantly caused `--with-hwloc` to be synonymous with `--with-hwloc=external` in v4.0.0. Signed-off-by: Jeff Squyres <jsquyres@cisco.com>
Этот коммит содержится в:
родитель
8b424c3863
Коммит
18c3e1af5e
36
README
36
README
@ -1252,28 +1252,26 @@ MISCELLANEOUS SUPPORT LIBRARIES
|
||||
this option is only needed for special configurations.
|
||||
|
||||
--with-hwloc(=value)
|
||||
Build hwloc support (default: enabled). This option specifies where
|
||||
hwloc is a support library that provides processor and memory
|
||||
affinity information for NUMA platforms. It is required by Open
|
||||
MPI. Therefore, specifying --with-hwloc=no (or --without-hwloc) is
|
||||
disallowed.
|
||||
|
||||
By default (i.e., if --with-hwloc is not specified, or if
|
||||
--with-hwloc is specified without a value), Open MPI will first try
|
||||
to find/use an hwloc installation on the current system. If Open
|
||||
MPI cannot find one, it will fall back to build and use the internal
|
||||
copy of hwloc included in the Open MPI source tree.
|
||||
|
||||
Alternatively, the --with-hwloc option can be used to specify where
|
||||
to find the hwloc support headers and library. The following values
|
||||
are permitted:
|
||||
|
||||
internal: Use Open MPI's internal copy of hwloc.
|
||||
external: Use an external hwloc installation (rely on default
|
||||
compiler and linker paths to find it)
|
||||
<no value>: Same as "internal".
|
||||
<directory>: Specify the location of a specific hwloc
|
||||
installation to use
|
||||
|
||||
By default (or if --with-hwloc is specified with no VALUE), Open MPI
|
||||
will build and use the copy of hwloc that it has in its source tree.
|
||||
However, if the VALUE is "external", Open MPI will look for the
|
||||
relevant hwloc header files and library in default compiler / linker
|
||||
locations. Or, VALUE can be a directory tree where the hwloc header
|
||||
file and library can be found. This option allows operating systems
|
||||
to include Open MPI and use their default hwloc installation instead
|
||||
of Open MPI's bundled hwloc.
|
||||
|
||||
hwloc is a support library that provides processor and memory
|
||||
affinity information for NUMA platforms.
|
||||
internal: Only use Open MPI's internal copy of hwloc.
|
||||
external: Only use an external hwloc installation (rely on
|
||||
default compiler and linker paths to find it).
|
||||
<directory>: Only use the specific hwloc installation found in
|
||||
the specified directory.
|
||||
|
||||
--with-hwloc-libdir=<directory>
|
||||
Look in directory for the hwloc libraries. This option is only
|
||||
|
@ -75,6 +75,10 @@ AC_DEFUN([MCA_opal_hwloc_CONFIG_REQUIRE],[
|
||||
AC_MSG_WARN([an external copy that you supply.])
|
||||
AC_MSG_ERROR([Cannot continue])])
|
||||
|
||||
# check for no-op
|
||||
AS_IF([test "$with_hwloc" = "yes"],
|
||||
[with_hwloc=""])
|
||||
|
||||
# set default
|
||||
opal_hwloc_base_enable_xml=0
|
||||
|
||||
|
Загрузка…
Ссылка в новой задаче
Block a user