diff options
author | Lennart Poettering <lennart@poettering.net> | 2020-09-18 19:37:05 +0200 |
---|---|---|
committer | Lennart Poettering <lennart@poettering.net> | 2020-09-18 22:35:36 +0200 |
commit | f9d525ae558105bf7fd77ad76e4fdb135bb9f634 (patch) | |
tree | a053132b43fd32b75b16a8f539e2dd7ea253aaab /man | |
parent | homed: make sure our worker processes finish before we exit (diff) | |
download | systemd-f9d525ae558105bf7fd77ad76e4fdb135bb9f634.tar.xz systemd-f9d525ae558105bf7fd77ad76e4fdb135bb9f634.zip |
homed: make clean that --storage=directory --image-path=/dev/some-block-device is not supported
The directory backend needs a file system path, and not a raw block
device. That's only supported for the LUKS2 backend.
Let's make this clearer in the man page and also generate a better error
message if attempted anyway.
Fixes: #17068
Diffstat (limited to 'man')
-rw-r--r-- | man/homectl.xml | 11 |
1 files changed, 7 insertions, 4 deletions
diff --git a/man/homectl.xml b/man/homectl.xml index 4c792ca8cb..dd16e47beb 100644 --- a/man/homectl.xml +++ b/man/homectl.xml @@ -566,10 +566,13 @@ <listitem><para>Takes a file system path. Configures where to place the user's home directory. When LUKS2 storage is used refers to the path to the loopback file, otherwise to the path to the home - directory. When unspecified defaults to <filename>/home/$USER.home</filename> when LUKS storage is - used and <filename>/home/$USER.homedir</filename> for the other storage mechanisms. Not defined for - the <literal>cifs</literal> storage mechanism. To use LUKS2 storage on a regular block device (for - example a USB stick) pass the path to the block device here.</para></listitem> + directory (which may be in <filename>/home/</filename> or any other accessible filesystem). When + unspecified defaults to <filename>/home/$USER.home</filename> when LUKS storage is used and + <filename>/home/$USER.homedir</filename> for the other storage mechanisms. Not defined for the + <literal>cifs</literal> storage mechanism. To use LUKS2 storage on a regular block device (for + example a USB stick) pass the path to the block device here. Specifying the path to a directory here + when using LUKS2 storage is not allowed. Similar, specifying the path to a regular file or device + node is not allowed if any of the other storage backends are used.</para></listitem> </varlistentry> <varlistentry> |