system/systemd
system/systemd
1
0
Fork 0
mirror of https://github.com/systemd/systemd synced 2024-07-22 10:44:58 +00:00
Code Issues Actions 5 Packages Projects Releases Wiki Activity

man/doc: document auto resize modes

Browse source
This commit is contained in:
Lennart Poettering 2021-11-19 10:55:57 +01:00
parent d26cdde3d4
commit 2f09e2eea1
2 changed files with 26 additions and 0 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

6
docs/USER_RECORD.md
View file

@ -501,6 +501,12 @@ memory cost for the PBKDF operation, when LUKS storage is used, in bytes.
`luksPbkdfParallelThreads` → An unsigned 64bit integer, indicating the intended
required parallel threads for the PBKDF operation, when LUKS storage is used.
`autoResizeMode` → A string, one of `off`, `grow`, `shrink-and-grow`. Unless
set to `off`, controls whether the home area shall be grown automatically to
the size configured in `diskSize` automatically at login time. If set to
`shrink-and-grown` the home area is also shrunk to the minimal size possible
(as dictated by used disk space and file system constraints) on logout.
`service` → A string declaring the service that defines or manages this user
record. It is recommended to use reverse domain name notation for this. For
example, if `systemd-homed` manages a user a string of `io.systemd.Home` is

20
man/homectl.xml
View file

@ -683,6 +683,26 @@
for details on the specific attributes.</para></listitem>
</varlistentry>
<varlistentry>
<term><option>--auto-resize-mode=</option></term>
<listitem><para>Configures whether to automatically grow and/or shrink the backing file system on
login and logout. Takes one of the strings <literal>off</literal>, <literal>grow</literal>,
<literal>shrink-and-grow</literal>. Only applies to the LUKS2 backend currently, and if the btrfs
file system is used inside it (since only then online growing/shrinking of the file system is
supported). Defaults to <literal>shrink-and-grow</literal>, if LUKS2/btrfs is used, otherwise is
off. If set to <literal>off</literal> no automatic shrinking/growing during login or logout is
done. If set to <literal>grow</literal> the home area is grown to the size configured via
<option>--disk-size=</option> should it currently be smaller. If it already matches the configured
size or is larger no operation is executed. If set to <literal>shrink-and-grow</literal> the home
area is also resized to the minimal size used disk space and file system constraints permit, during
logout. This mode thus ensures that while a home area is activated it is sized to the configured
size, but while deactivated it is compacted taking up only the minimal space possible. Note that if
the system is powered off abnormally or if the user otherwise not logged out cleanly the shrinking
operation will not take place, and the user has to re-login/logout again before it is executed
again.</para></listitem>
</varlistentry>
<varlistentry>
<term><option>--nosuid=</option><replaceable>BOOL</replaceable></term>
<term><option>--nodev=</option><replaceable>BOOL</replaceable></term>