From 9330e542b36c5dfccb3ed24bb2c8cc15ade3715f Mon Sep 17 00:00:00 2001
From: marchersimon <50295997+marchersimon@users.noreply.github.com>
Date: Thu, 25 Mar 2021 13:46:40 +0100
Subject: [PATCH] poweroff, halt, reboot: add examples (#5485)

---
 pages/linux/halt.md     | 18 +++++++++++++-----
 pages/linux/poweroff.md | 23 ++++++++++++++++++++---
 pages/linux/reboot.md   | 19 ++++++++++++++++---
 3 files changed, 49 insertions(+), 11 deletions(-)

diff --git a/pages/linux/halt.md b/pages/linux/halt.md
index 31c2b24d7..0abe8d97d 100644
--- a/pages/linux/halt.md
+++ b/pages/linux/halt.md
@@ -1,16 +1,24 @@
 # halt
 
-> Halt, power-off or reboot the machine.
-> More information: <https://www.freedesktop.org/software/systemd/man/halt.html>.
+> Halt the system.
+> More information: <https://www.man7.org/linux/man-pages/man8/halt.8.html>.
 
-- Halt the machine:
+- Halt the system:
 
 `halt`
 
-- Power the machine off:
+- Power off the system (same as `poweroff`):
 
 `halt --poweroff`
 
-- Reboot the machine:
+- Reboot the system (same as `reboot`):
 
 `halt --reboot`
+
+- Halt immediately without contacting the system manager:
+
+`halt --force --force`
+
+- Write the wtmp shutdown entry without halting the system:
+
+`halt --wtmp-only`
diff --git a/pages/linux/poweroff.md b/pages/linux/poweroff.md
index 370a38128..875e45498 100644
--- a/pages/linux/poweroff.md
+++ b/pages/linux/poweroff.md
@@ -1,7 +1,24 @@
 # poweroff
 
-> Shutdown the system.
+> Power off the system.
+> More information: <https://www.man7.org/linux/man-pages/man8/poweroff.8.html>.
 
-- Poweroff the system:
+- Power off the system:
 
-`sudo poweroff`
+`poweroff`
+
+- Halt the system (same as `halt`):
+
+`poweroff --halt`
+
+- Reboot the system (same as `reboot`):
+
+`poweroff --reboot`
+
+- Shut down immediately without contacting the system manager:
+
+`poweroff --force --force`
+
+- Write the wtmp shutdown entry without shutting down the system:
+
+`poweroff --wtmp-only`
diff --git a/pages/linux/reboot.md b/pages/linux/reboot.md
index a09d3435c..daa95c8b0 100644
--- a/pages/linux/reboot.md
+++ b/pages/linux/reboot.md
@@ -1,11 +1,24 @@
 # reboot
 
 > Reboot the system.
+> More information: <https://www.man7.org/linux/man-pages/man8/reboot.8.html>.
 
-- Reboot immediately:
+- Reboot the system:
 
 `reboot`
 
-- Reboot immediately without gracefully shutting down:
+- Power off the system (same as `poweroff`):
 
-`reboot -f`
+`reboot --poweroff`
+
+- Halt the system (same as `halt`):
+
+`rebooot --halt`
+
+- Reboot immediately without contacting the system manager:
+
+`reboot --force --force`
+
+- Write the wtmp shutdown entry without rebooting the system:
+
+`reboot --wtmp-only`