From 40f023922467c56128fa950f91afc83ac6d15bf4 Mon Sep 17 00:00:00 2001 From: Ilia Ross Date: Fri, 7 Aug 2026 02:29:36 +0200 Subject: [PATCH] Fix comments --- quota/linux-lib.pl | 16 +++++++++------- 1 file changed, 9 insertions(+), 7 deletions(-) diff --git a/quota/linux-lib.pl b/quota/linux-lib.pl index 1b7245ef6..8c9564375 100755 --- a/quota/linux-lib.pl +++ b/quota/linux-lib.pl @@ -1560,9 +1560,10 @@ return defined($_[0]) && $_[0] =~ /^\d+\/\d+$/ ? 1 : 0; Sets the referenced or exclusive byte limit for a Btrfs qgroup. If qgroup is undef, path must be a subvolume and its level-0 qgroup is changed. If bytes -is undef, the limit is removed. If quota enforcement on path or one of its -parent qgroups blocks the transaction, it is temporarily overridden for one -retry. Returns undef on success or an error message on failure. +is undef, the limit is removed. If the qgroup for the subvolume containing +path, or one of its parent qgroups, blocks the transaction, quota enforcement +is temporarily overridden for one retry. Returns undef on success or an error +message on failure. =cut sub set_btrfs_qgroup_limit @@ -1580,10 +1581,11 @@ push(@args, $qgroup) if (defined($qgroup)); push(@args, $path); my ($out, $err) = &run_btrfs_command(1, @args); -# A limit on the command path or one of its parent qgroups can block the -# transaction needed to update any qgroup limit. Retry once with the kernel's -# administrative override, preserving the previous state and restoring -# enforcement immediately after the command. +# If the qgroup for the subvolume containing $path, or one of its parent +# qgroups, is over quota, Btrfs can reject the transaction needed to update any +# qgroup limit. Retry once with the kernel's administrative override, +# preserving the previous state and restoring enforcement immediately after +# the command. if ($err && $err =~ /disk quota exceeded/i) { my $uuid = &btrfs_filesystem_uuid($path); my $sysfs = $btrfs_sysfs_root || "/sys/fs/btrfs";