From cbc80c707e02a67b049e3be494b50d43e2f50c12 Mon Sep 17 00:00:00 2001
From: Lena <126529524+acuteenvy@users.noreply.github.com>
Date: Tue, 26 Aug 2025 04:17:42 +0200
Subject: [PATCH] systemd-cat: add examples (#17754)

* systemd-cat: add examples
---
 pages/linux/systemd-cat.md | 12 ++++++++++++
 1 file changed, 12 insertions(+)

diff --git a/pages/linux/systemd-cat.md b/pages/linux/systemd-cat.md
index 1da2f71147..edfaadf512 100644
--- a/pages/linux/systemd-cat.md
+++ b/pages/linux/systemd-cat.md
@@ -10,3 +10,15 @@
 - Write the output of a pipeline to the journal (`stderr` stays connected to the terminal):
 
 `{{command}} | systemd-cat`
+
+- Use the specified identifier (default: `cat` when reading from a pipeline, executable name otherwise):
+
+`{{command}} | systemd-cat {{[-t|--identifier]}} {{id}}`
+
+- Use the specified default priority level for all logged messages:
+
+`systemd-cat {{[-p|--priority]}} {{emerg|alert|crit|err|warning|notice|info|debug}} {{command}}`
+
+- Use the specified default priority level for the logged messages from the command's `stderr`:
+
+`systemd-cat --stderr-priority {{emerg|alert|crit|err|warning|notice|info|debug}} {{command}}`