summaryrefslogtreecommitdiff
path: root/Documentation/btrfs-restore.txt
blob: c1d1607ae393ffbb4675b562926f340266e474a2 (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
70
71
72
73
74
75
76
btrfs-restore(8)
================

NAME
----
btrfs-restore - try to restore files from a damaged btrfs filesystem(unmounted)

SYNOPSIS
--------
'btrfs restore' [options] <device> <path> | -l <device>

DESCRIPTION
-----------
'btrfs restore' is used to try to salvage files from a damaged filesystem and
restore them into <path> or just list the tree roots.

Since current `btrfs-check`(8) or `btrfs-rescue`(8) only has very limited usage,
'btrfs restore' is normally a better choice.

NOTE: It is recommended to read the following btrfs wiki page if your data is
not salvaged with default option: +
https://btrfs.wiki.kernel.org/index.php/Restore

OPTIONS
-------
-s::
get snapshots.

-x::
get extended attributes.

-v::
verbose.

-i::
ignore errors.

-o::
overwrite directories/files in <path>.

-t <location>::
use <location> to read root tree.

-f <offset>::
use <offset> to read fs tree.

-u <block>::
use given superblock mirror identified by <block>.

-r <rootid>::
use <rootid> as root objectid.

-d::
find dir.

-l::
list tree roots.

EXIT STATUS
-----------
'btrfs restore' 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-rescue`(8),
`btrfs-check`(8)