From 6e381209abd325b9e5ba6f2bdae2028045aedba0 Mon Sep 17 00:00:00 2001
From: Simon Byrne <simonbyrne@gmail.com>
Date: Thu, 17 Mar 2022 22:05:55 -0700
Subject: [PATCH] fix Homebrew Open MPI

---
 .github/workflows/UnitTests.yml | 1 +
 docs/src/knownissues.md         | 6 ++++++
 2 files changed, 7 insertions(+)

diff --git a/.github/workflows/UnitTests.yml b/.github/workflows/UnitTests.yml
index 44e7b004f..02d2def3d 100644
--- a/.github/workflows/UnitTests.yml
+++ b/.github/workflows/UnitTests.yml
@@ -121,6 +121,7 @@ jobs:
     runs-on: macos-latest
     env:
       JULIA_MPI_TEST_BINARY: system
+      ZES_ENABLE_SYSMAN: 1  # https://github.com/open-mpi/ompi/issues/10142
 
     steps:
     - name: Checkout
diff --git a/docs/src/knownissues.md b/docs/src/knownissues.md
index e09c33129..afabf6b08 100644
--- a/docs/src/knownissues.md
+++ b/docs/src/knownissues.md
@@ -34,6 +34,12 @@ This can be worked around be either:
 
 2. Launching julia with the  `--compiled-modules=no` option. This can result in much longer package load times.
 
+## Open MPI
+
+### Segmentation fault
+
+When attempting to use a system-provided Open MPI implementation, you may encounter a segmentation fault. This can be fixed by setting the environment variable `ZES_ENABLE_SYSMAN=1`. See [Open MPI issue #10142](https://github.com/open-mpi/ompi/issues/10142).
+
 ## UCX
 
 [UCX](https://www.openucx.org/) is a communication framework used by several MPI implementations.