From b6ac034ebbc19e17823d7ef55a90b06facc161d4 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?V=C3=ADtor=20Henrique?=
 <87824454+vitorhcl@users.noreply.github.com>
Date: Tue, 7 May 2024 01:44:32 -0300
Subject: [PATCH] ipcs: fix POSIX page; linux/ipcs, lsipc: add pages (#12553)

---
 pages/common/ipcs.md | 34 +++++++++++++++++++++++++++-------
 pages/linux/ipcs.md  | 37 +++++++++++++++++++++++++++++++++++++
 pages/linux/lsipc.md | 29 +++++++++++++++++++++++++++++
 3 files changed, 93 insertions(+), 7 deletions(-)
 create mode 100644 pages/linux/ipcs.md
 create mode 100644 pages/linux/lsipc.md

diff --git a/pages/common/ipcs.md b/pages/common/ipcs.md
index 126548646..d19197cea 100644
--- a/pages/common/ipcs.md
+++ b/pages/common/ipcs.md
@@ -1,12 +1,32 @@
 # ipcs
 
-> Display information about resources used in IPC (Inter-process Communication).
-> More information: <https://manned.org/ipcs>.
+> Show information about the usage of XSI IPC facilities: shared memory segments, message queues, and semaphore arrays.
+> More information: <https://manned.org/ipcs.1p>.
 
-- Specific information about the Message Queue which has the ID 32768:
-
-`ipcs -qi 32768`
-
-- General information about all the IPC:
+- Show information about all the IPC:
 
 `ipcs -a`
+
+- Show information about active shared [m]emory segments, message [q]ueues or [s]empahore sets:
+
+`ipcs {{-m|-q|-s}}`
+
+- Show information on maximum allowable size in [b]ytes:
+
+`ipcs -b`
+
+- Show [c]reator’s user name and group name for all IPC facilities:
+
+`ipcs -c`
+
+- Show the [p]ID of the last operators for all IPC facilities:
+
+`ipcs -p`
+
+- Show access [t]imes for all IPC facilities:
+
+`ipcs -t`
+
+- Show [o]utstanding usage for active message queues, and shared memory segments:
+
+`ipcs -o`
diff --git a/pages/linux/ipcs.md b/pages/linux/ipcs.md
new file mode 100644
index 000000000..a913e6e3e
--- /dev/null
+++ b/pages/linux/ipcs.md
@@ -0,0 +1,37 @@
+# ipcs
+
+> Show information about the usage of System V IPC facilities: shared memory segments, message queues, and semaphore arrays.
+> See also: `lsipc` for a more flexible tool, `ipcmk` for creating IPC facilities, and `ipcrm` for deleting them.
+> More information: <https://manned.org/ipcs>.
+
+- Show information about all active IPC facilities:
+
+`ipcs`
+
+- Show information about active shared [m]emory segments, message [q]ueues or [s]empahore sets:
+
+`ipcs {{--shmems|--queues|--semaphores}}`
+
+- Show full details on the resource with a specific [i]D:
+
+`ipcs {{--shmems|--queues|--semaphores}} --id {{resource_id}}`
+
+- Show [l]imits in [b]ytes or in a human-readable format:
+
+`ipcs --limits {{--bytes|--human}}`
+
+- Show s[u]mmary about current usage:
+
+`ipcs --summary`
+
+- Show [c]reator's and owner's UIDs and PIDs for all IPC facilities:
+
+`ipcs --creator`
+
+- Show the [p]ID of the last operators for all IPC facilities:
+
+`ipcs --pid`
+
+- Show last access [t]imes for all IPC facilities:
+
+`ipcs --time`
diff --git a/pages/linux/lsipc.md b/pages/linux/lsipc.md
new file mode 100644
index 000000000..7862f39f8
--- /dev/null
+++ b/pages/linux/lsipc.md
@@ -0,0 +1,29 @@
+# lsipc
+
+> Show information on System V IPC facilities currently employed in the system.
+> See also: `ipcs` for the older tool.
+> More information: <https://manned.org/lsipc>.
+
+- Show information about all active IPC facilities:
+
+`lsipc`
+
+- Show information about active shared [m]emory segments, message [q]ueues or [s]empahore sets:
+
+`lsipc {{--shmems|--queues|--semaphores}}`
+
+- Show full details on the resource with a specific [i]D:
+
+`lsipc {{--shmems|--queues|--semaphores}} --id {{resource_id}}`
+
+- Print the given [o]utput columns (see all supported columns with `--help`):
+
+`lsipc --output {{KEY,ID,PERMS,SEND,STATUS,NSEMS,RESOURCE,...}}`
+
+- Use [r]aw, [J]SON, [l]ist or [e]xport (key="value") format:
+
+`lsipc {{--raw|--json|--list|--export}}`
+
+- Don't truncate the output:
+
+`lsipc --notruncate`