diff --git a/man/userdbctl.xml b/man/userdbctl.xml
index 896ad222565..0871306b202 100644
--- a/man/userdbctl.xml
+++ b/man/userdbctl.xml
@@ -39,7 +39,10 @@
url="https://systemd.io/USER_RECORD">JSON User Records and JSON Group Records definitions), and classic UNIX NSS/glibc
user and group records. This tool is primarily a client to the User/Group Record Lookup API via Varlink.
+ url="https://systemd.io/USER_GROUP_API">User/Group Record Lookup API via Varlink, and may also
+ pick up drop-in JSON user and group records from /etc/userdb/,
+ /run/userdb/, /run/host/userdb/,
+ /use/lib/userdb/.
@@ -86,6 +89,27 @@
are included in the output (which is the default).
+
+ BOOL
+
+ Controls whether to include Varlink user/group lookups in the output, i.e. those done
+ via the User/Group Record Lookup API via
+ Varlink. If is used any attempts to resolve or enumerate
+ users/groups provided only via Varlink are suppressed. If is
+ specified such users/groups are included in the output (which is the default).
+
+
+
+ BOOL
+
+ Controls whether to include user/group lookups in the output that are defined using
+ drop-in files in /etc/userdb/, /run/userdb/,
+ /run/host/userdb/, /use/lib/userdb/. If
+ is used these records are suppressed. If
+ is specified such users/groups are included in the output (which
+ is the default).
+
+
BOOL
@@ -228,6 +252,17 @@
data, however the NSS/glibc APIs necessarily expose a more reduced set of fields
only.
+
+
+ io.systemd.DropIn
+
+ This service is (also) provided by
+ systemd-userdbd.service8
+ and picks up JSON user/group records from /etc/userdb/,
+ /run/userdb/, /run/host/userdb/,
+ /use/lib/userdb/.
+
+
Note that userdbctl has internal support for NSS-based lookups too. This means