From afa35f524f234babc08f987bf131277f3d57fe83 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Vin=C3=ADcius=20Ferr=C3=A3o?=
 <2031761+viniciusferrao@users.noreply.github.com>
Date: Thu, 8 Oct 2026 19:13:21 -0300
Subject: [PATCH] docs(test): describe image caller test boundaries

---
 xCAT-test/bats/README.md   |  4 ++++
 xCAT-test/native/README.md | 20 ++++++++++++++++++++
 2 files changed, 24 insertions(+)

diff --git a/xCAT-test/bats/README.md b/xCAT-test/bats/README.md
index c89958e17..18b3cf0c9 100644
--- a/xCAT-test/bats/README.md
+++ b/xCAT-test/bats/README.md
@@ -37,6 +37,10 @@ if the default temporary directory is mounted with `noexec`.
 bats-core 1.4 or newer. OS detection also requires GNU awk for the legacy
 Red Hat release parser. Postscript cases require GNU diffutils.
 
+`networkmanager_postscript.bats` renders complete installation postscripts in
+private namespaces. It requires Bubblewrap, bats-core 1.4 or newer, user
+namespaces and the xCAT Perl dependencies, including DBI and DBD::SQLite.
+
 `go_xcat_os_release.bats` and `go_xcat_el_repo_check.bats` source the complete
 go-xcat script. OS detection uses mawk when available, otherwise the host AWK.
 The two legacy Red Hat version cases use GNU awk. CI installs both interpreters.
diff --git a/xCAT-test/native/README.md b/xCAT-test/native/README.md
index e349e1d5f..511d56ff9 100644
--- a/xCAT-test/native/README.md
+++ b/xCAT-test/native/README.md
@@ -54,6 +54,26 @@ prove xCAT-test/native/buildrpms_openeuler.t \
       xCAT-test/native/openeuler_package_policy.t
 ```
 
+The image caller tests need `bubblewrap`, `cpio`, `gzip`, RPM tools and the
+Perl modules used by the unit suite, including DBD::SQLite, XML::Simple and
+Net::DNS:
+
+```
+prove xCAT-test/native/genimage_network_drivers.t \
+      xCAT-test/native/el10_image_package_policy.t
+```
+
+These cases run complete callers in private filesystems with no network.
+They check driver configuration after real driver-disk loading, media-import
+records and parsed RPM installation scriptlets.
+External package downloads, service management, disk mounts and initrd creation
+use command fixtures. These cases do not boot an image or qualify hardware.
+The two Perl image caller tests fail if run as root.
+
+The default BATS suite also runs `networkmanager_postscript.bats`. It renders
+installation postscripts and checks their network configuration in isolation.
+See `xCAT-test/bats/README.md` for its prerequisites.
+
 Run the isolated system cases as root:
 
 ```