.. admonition:: Important
   :class: error

   In Open MPI, this function only works properly when the MPI job is
   launched via :ref:`man1-mpirun`.  Using this function in other
   run-time environments is currently unsupported, and may result in
   undefined behavior (e.g., the MPI job may hang).
