summaryrefslogtreecommitdiff
path: root/Documentation/btrfs-inspect-internal.txt
blob: c5f751dc4f71c81b10a5dd6a3198493110e60e73 (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
68
69
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. Btrfs filesystem is currently under heavy
development,
and not suitable for any uses other than benchmarking and review.
Please refer to the btrfs wiki http://btrfs.wiki.kernel.org for
further details.

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