From a8864329ffb62800c61a9de7c022d8ff34c72ae3 Mon Sep 17 00:00:00 2001
From: Vitor Henrique <87824454+vitorhcl@users.noreply.github.com>
Date: Tue, 9 Jan 2024 05:58:07 -0300
Subject: [PATCH] ionice: move to linux/ and update page (#12042)

---
 pages/common/ionice.md | 18 ------------------
 pages/linux/ionice.md  | 30 ++++++++++++++++++++++++++++++
 2 files changed, 30 insertions(+), 18 deletions(-)
 delete mode 100644 pages/common/ionice.md
 create mode 100644 pages/linux/ionice.md

diff --git a/pages/common/ionice.md b/pages/common/ionice.md
deleted file mode 100644
index c085b81da..000000000
--- a/pages/common/ionice.md
+++ /dev/null
@@ -1,18 +0,0 @@
-# ionice
-
-> Get or set program I/O scheduling class and priority.
-> Scheduling classes: 1 (realtime), 2 (best-effort), 3 (idle).
-> Priority levels: 0 (the highest) - 7 (the lowest).
-> More information: <https://manned.org/ionice>.
-
-- Set I/O scheduling class of a running process:
-
-`ionice -c {{scheduling_class}} -p {{pid}}`
-
-- Run a command with custom I/O scheduling class and priority:
-
-`ionice -c {{scheduling_class}} -n {{priority}} {{command}}`
-
-- Print the I/O scheduling class and priority of a running process:
-
-`ionice -p {{pid}}`
diff --git a/pages/linux/ionice.md b/pages/linux/ionice.md
new file mode 100644
index 000000000..2dda8140d
--- /dev/null
+++ b/pages/linux/ionice.md
@@ -0,0 +1,30 @@
+# ionice
+
+> Get or set program I/O scheduling class and priority.
+> Scheduling classes: 1 (realtime), 2 (best-effort), 3 (idle).
+> Priority levels: 0 (the highest) - 7 (the lowest).
+> More information: <https://manned.org/ionice>.
+
+- Run a command with the given scheduling class and priority:
+
+`ionice -c {{scheduling_class}} -n {{priority}} {{command}}`
+
+- Set I/O scheduling [c]lass of a running process with a specific [p]id, [P]gid or [u]id:
+
+`ionice -c {{scheduling_class}} -{{p|P|u}} {{id}}`
+
+- Run a command with custom I/O scheduling [c]lass and priority:
+
+`ionice -c {{scheduling_class}} -n {{priority}} {{command}}`
+
+- Ignore failure to set the requested priority:
+
+`ionice -t -n {{priority}} -p {{pid}}`
+
+- Run the command even in case it was not possible to set the desired priority (this can happen due to insufficient privileges or an old kernel version):
+
+`ionice -t -n {{priority}} -p {{pid}}`
+
+- Print the I/O scheduling class and priority of a running process:
+
+`ionice -p {{pid}}`