btrfs-restore(8) ================ NAME ---- btrfs-restore - try to restore files from a damaged btrfs filesystem image 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|--snapshots:: get snapshots, btrfs restore skips snapshots in default. -x|--xattr:: get extended attributes. -m|--metadata:: restore owner, mode and times. -S|--symlinks:: restore symbolic links as well as normal files. -v|--verbose:: verbose. -i|--ignore-errors:: ignore errors. -o|--overwrite:: overwrite directories/files in . -t :: use to read root tree. -f :: only restore files that are under specified root whose root bytenr is . -u|--super :: use given superblock mirror identified by , it can be 0,1,2. -r|--root :: only restore files that are under specified root whose objectid is . -d:: find dir. -l|--list-roots:: 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-regex only). EXIT STATUS ----------- *btrfs restore* returns a zero exit 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)