btrfs-restore (8)
Leading comments
Title: btrfs-restore
Author: [FIXME: author] [see http://docbook.sf.net/el/author]
Generator: DocBook XSL Stylesheets v1.79.0 <http://docbook.sf.net/>
Date: 07/28/2017
Manual: Btrfs Manual
Source: Btrfs v4.12
Language: English
NAME
btrfs-restore - try to restore files from a damaged btrfs filesystem imageSYNOPSIS
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: m[blue]btrfs.wiki.kernel.org/index.php/Restorem[]
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 <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|--super <mirror>
- use given superblock mirror identified by <mirror>, it can be 0,1,2.
-r|--root <rootid>
- only restore files that are under specified root whose objectid is <rootid>.
-d
- find dir.
-l|--list-roots
- 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-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 m[blue]btrfs.wiki.kernel.orgm[] for further details.