summaryrefslogtreecommitdiff
path: root/Documentation/btrfs-inspect-internal.asciidoc
diff options
context:
space:
mode:
authorDavid Sterba <dsterba@suse.com>2016-03-10 15:18:01 +0100
committerDavid Sterba <dsterba@suse.com>2016-03-14 13:42:47 +0100
commit1538bc01adc41dcd742e12283ac5dfe319849705 (patch)
tree286ea5454950e0d87bb5a40cb840de7e72353229 /Documentation/btrfs-inspect-internal.asciidoc
parent4088b770e12597cb400b4fc30360f679b35d3c78 (diff)
btrfs-progs: docs: update dump-tree
Signed-off-by: David Sterba <dsterba@suse.com>
Diffstat (limited to 'Documentation/btrfs-inspect-internal.asciidoc')
-rw-r--r--Documentation/btrfs-inspect-internal.asciidoc38
1 files changed, 21 insertions, 17 deletions
diff --git a/Documentation/btrfs-inspect-internal.asciidoc b/Documentation/btrfs-inspect-internal.asciidoc
index bbbbc597..f19522f4 100644
--- a/Documentation/btrfs-inspect-internal.asciidoc
+++ b/Documentation/btrfs-inspect-internal.asciidoc
@@ -20,29 +20,33 @@ requires calls to privileged ioctls.
SUBCOMMAND
----------
*dump-tree* [options] <device>::
-(needs root privileges)
+(may need root privileges to access the device)
++
+Dump tree structures from a given device in textual form, expand keys to human
+readable equivalents where possible.
+This is useful for analyzing filesystem state or inconsistencies and has
+a positive educational effect on understanding the internal filesystem structure.
+
-Dump the whole tree of the given device.
-This is useful for analyzing filesystem state or inconsistence and has
-a positive educational effect on understanding the internal structure.
-<device> is the device file where the filesystem is stored.
+NOTE: contains file names, consider that if you're asked to send the dump for
+analysis. Does not contain file data.
+
`Options`
+
--e::::
-Print detailed extents info.
--d::::
-Print info of btrfs device and root tree dirs only.
--r::::
-Print info of roots only.
--R::::
-Print info of roots and root backups.
--u::::
-Print info of UUID tree only.
+-e|--extents::::
+print only extent-related information: extent and device trees
+-d|--device::::
+print only device-related information: tree root, chunk and device trees
+-r|--roots::::
+print only short root node information, ie. the root tree keys
+-R|--backups::::
+same as --roots plus print backup root info, ie. the backup root keys and
+the respective tree root block offset
+-u|--uuid::::
+print only the uuid tree information, empty output if the tree does not exist
-b <block_num>::::
-Print info of the specified block only.
+print info of the specified block only
-t <tree_id>::::
-Print only the tree with the specified ID.
+print only the tree with the specified numerical ID
*inode-resolve* [-v] <ino> <path>::
(needs root privileges)