diff options
author | David Sterba <dsterba@suse.com> | 2016-03-10 15:18:01 +0100 |
---|---|---|
committer | David Sterba <dsterba@suse.com> | 2016-03-14 13:42:47 +0100 |
commit | 1538bc01adc41dcd742e12283ac5dfe319849705 (patch) | |
tree | 286ea5454950e0d87bb5a40cb840de7e72353229 /Documentation/btrfs-inspect-internal.asciidoc | |
parent | 4088b770e12597cb400b4fc30360f679b35d3c78 (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.asciidoc | 38 |
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) |