RepoMirrors/btrfs-progs
1
0
Fork 0
mirror of https://github.com/kdave/btrfs-progs synced 2025-01-08 22:49:34 +00:00
Code Issues Packages Projects Releases Wiki Activity

btrfs-progs: docs: add qgroup examples

Browse Source 
This patch adds examples section in btrfs-qgroup documentation.
The example make a quota group that has two subvolumes as children.

Signed-off-by: Sidong Yang <realwakka@gmail.com>
Signed-off-by: David Sterba <dsterba@suse.com>
This commit is contained in:
Sidong Yang 2020-09-20 16:41:26 +00:00 committed by David Sterba
parent 70411ea81b
commit 4179885cf9
1 changed files with 55 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

55
Documentation/btrfs-qgroup.asciidoc
View File

@ -160,6 +160,61 @@ However there are cases where we can avoid a full rescan, if a subvolume whose
owned, then assigning/removing this subvolume only needs to add/subtract 'rfer'
number from its parent qgroup. This can speed up the rescan.
EXAMPLES
--------
.Make a parent group that has two quota group children
====
Given the following filesystem mounted at `/mnt/my-vault`
----
Label: none uuid: 60d2ab3b-941a-4f22-8d1a-315f329797b2
Total devices 1 FS bytes used 128.00KiB
devid 1 size 5.00GiB used 536.00MiB path /dev/vdb
----
Enable quota and create subvolumes. Check subvolume ids.
[source,bash]
----
$ cd /mnt/my-vault
$ btrfs quota enable .
$ btrfs subvolume create a
$ btrfs subvolume create b
$ btrfs subvolume list .
ID 261 gen 61 top level 5 path a
ID 262 gen 62 top level 5 path b
----
Create qgroup and set limit to 10MiB.
[source,bash]
----
$ btrfs qgroup create 1/100 .
$ btrfs qgroup limit 10M 1/100 .
$ btrfs qgroup assign 0/261 1/100 .
$ btrfs qgroup assign 0/262 1/100 .
----
And check qgroups.
[source,bash]
----
$ btrfs qgroup show .
qgroupid rfer excl
-------- ---- ----
0/5 16.00KiB 16.00KiB
0/261 16.00KiB 16.00KiB
0/262 16.00KiB 16.00KiB
1/100 32.00KiB 32.00KiB
----
====
EXIT STATUS
-----------
*btrfs qgroup* returns a zero exit status if it succeeds. Non zero is