From 0dfc1014da651a44176fa54e589ed4041ddca6cb Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Vin=C3=ADcius=20Ferr=C3=A3o?=
 <2031761+viniciusferrao@users.noreply.github.com>
Date: Fri, 16 Oct 2026 21:04:44 -0300
Subject: [PATCH] docs(genesis): describe journal test prerequisites

---
 xCAT-test/native/README.md | 16 ++++++++++++----
 1 file changed, 12 insertions(+), 4 deletions(-)

diff --git a/xCAT-test/native/README.md b/xCAT-test/native/README.md
index 80102a77d..0ea8b9248 100644
--- a/xCAT-test/native/README.md
+++ b/xCAT-test/native/README.md
@@ -269,10 +269,18 @@ console with Meson, then runs the installed program. It requires a C compiler,
 Meson, Ninja, pkg-config, and development packages for Newt and systemd.
 
 `python3 xCAT-test/native/genesis_console_dialogs.py` needs the same build
-dependencies plus the `pyte` Python package. It runs the linked console in a
-pseudo-terminal and checks help and diagnostics navigation, scrolling and
-return to the main screen. It checks termination from the main screen, not
-from inside a dialog.
+dependencies plus the `pyte` Python package, bubblewrap,
+systemd-journal-remote and journalctl. It runs the linked console in a
+pseudo-terminal and checks help and diagnostics navigation, scrolling,
+return to the main screen, and F3 journal filtering, order and history limits.
+It checks termination from the main screen, not from inside a dialog.
+
+The journal cases need working Linux user and mount namespaces. On Ubuntu
+24.04, the CI job enables them with
+`sudo sysctl -w kernel.apparmor_restrict_unprivileged_userns=0`.
+They import private journal files and verify their contents with journalctl
+before opening F3. They do not start a journal service or read the host
+journal. Missing tools or namespace support fail the tests; they do not skip.
 
 The Genesis runtime BATS cases need Bash, Perl, OpenSSL, coreutils, diffutils
 and bubblewrap. The credential-file cases use a private `/etc` in a Linux