From 41e7dc90f17d64dd556c4167fabc3c848bdad227 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Vin=C3=ADcius=20Ferr=C3=A3o?=
 <2031761+viniciusferrao@users.noreply.github.com>
Date: Tue, 22 Sep 2026 23:09:27 -0300
Subject: [PATCH] docs: document native packaging tests

---
 native/README.md | 24 ++++++++++++++++++++++++
 1 file changed, 24 insertions(+)
 create mode 100644 native/README.md

diff --git a/native/README.md b/native/README.md
new file mode 100644
index 0000000..e999353
--- /dev/null
+++ b/native/README.md
@@ -0,0 +1,24 @@
+# Native packaging tests
+
+The openEuler packaging tests build and sign RPMs or require Linux namespaces.
+They run separately from `prove -r t` on a disposable host with the required
+native tools:
+
+```
+prove -v native/*.t
+```
+
+Use an ordinary user for RPM builds. `openeuler-power-inputs.t` exercises the
+whole build owner only on POWER with native Mock; its RPM admission checks also
+run on x86_64. When running that test as root, set `XCAT_TEST_BUILD_USER` to an
+unprivileged account for the fixture builds.
+
+The fixtures are command doubles at the downloader and Mock boundaries. The
+POWER Mock adapter uses the installed Python API directly to load generated
+configurations. It does not execute another Python interpreter.
+
+The Mock configuration test loads the installed Python API from a checked-in
+fixture and is kept outside the unit run.
+
+Inspect TAP skips: a successful exit does not qualify an unavailable native
+tool or architecture.