From 14bb4a9221d8c134258f8d587b04fbc4ccd4fea5 Mon Sep 17 00:00:00 2001
From: Juri Dispan <juri.dispan@posteo.net>
Date: Tue, 23 Jan 2024 08:26:57 +0100
Subject: [PATCH] switch_root, tailf, uuidparse, waitpid: add pages (#12108)

* switch_root, tailf, uuidparse, waitpid: add pages

---------

Co-authored-by: Vitor Henrique <87824454+vitorhcl@users.noreply.github.com>
---
 pages/linux/switch_root.md | 14 ++++++++++++++
 pages/linux/tailf.md       |  8 ++++++++
 pages/linux/uuidparse.md   | 33 +++++++++++++++++++++++++++++++++
 pages/linux/waitpid.md     | 25 +++++++++++++++++++++++++
 4 files changed, 80 insertions(+)
 create mode 100644 pages/linux/switch_root.md
 create mode 100644 pages/linux/tailf.md
 create mode 100644 pages/linux/uuidparse.md
 create mode 100644 pages/linux/waitpid.md

diff --git a/pages/linux/switch_root.md b/pages/linux/switch_root.md
new file mode 100644
index 000000000..b72ceb557
--- /dev/null
+++ b/pages/linux/switch_root.md
@@ -0,0 +1,14 @@
+# switch_root
+
+> Use a different filesystem as the root of the mount tree.
+> NOTE: switch_root will fail to function if the new root is not the root of a mount. Use bind-mounting as a workaround.
+> See also: `chroot`, `mount`.
+> More information: <https://manned.org/switch_root.8>.
+
+- Move `/proc`, `/dev`, `/sys` and `/run` to the specified filesystem, use this filesystem as the new root and start the specified init process:
+
+`switch_root {{new_root}} {{/sbin/init}}`
+
+- Display help:
+
+`switch_root -h`
diff --git a/pages/linux/tailf.md b/pages/linux/tailf.md
new file mode 100644
index 000000000..fd4064497
--- /dev/null
+++ b/pages/linux/tailf.md
@@ -0,0 +1,8 @@
+# tailf
+
+> This command is superseded by `tail -f`.
+> More information: <https://manned.org/tailf.1>.
+
+- View documentation for the recommended replacement:
+
+`tldr tail`
diff --git a/pages/linux/uuidparse.md b/pages/linux/uuidparse.md
new file mode 100644
index 000000000..3542f4d71
--- /dev/null
+++ b/pages/linux/uuidparse.md
@@ -0,0 +1,33 @@
+# uuidparse
+
+> Parse universally unique identifiers.
+> See also: `uuidgen`.
+> More information: <https://manned.org/uuidparse.1>.
+
+- Parse the specified UUIDs, use a tabular output format:
+
+`uuidparse {{uuid1 uuid2 ...}}`
+
+- Parse UUIDs from `stdin`:
+
+`{{command}} | uuidparse`
+
+- Use the JSON output format:
+
+`uuidparse --json {{uuid1 uuid2 ...}}`
+
+- Do not print a header line:
+
+`uuidparse --noheadings {{uuid1 uuid2 ...}}`
+
+- Use the raw output format:
+
+`uuidparse --raw {{uuid1 uuid2 ...}}`
+
+- Specify which of the four output columns to print:
+
+`uuidparse --output {{UUID,VARIANT,TYPE,TIME}}`
+
+- Display help:
+
+`uuidparse -h`
diff --git a/pages/linux/waitpid.md b/pages/linux/waitpid.md
new file mode 100644
index 000000000..2e54fd3da
--- /dev/null
+++ b/pages/linux/waitpid.md
@@ -0,0 +1,25 @@
+# waitpid
+
+> Wait for the termination of arbitrary processes.
+> See also: `wait`.
+> More information: <https://manned.org/waitpid.1>.
+
+- Sleep until all processes whose PIDs have been specified have exited:
+
+`waitpid {{pid1 pid2 ...}}`
+
+- Sleep for at most `n` seconds:
+
+`waitpid --timeout {{n}} {{pid1 pid2 ...}}`
+
+- Do not error if specified PIDs have already exited:
+
+`waitpid --exited {{pid1 pid2 ...}}`
+
+- Sleep until `n` of the specified processes have exited:
+
+`waitpid --count {{n}} {{pid1 pid2 ...}}`
+
+- Display help:
+
+`waitpid -h`