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