RepoMirrors/btrfs-progs
1
0
Fork 0
mirror of https://github.com/kdave/btrfs-progs synced 2025-04-10 11:11:16 +00:00
Code Issues Packages Projects Releases Wiki Activity

btrfs-progs: docs: add a note on qgroup limit with inconsitent flag

Browse Source 
Just like all qgroup functions, if a qgroup is marked inconsistent, limit
will not work as expected.  In fact with recent kernels, limit and
qgroup number updating will be fully skipped if qgroup is already
inconsistent.

Add one extra note on `btrfs qgroup limit` subcommand for it.

Link: https://bugzilla.suse.com/show_bug.cgi?id=1235765
Reported-by: Vojtech Lacina <vlacina@suse.com>
Signed-off-by: Qu Wenruo <wqu@suse.com>
This commit is contained in:
Qu Wenruo 2025-01-16 09:01:21 +10:30 committed by David Sterba
parent aaf0cf3805
commit 1d694ffaba
1 changed files with 6 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

6
Documentation/btrfs-qgroup.rst
View File

@ -31,6 +31,12 @@ ownership. For example a fresh snapshot shares almost all the blocks with the
original subvolume, new writes to either subvolume will raise towards the
exclusive limit.
.. note::
Qgroup limit only works when qgroup is in a consistent state.
If some workload marks qgroup inconsistent (like assigning a qgroup to another
qgroup), the limit will no longer work until the inconsistent flag is cleared
by :command:`btrfs quota rescan`.
The qgroup identifiers conform to *level/id* where level 0 is reserved to the
qgroups associated with subvolumes. Such qgroups are created automatically.