From bdde90fb1dec35305c466e0145e428e546c2c565 Mon Sep 17 00:00:00 2001
From: Dylan <145150333+dmmqz@users.noreply.github.com>
Date: Wed, 9 Jul 2025 17:13:49 +0000
Subject: [PATCH] mpic++, mpiexec, mpirun: add pages; mpicc: move to `common/`
 (#17137)

Co-authored-by: Managor <42655600+Managor@users.noreply.github.com>
---
 pages/common/mpic++.md           | 13 +++++++++++++
 pages/{linux => common}/mpicc.md |  0
 pages/common/mpiexec.md          |  7 +++++++
 pages/common/mpirun.md           | 17 +++++++++++++++++
 4 files changed, 37 insertions(+)
 create mode 100644 pages/common/mpic++.md
 rename pages/{linux => common}/mpicc.md (100%)
 create mode 100644 pages/common/mpiexec.md
 create mode 100644 pages/common/mpirun.md

diff --git a/pages/common/mpic++.md b/pages/common/mpic++.md
new file mode 100644
index 0000000000..744e2252e6
--- /dev/null
+++ b/pages/common/mpic++.md
@@ -0,0 +1,13 @@
+# mpic++
+
+> Open MPI wrapper compiler for C++.
+> See also: `mpirun`.
+> More information: <https://www.open-mpi.org/doc/v3.0/man1/mpic++.1.php>.
+
+- Compile an Open MPI program:
+
+`mpic++ {{path/to/source_file}}`
+
+- Show all the wrapper-supplied flags:
+
+`mpic++ --showme`
diff --git a/pages/linux/mpicc.md b/pages/common/mpicc.md
similarity index 100%
rename from pages/linux/mpicc.md
rename to pages/common/mpicc.md
diff --git a/pages/common/mpiexec.md b/pages/common/mpiexec.md
new file mode 100644
index 0000000000..79c67e8678
--- /dev/null
+++ b/pages/common/mpiexec.md
@@ -0,0 +1,7 @@
+# mpiexec
+
+> This command is an alias of `mpirun`.
+
+- View documentation for the original command:
+
+`tldr mpirun`
diff --git a/pages/common/mpirun.md b/pages/common/mpirun.md
new file mode 100644
index 0000000000..20e03bc680
--- /dev/null
+++ b/pages/common/mpirun.md
@@ -0,0 +1,17 @@
+# mpirun
+
+> Execute serial and parallel jobs in Open MPI.
+> See also: `mpic++`.
+> More information: <https://docs.open-mpi.org/en/main/man-openmpi/man1/mpirun.1.html>.
+
+- Execute an Open MPI program:
+
+`mpirun {{path/to/executable}}`
+
+- Execute an Open MPI program with `n` parallel processes:
+
+`mpirun -n {{n}} {{path/to/executable}}`
+
+- Allow more processes than available physical cores:
+
+`mpirun -oversubscribe {{path/to/executable}}`