summaryrefslogtreecommitdiffstats
path: root/man
diff options
context:
space:
mode:
authorLennart Poettering <lennart@poettering.net>2020-09-18 19:37:05 +0200
committerLennart Poettering <lennart@poettering.net>2020-09-18 22:35:36 +0200
commitf9d525ae558105bf7fd77ad76e4fdb135bb9f634 (patch)
treea053132b43fd32b75b16a8f539e2dd7ea253aaab /man
parenthomed: make sure our worker processes finish before we exit (diff)
downloadsystemd-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.xml11
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>