1
1

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>
Этот коммит содержится в:
Jeff Squyres 2019-12-19 08:38:57 -08:00
родитель 8b424c3863
Коммит 18c3e1af5e
2 изменённых файлов: 21 добавлений и 19 удалений

36
README
Просмотреть файл

@ -1252,28 +1252,26 @@ MISCELLANEOUS SUPPORT LIBRARIES
this option is only needed for special configurations. this option is only needed for special configurations.
--with-hwloc(=value) --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 to find the hwloc support headers and library. The following values
are permitted: are permitted:
internal: Use Open MPI's internal copy of hwloc. internal: Only use Open MPI's internal copy of hwloc.
external: Use an external hwloc installation (rely on default external: Only use an external hwloc installation (rely on
compiler and linker paths to find it) default compiler and linker paths to find it).
<no value>: Same as "internal". <directory>: Only use the specific hwloc installation found in
<directory>: Specify the location of a specific hwloc the specified directory.
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.
--with-hwloc-libdir=<directory> --with-hwloc-libdir=<directory>
Look in directory for the hwloc libraries. This option is only 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_WARN([an external copy that you supply.])
AC_MSG_ERROR([Cannot continue])]) AC_MSG_ERROR([Cannot continue])])
# check for no-op
AS_IF([test "$with_hwloc" = "yes"],
[with_hwloc=""])
# set default # set default
opal_hwloc_base_enable_xml=0 opal_hwloc_base_enable_xml=0