From e8e852fa766714ff2239fc1f3f6952c74a261558 Mon Sep 17 00:00:00 2001
From: Luca Boccassi <luca.boccassi@gmail.com>
Date: Tue, 18 Aug 2026 19:25:56 +0100
Subject: [PATCH] man: note that mixing sd-nsresourced and /etc/subuid is
 unsupported

---
 man/systemd-nsresourced.service.xml | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/man/systemd-nsresourced.service.xml b/man/systemd-nsresourced.service.xml
index e3ac1eb0c3..3c662d04ed 100644
--- a/man/systemd-nsresourced.service.xml
+++ b/man/systemd-nsresourced.service.xml
@@ -92,6 +92,11 @@
     <para>This service provides one <ulink url="https://varlink.org/">Varlink</ulink> service:
     <constant>io.systemd.NamespaceResource</constant> allows registering user namespaces, and assign mounts,
     cgroups and network interfaces to it.</para>
+
+    <para>Note that combining usage of <command>systemd-nsresourced</command> and systems based on
+    <filename>/etc/subuid</filename> and <filename>/etc/subgid</filename> might result in undefined
+    behavior if UID or GID ranges defined in those files overlap with the UID or GID ranges used by
+    nsresourced (the foreign UID range).</para>
   </refsect1>
 
   <refsect1>