2014-04-15 07:04:49 +00:00
|
|
|
btrfs-restore(8)
|
|
|
|
|
================
|
|
|
|
|
|
|
|
|
|
NAME
|
|
|
|
|
----
|
|
|
|
|
btrfs-restore - try to restore files from a damaged btrfs filesystem(unmounted)
|
|
|
|
|
|
|
|
|
|
SYNOPSIS
|
|
|
|
|
--------
|
2014-05-19 15:49:35 +00:00
|
|
|
*btrfs restore* [options] <device> <path> | -l <device>
|
2014-04-15 07:04:49 +00:00
|
|
|
|
|
|
|
|
DESCRIPTION
|
|
|
|
|
-----------
|
2014-05-19 15:49:35 +00:00
|
|
|
*btrfs restore* is used to try to salvage files from a damaged filesystem and
|
2014-04-15 07:04:49 +00:00
|
|
|
restore them into <path> or just list the tree roots.
|
|
|
|
|
|
2014-04-16 16:33:44 +00:00
|
|
|
Since current `btrfs-check`(8) or `btrfs-rescue`(8) only has very limited usage,
|
2014-05-19 15:49:35 +00:00
|
|
|
*btrfs restore* is normally a better choice.
|
2014-04-15 07:04:49 +00:00
|
|
|
|
2014-04-15 07:04:51 +00:00
|
|
|
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
|
|
|
|
|
|
2014-04-15 07:04:49 +00:00
|
|
|
OPTIONS
|
|
|
|
|
-------
|
|
|
|
|
-s::
|
|
|
|
|
get snapshots.
|
|
|
|
|
|
|
|
|
|
-x::
|
|
|
|
|
get extended attributes.
|
|
|
|
|
|
|
|
|
|
-v::
|
|
|
|
|
verbose.
|
|
|
|
|
|
|
|
|
|
-i::
|
|
|
|
|
ignore errors.
|
|
|
|
|
|
|
|
|
|
-o::
|
|
|
|
|
overwrite directories/files in <path>.
|
|
|
|
|
|
|
|
|
|
-t <location>::
|
|
|
|
|
use <location> to read root tree.
|
|
|
|
|
|
|
|
|
|
-f <offset>::
|
|
|
|
|
use <offset> to read fs tree.
|
|
|
|
|
|
|
|
|
|
-u <block>::
|
|
|
|
|
use given superblock mirror identified by <block>.
|
|
|
|
|
|
|
|
|
|
-r <rootid>::
|
|
|
|
|
use <rootid> as root objectid.
|
|
|
|
|
|
|
|
|
|
-d::
|
|
|
|
|
find dir.
|
|
|
|
|
|
|
|
|
|
-l::
|
|
|
|
|
list tree roots.
|
|
|
|
|
|
|
|
|
|
EXIT STATUS
|
|
|
|
|
-----------
|
2014-05-19 15:49:35 +00:00
|
|
|
*btrfs restore* returns a zero exist status if it succeeds. Non zero is
|
2014-04-15 07:04:49 +00:00
|
|
|
returned in case of failure.
|
|
|
|
|
|
|
|
|
|
AVAILABILITY
|
|
|
|
|
------------
|
2014-05-19 16:04:26 +00:00
|
|
|
*btrfs* is part of btrfs-progs.
|
2014-04-15 07:04:49 +00:00
|
|
|
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)
|
