diff --git a/man/pam_systemd_home.xml b/man/pam_systemd_home.xml
index 93153b57aa..9fa0e0a7e7 100644
--- a/man/pam_systemd_home.xml
+++ b/man/pam_systemd_home.xml
@@ -17,8 +17,8 @@
pam_systemd_home
- Automatically mount home directories managed by systemd-homed.service on
- login, and unmount them on logout
+ Authenticate users and mount home directories via systemd-homed.service
+
@@ -31,7 +31,11 @@
pam_systemd_home ensures that home directories managed by
systemd-homed.service8
are automatically activated (mounted) on user login, and are deactivated (unmounted) when the last
- session of the user ends.
+ session of the user ends. For such users, it also provides authentication (when per-user disk encryption
+ is used, the disk encryption key is derived from the authentication credential supplied at login time),
+ account management (the JSON user record embedded in
+ the home store contains account details), and implements the updating of the encryption password (which
+ is also used for user authentication).
@@ -93,13 +97,13 @@
Module Types Provided
- The module implements all four PAM operations: (reason: when per-user
- disk encryption is used, the disk encryption key is derived from the authentication credential supplied
- at login time), (reason: systemd-homed.service account
- validity may be configured in more detail than in the traditional Linux user database, and thus needs to
- be verified separately), (user sessions must be tracked, in order to implement
- automatic release when the last session of a managed user is gone), (user
- passwords may be changed through PAM).
+ The module implements all four PAM operations: (reason: to allow
+ authentication using the encrypted data), (reason: users with
+ systemd-homed.service user accounts are described in a JSON user record and may be configured in more detail than
+ in the traditional Linux user database), (user sessions must be tracked in order
+ to implement automatic release when the last session of the user is gone), (to
+ change the encryption password — also used for user authentication — through PAM).