From: Lennart Poettering <lennart@poettering.net>
Date: Mon, 2 Jun 2025 13:14:43 +0000 (+0200)
Subject: man: mention systemd-userdb-load-credentials.service when discussing /run/userdb... 
X-Git-Tag: v258-rc1~420^2~2
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=c4c0307f53a84f7560d00c7b34f71108d9a755cd;p=thirdparty%2Fsystemd.git

man: mention systemd-userdb-load-credentials.service when discussing /run/userdb/ drop-ins
---

diff --git a/man/nss-systemd.xml b/man/nss-systemd.xml
index ff4416c2582..ddadef01f5a 100644
--- a/man/nss-systemd.xml
+++ b/man/nss-systemd.xml
@@ -108,6 +108,12 @@ lrwxrwxrwx. 1 root root   19 May 10 4711.user-privileged -> foobar.user-privileg
     <filename>/etc/passwd</filename> or <filename>/etc/group</filename> or other account databases. In fact,
     before dropping in these files a reasonable level of care should be taken to avoid user/group name and
     UID/GID conflicts.</para>
+
+    <para>The <filename>systemd-userdb-load-credentials.service</filename> service automatically runs at boot
+    and installs these files from user records passed in via system credentials. See
+    <citerefentry><refentrytitle>userdbctl</refentrytitle><manvolnum>1</manvolnum></citerefentry> and
+    <citerefentry><refentrytitle>systemd.system-credentials</refentrytitle><manvolnum>7</manvolnum></citerefentry>
+    for details.</para>
   </refsect1>
 
   <refsect1>
@@ -186,6 +192,8 @@ vu-rawhide-1000  1637 pts/8    -zsh
       <member><citerefentry><refentrytitle>systemd-userdbd.service</refentrytitle><manvolnum>8</manvolnum></citerefentry></member>
       <member><citerefentry><refentrytitle>systemd-homed.service</refentrytitle><manvolnum>8</manvolnum></citerefentry></member>
       <member><citerefentry><refentrytitle>systemd-machined.service</refentrytitle><manvolnum>8</manvolnum></citerefentry></member>
+      <member><citerefentry><refentrytitle>userdbctl</refentrytitle><manvolnum>1</manvolnum></citerefentry></member>
+      <member><citerefentry><refentrytitle>systemd.system-credentials</refentrytitle><manvolnum>7</manvolnum></citerefentry></member>
       <member><citerefentry project='man-pages'><refentrytitle>nsswitch.conf</refentrytitle><manvolnum>5</manvolnum></citerefentry></member>
       <member><citerefentry project='man-pages'><refentrytitle>getent</refentrytitle><manvolnum>1</manvolnum></citerefentry></member>
     </simplelist></para>