@@ -1252,28 +1252,26 @@ MISCELLANEOUS SUPPORT LIBRARIES
1252
1252
this option is only needed for special configurations.
1253
1253
1254
1254
--with-hwloc(=value)
1255
- Build hwloc support (default: enabled). This option specifies where
1256
- to find the hwloc support headers and library. The following values
1257
- are permitted:
1255
+ hwloc is a support library that provides processor and memory
1256
+ affinity information for NUMA platforms. It is required by Open
1257
+ MPI. Therefore, specifying --with-hwloc=no (or --without-hwloc) is
1258
+ disallowed.
1258
1259
1259
- internal: Use Open MPI's internal copy of hwloc.
1260
- external: Use an external hwloc installation (rely on default
1261
- compiler and linker paths to find it)
1262
- <no value>: Same as "internal".
1263
- <directory>: Specify the location of a specific hwloc
1264
- installation to use
1260
+ By default (i.e., if --with-hwloc is not specified, or if
1261
+ --with-hwloc is specified without a value), Open MPI will first try
1262
+ to find/use an hwloc installation on the current system. If Open
1263
+ MPI cannot find one, it will fall back to build and use the internal
1264
+ copy of hwloc included in the Open MPI source tree.
1265
1265
1266
- By default (or if --with-hwloc is specified with no VALUE), Open MPI
1267
- will build and use the copy of hwloc that it has in its source tree.
1268
- However, if the VALUE is "external", Open MPI will look for the
1269
- relevant hwloc header files and library in default compiler / linker
1270
- locations. Or, VALUE can be a directory tree where the hwloc header
1271
- file and library can be found. This option allows operating systems
1272
- to include Open MPI and use their default hwloc installation instead
1273
- of Open MPI's bundled hwloc.
1266
+ Alternatively, the --with-hwloc option can be used to specify where
1267
+ to find the hwloc support headers and library. The following values
1268
+ are permitted:
1274
1269
1275
- hwloc is a support library that provides processor and memory
1276
- affinity information for NUMA platforms.
1270
+ internal: Only use Open MPI's internal copy of hwloc.
1271
+ external: Only use an external hwloc installation (rely on
1272
+ default compiler and linker paths to find it).
1273
+ <directory>: Only use the specific hwloc installation found in
1274
+ the specified directory.
1277
1275
1278
1276
--with-hwloc-libdir=<directory>
1279
1277
Look in directory for the hwloc libraries. This option is only
0 commit comments