blob: 2fa280181f39511037b28124b7d1f0467cb2e27a (
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
77
78
79
80
81
82
83
84
|
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, btrfs restore skips snapshots in default.
-x::
get extended attributes.
-v::
verbose.
-i::
ignore errors.
-o::
overwrite directories/files in <path>.
-t <bytenr>::
use <bytenr> to read root tree.
-f <bytenr>::
only restore files that are under specified root whose root bytenr is <bytenr>.
-u <mirror>::
use given superblock mirror identified by <mirror>, it can be 0,1,2.
-r <rootid>::
only restore files that are under specified root whose objectid is <rootid>.
-d::
find dir.
-l::
list tree roots.
-D|--dry-run::
dry run (only list files that would be recovered).
--path-regex <regex>::
restore only filenames matching regex, you have to use following syntax (possibly quoted):
^/(|home(|/username(|/Desktop(|/.*))))$
-c::
ignore case (--path-regrex only).
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.
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)
|
