92 lines
1.9 KiB
Plaintext
92 lines
1.9 KiB
Plaintext
btrfs-restore(8)
|
|
================
|
|
|
|
NAME
|
|
----
|
|
btrfs-restore - try to restore files from a damaged btrfs filesystem image
|
|
|
|
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|--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 http://btrfs.wiki.kernel.org for
|
|
further details.
|
|
|
|
SEE ALSO
|
|
--------
|
|
`mkfs.btrfs`(8),
|
|
`btrfs-rescue`(8),
|
|
`btrfs-check`(8)
|