btrfs-restore(8) ================ NAME ---- btrfs-restore - try to restore files from a damaged btrfs filesystem(unmounted) SYNOPSIS -------- *btrfs restore* [options] | -l DESCRIPTION ----------- *btrfs restore* is used to try to salvage files from a damaged filesystem and restore them into 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 . -t :: use to read root tree. -f :: only restore files that are under specified root whose root bytenr is . -u :: use given superblock mirror identified by , it can be 0,1,2. -r :: only restore files that are under specified root whose objectid is . -d:: find dir. -l:: list tree roots. -D|--dry-run:: dry run (only list files that would be recovered). --path-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)