6 btrfs-restore - try to restore files from a damaged btrfs filesystem(unmounted)
10 *btrfs restore* [options] <device> <path> | -l <device>
14 *btrfs restore* is used to try to salvage files from a damaged filesystem and
15 restore them into <path> or just list the tree roots.
17 Since current `btrfs-check`(8) or `btrfs-rescue`(8) only has very limited usage,
18 *btrfs restore* is normally a better choice.
20 NOTE: It is recommended to read the following btrfs wiki page if your data is
21 not salvaged with default option: +
22 https://btrfs.wiki.kernel.org/index.php/Restore
27 get snapshots, btrfs restore skips snapshots in default.
30 get extended attributes.
39 overwrite directories/files in <path>.
42 use <bytenr> to read root tree.
45 only restore files that are under specified root whose root bytenr is <bytenr>.
48 use given superblock mirror identified by <mirror>, it can be 0,1,2.
51 only restore files that are under specified root whose objectid is <rootid>.
60 dry run (only list files that would be recovered).
62 --path-regex <regex>::
63 restore only filenames matching regex, you have to use following syntax (possibly quoted):
65 +^/(|home(|/username(|/Desktop(|/.*))))$+
68 ignore case (--path-regrex only).
72 *btrfs restore* returns a zero exit status if it succeeds. Non zero is
73 returned in case of failure.
77 *btrfs* is part of btrfs-progs.
78 Please refer to the btrfs wiki http://btrfs.wiki.kernel.org for