btrfs-progs: docs: add note about mounted filesystem for tree-stats

Clarify that tree-stats can print inaccurate results or warnings when
the filesystem is mounted. Inspired by
https://bugzilla.kernel.org/show_bug.cgi?id=97481 .

Signed-off-by: David Sterba <dsterba@suse.com>
This commit is contained in:
David Sterba 2022-10-04 15:15:33 +02:00
parent 2cdc8dddbf
commit 86bfbc889e

View File

@ -196,7 +196,14 @@ subvolid-resolve <subvolid> <path>
tree-stats [options] <device>
(needs root privileges)
Print sizes and statistics of trees.
Print sizes and statistics of trees. This takes a device as an argument
and not a mount point unlike other commands.
.. note::
In case the the filesystem is still mounted it's possible to
run the command but the results may be inaccurate or various
errors may be printed in case there are ongoing writes to the
filesystem. A warning is printed in such case.
``Options``