diff mbox series

btrfs-progs: Doc: Add extra warning for -i option of snapshot creation

Message ID 20200508053304.27723-1-wqu@suse.com (mailing list archive)
State New, archived
Headers show
Series btrfs-progs: Doc: Add extra warning for -i option of snapshot creation | expand

Commit Message

Qu Wenruo May 8, 2020, 5:33 a.m. UTC 
That -i option of snapshot creation can easily make qgroup inconsistent.
And unlike 'btrfs qgroup assign', the ioctl involved doesn't have way to
inform user space that qgroup is inconsistent.

So add extra warning in the man page.

Signed-off-by: Qu Wenruo <wqu@suse.com>
---
 Documentation/btrfs-subvolume.asciidoc | 6 ++++++
 1 file changed, 6 insertions(+)
diff mbox series

Patch

diff --git a/Documentation/btrfs-subvolume.asciidoc b/Documentation/btrfs-subvolume.asciidoc
index 1de6a6febbee..70ecc641e85e 100644
--- a/Documentation/btrfs-subvolume.asciidoc
+++ b/Documentation/btrfs-subvolume.asciidoc
@@ -222,6 +222,12 @@  Make the new snapshot read only.
 -i <qgroupid>::::
 Add the newly created subvolume to a qgroup. This option can be given multiple
 times.
++
+WARNING: This parameter can make qgroup inconsistent, and due to the 
+limitation of snapshot creation ioctl, there is no way to inform user space
+that qgroup is inconsistent due to this operation.
+Please use 'btrfs qgroup assign' instead.
+
 
 *sync* <path> [subvolid...]::
 Wait until given subvolume(s) are completely removed from the filesystem after