X-Git-Url: http://review.tizen.org/git/?a=blobdiff_plain;f=Documentation%2Fbtrfs-inspect-internal.asciidoc;h=62b10294645442cf7df77c1fab29d2900644a5e4;hb=a0abb062181ad97bffc5011fba6920baeee5152e;hp=fae6ed6fd2ff31d68367012703f225fc7e95fcff;hpb=029b2433eb37f275718fe55d819a46244d738eaf;p=platform%2Fupstream%2Fbtrfs-progs.git

diff --git a/Documentation/btrfs-inspect-internal.asciidoc b/Documentation/btrfs-inspect-internal.asciidoc
index fae6ed6..62b1029 100644
--- a/Documentation/btrfs-inspect-internal.asciidoc
+++ b/Documentation/btrfs-inspect-internal.asciidoc
@@ -20,40 +20,46 @@ requires calls to privileged ioctls.
 SUBCOMMAND
 ----------
 *dump-super* [options] <device> [device...]::
-(needs root privileges)
+(replaces the standalone tool *btrfs-show-super*)
 +
-Show btrfs superblock information stored in devices.
-It is used to print the information of superblock,
-you can specify which mirror to print out.
+Show btrfs superblock information stored on given devices in textual form.
+By default the first superblock is printed, more details about all copies or
+additional backup data can be printed.
 +
-By default, every device's first superblock will be printed out.
+Besides verification of the filesystem signature, there are no other sanity
+checks. The superblock checksum status is reported, the device item and
+filesystem UUIDs are checked and reported.
 +
-Mainly used for debug purpose.
+NOTE: the meaning of option '-s' has changed in version 4.8 to be consistent
+with other tools to specify superblock copy rather the offset. The old way still
+works, but prints a warning. Please update your scripts to use '--bytenr'
+instead. The option '-i' has been deprecated.
 +
 `Options`
 +
--f::::
-Print full superblock information.
-+
-Including the system chunk array and backup roots.
-+
--a::::
-Print information of all superblocks.
+-f|--full::::
+print full superblock information, including the system chunk array and backup roots
+-a|--all::::
+print information about all present superblock copies (cannot be used together
+with '-s' option)
+-i <super>::::
+(deprecated since 4.8, same behaviour as '--super')
+--bytenr <bytenr>::::
+specify offset to a superblock in a non-standard location at 'bytenr', useful
+for debugging (disables the '-f' option)
 +
-If this option is given, '-i' option will be ignored.
+If there are multiple options specified, only the last one applies.
 +
--i <super_mirror>::::
-Specify which mirror to print out.
+-F|--force::::
+attempt to print the superblock even if a valid BTRFS signature is not found;
+the result may be completely wrong if the data does not resemble a superblock
 +
-<super_mirror> is between 0 and 2.
-If several '-i <super_mirror>' are given, only the last one is valid.
+-s|--super <bytenr>::::
+(see compatibility note above)
 +
--F::::
-Attempt to print the superblock even if no superblock magic is found.  May end
-badly.
--s <bytenr>::::
-specify offset to a superblock in a non-standard location at 'bytenr', useful
-for debugging (disables the '-f' option)
+specify which mirror to print, valid values are 0, 1 and 2 and the superblock
+must be present on the device with a valid signature, can be used together with
+'--force'
 
 *dump-tree* [options] <device>::
 (replaces the standalone tool *btrfs-debug-tree*)
@@ -141,6 +147,16 @@ inode number 2), but such subvolume does not contain any files anyway
 +
 resolve the absolute path of a the subvolume id 'subvolid'
 
+*tree-stats* [options] <device>::
+(needs root privileges)
++
+Print sizes and statistics of trees.
++
+`Options`
++
+-b::::
+Print raw numbers in bytes.
+
 EXIT STATUS
 -----------
 *btrfs inspect-internal* returns a zero exit status if it succeeds. Non zero is