From 21505c937ce3bcb90aae85366a262462ec8fb6b2 Mon Sep 17 00:00:00 2001 From: Lennart Poettering Date: Thu, 4 Nov 2021 18:12:13 +0100 Subject: homectl: expose new rebalanceWeight JSON use record field --- man/homectl.xml | 22 ++++++++++++++++++++-- 1 file changed, 20 insertions(+), 2 deletions(-) (limited to 'man/homectl.xml') diff --git a/man/homectl.xml b/man/homectl.xml index 5ba93bbe13..ca9225a1e0 100644 --- a/man/homectl.xml +++ b/man/homectl.xml @@ -376,8 +376,8 @@ Note that FIDO2 devices suitable for this option must implement the hmac-secret extension. Most current devices (such as the YubiKey 5 series) do. If the extension is not implemented the device cannot be used for unlocking home directories. - - The FIDO2 device may be subsequently removed by setting the device path to an empty string + + The FIDO2 device may be subsequently removed by setting the device path to an empty string (e.g. homectl update $USER --fido2-device=""). Note that many hardware security tokens implement both FIDO2 and PKCS#11/PIV (and thus may be @@ -706,6 +706,24 @@ again. + + + + Configures the weight parameter for the free disk space rebalancing logic. Only + applies to the LUKS2 backend (since for the LUKS2 backend disk space is allocated from a per-user + loopback file system instead of immediately from a common pool like the other backends do it). In + regular intervals free disk space in the active home areas and their backing storage is redistributed + among them, taking the weight value configured here into account. Expects an integer in the range + 1…10000, or the special string off. If not specified defaults to 100. The weight + is used to scale free space made available to the home areas: a home area with a weight of 200 will + get twice the free space as one with a weight of 100; a home area with a weight of 50 will get half + of that. The backing file system will be assigned space for a weight of 20. If set to + off no automatic free space distribution is done for this home area. Note that + resizing the home area explicitly (with homectl resize see below) will implicitly + turn off the automatic rebalancing. To reenable the automatic rebalancing use + with an empty parameter. + + BOOL BOOL -- cgit v1.2.3