4.9.3. Networking support / options — Open MPI 5.0.10 documentation

# 4.9.3. Networking support / options

The following are command line options for various network types that can be used with `configure`:

- `--with-fca=DIR`: Specify the directory where the Mellanox FCA library and header files are located.

  FCA is the support library for Mellanox switches and HCAs.

- `--with-hcoll=DIR`: Specify the directory where the Mellanox hcoll library and header files are located. This option is generally only necessary if the hcoll headers and libraries are not in default compiler/linker search paths.

  hcoll is the support library for MPI collective operation offload on Mellanox ConnectX-3 HCAs (and later).

- `--with-knem=DIR`: Specify the directory where the knem libraries and header files are located. This option is generally only necessary if the knem headers and libraries are not in default compiler/linker search paths.

  knem is a Linux kernel module that allows direct process-to-process memory copies (optionally using hardware offload), potentially increasing bandwidth for large messages sent between messages on the same server. See the Knem web site for details.

- `--with-libfabric=DIR`: Specify the directory where the OpenFabrics Interfaces `libfabric` library and header files are located. This option is generally only necessary if the libfabric headers and libraries are not in default compiler/linker search paths.

  Libfabric is the support library for OpenFabrics Interfaces-based network adapters, such as Cisco usNIC, Intel True Scale PSM, Cray uGNI, etc.

- `--with-libfabric-libdir=DIR`: Look in directory for the libfabric libraries. By default, Open MPI will look in `DIR/lib` and `DIR/lib64`, which covers most cases. This option is only needed for special configurations.

- `--with-portals4=DIR`: Specify the directory where the Portals4 libraries and header files are located. This option is generally only necessary if the Portals4 headers and libraries are not in default compiler/linker search paths.

  Portals is a low-level network API for high-performance networking on high-performance computing systems developed by Sandia National Laboratories, Intel Corporation, and the University of New Mexico. The Portals 4 Reference Implementation is a complete implementation of Portals 4, with transport over InfiniBand verbs and UDP.

- `--with-portals4-libdir=DIR`: Location of libraries to link with for Portals4 support.

- `--with-portals4-max-md-size=SIZE` and `--with-portals4-max-va-size=SIZE`: Set configuration values for Portals 4

- `--with-psm=<directory>`: Specify the directory where the QLogic InfiniPath / Intel True Scale PSM library and header files are located. This option is generally only necessary if the PSM headers and libraries are not in default compiler/linker search paths.

  PSM is the support library for QLogic InfiniPath and Intel True Scale network adapters.

- `--with-psm-libdir=DIR`: Look in directory for the PSM libraries. By default, Open MPI will look in `DIR/lib` and `DIR/lib64`, which covers most cases. This option is only needed for special configurations.

- `--with-psm2=DIR`: Specify the directory where the Intel Omni-Path PSM2 library and header files are located. This option is generally only necessary if the PSM2 headers and libraries are not in default compiler/linker search paths.

  PSM is the support library for Intel Omni-Path network adapters.

- `--with-psm2-libdir=DIR`: Look in directory for the PSM2 libraries. By default, Open MPI will look in `DIR/lib` and `DIR/lib64`, which covers most cases. This option is only needed for special configurations.

- `--with-ucx=DIR`: Specify the directory where the UCX libraries and header files are located. This option is generally only necessary if the UCX headers and libraries are not in default compiler/linker search paths.

- `--with-ucx-libdir=DIR`: Look in directory for the UCX libraries. By default, Open MPI will look in `DIR/lib` and `DIR/lib64`, which covers most cases. This option is only needed for special configurations.

- `--with-usnic`: Abort configure if Cisco usNIC support cannot be built.