diff --git a/man/directives-template.xml b/man/directives-template.xml index 5ab0beb4cf..5038061467 100644 --- a/man/directives-template.xml +++ b/man/directives-template.xml @@ -51,6 +51,15 @@ + + Home Area/User Account directives + + Directives for configuring home areas and user accounts via + systemd-homed.service8. + + + + UDEV directives diff --git a/man/homectl.xml b/man/homectl.xml index 632c8b95bb..14877a0cde 100644 --- a/man/homectl.xml +++ b/man/homectl.xml @@ -504,9 +504,9 @@ Selects the storage mechanism to use for this home directory. Takes one of luks, fscrypt, directory, subvolume, cifs. For details about these mechanisms, see - above. If a new home directory is created and the storage type is not specifically specified defaults - to luks if supported, subvolume as first fallback if supported, - and directory if not. + above. If a new home directory is created and the storage type is not specifically specified, + homed.conf5 + defines which default storage to use. @@ -525,9 +525,10 @@ When LUKS2 storage is used configures the file system type to use inside the home directory LUKS2 container. One of ext4, xfs, - btrfs. If not specified defaults to ext4. Note that - xfs is not recommended as its support for file system resizing is too - limited. + btrfs. If not specified + homed.conf5 + defines which default file system type to use. Note that xfs is not recommended as + its support for file system resizing is too limited. @@ -837,6 +838,7 @@ homectl update lafcadio --pkcs11-token-uri=… systemd1, systemd-homed.service8, + homed.conf5, userdbctl1, useradd8, cryptsetup8 diff --git a/man/homed.conf.xml b/man/homed.conf.xml new file mode 100644 index 0000000000..03590feeaa --- /dev/null +++ b/man/homed.conf.xml @@ -0,0 +1,84 @@ + + + + + + + homed.conf + systemd + + + + homed.conf + 5 + + + + homed.conf + homed.conf.d + Home area/user account manager configuration files + + + + /etc/systemd/homed.conf + /etc/systemd/homed.conf.d/*.conf + /run/systemd/homed.conf.d/*.conf + /usr/lib/systemd/homed.conf.d/*.conf + + + + Description + + These configuration files control default parameters for home areas/user accounts created and + managed by + systemd-homed.service8. + + + + + + + Options + + The following options are available in the [Home] section: + + + + + DefaultStorage= + The default storage to use for home areas. Takes one of luks, + fscrypt, directory, subvolume, + cifs. For details about these options, see + homectl1. If not + configured or assigned the empty string, the default storage is automatically determined: if not + running in a container enviroment and /home/ is not itself encrypted, defaults + to luks. Otherwise defaults to subvolume if + /home/ is on a btrfs file system, and directory + otherwise. Note that the storage selected on the homectl command line always takes + precedence. + + + + DefaultFileSystemType= + When using luks as storage (see above), selects the default file + system to use inside the user's LUKS volume. Takes one of ext4, + xfs or btrfs. If not specified defaults to + ext4. This setting has no effect if a different storage mechanism is used. The + file system type selected on the homectl command line always takes + precedence. + + + + + + + See Also + + systemd1, + systemd-homed.service8 + + + + diff --git a/man/rules/meson.build b/man/rules/meson.build index 5bbee35e9f..941e248d72 100644 --- a/man/rules/meson.build +++ b/man/rules/meson.build @@ -18,6 +18,7 @@ manpages = [ ['file-hierarchy', '7', [], ''], ['halt', '8', ['poweroff', 'reboot'], ''], ['homectl', '1', [], 'ENABLE_HOMED'], + ['homed.conf', '5', ['homed.conf.d'], 'ENABLE_RESOLVE'], ['hostname', '5', [], ''], ['hostnamectl', '1', [], 'ENABLE_HOSTNAMED'], ['hwdb', '7', [], 'ENABLE_HWDB'], diff --git a/man/systemd-homed.service.xml b/man/systemd-homed.service.xml index a51bd36d41..049b7e9097 100644 --- a/man/systemd-homed.service.xml +++ b/man/systemd-homed.service.xml @@ -100,6 +100,7 @@ See Also systemd1, + homed.conf5, homectl1, pam_systemd_home8, userdbctl1