summaryrefslogtreecommitdiff
path: root/Documentation/btrfs-inspect-internal.txt
blob: 5ae4997b9bc03d5a01979dfd09f6701ab19cb2e8 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
btrfs-inspect-internal(8)
=========================

NAME
----
btrfs-inspect-internal - resolve different btrfs items for debug purpose

SYNOPSIS
--------
*btrfs inspect-internal* <subcommand> <args>

DESCRIPTION
-----------
*btrfs inspect-internal* is used to resolve different items for debug purpose.

SUBCOMMAND
----------
*inode-resolve* [-v] <inode> <path>::
Resolves an <inode> in subvolume <path> to all filesystem paths.
+
`Options`
+
-v::::
verbose mode. print count of returned paths and ioctl() return value

*logical-resolve* [-Pv] [-s <bufsize>] <logical> <path>::
Resolves a <logical> address in the filesystem mounted at <path> to all inodes.
+
By default, each inode is then resolved to a file system path (similar to the
inode-resolve subcommand).
+
`Options`
+
-P::::
skip the path resolving and print the inodes instead
-v::::
verbose mode. print count of returned paths and all ioctl() return values
-s <bufsize>::::
set inode container's size.
+
This is used to increase inode container's size in case it is
not enough to read all the resolved results. The max value one can set is 64k.

*subvolid-resolve* <subvolid> <path>::
Get file system paths for the given subvolume ID.

*rootid* <path>::
For a given file or directory, return the containing tree root id. For a
subvolume return it's own tree id.
+
The result is undefined for the so-called empty subvolumes (identified by inode number 2).

EXIT STATUS
-----------
*btrfs inspect-internal* returns a zero exist status if it succeeds. Non zero is
returned in case of failure.

AVAILABILITY
------------
*btrfs* is part of btrfs-progs.
Please refer to the btrfs wiki http://btrfs.wiki.kernel.org for
further details.

SEE ALSO
--------
`mkfs.btrfs`(8),
`btrfs-debug-tree`(8)