diff options
author | Nicholas D Steeves <nsteeves@gmail.com> | 2016-04-23 00:41:30 +0100 |
---|---|---|
committer | Nicholas D Steeves <nsteeves@gmail.com> | 2016-04-23 00:41:30 +0100 |
commit | cec572daccafa1e912cbed363df6f84687778c6f (patch) | |
tree | 7d99ab9f73d25c1ed8eaf6393f6374edf5316b03 /Documentation/btrfs-restore.asciidoc |
btrfs-progs (4.4.1-1.1) unstable; urgency=medium
* Non-maintainer upload.
* New upstream release.
* Rename package to btrfs-progs (Closes: #780081)
* Update standards version to 3.9.7 (no changes needed).
* debian/control: Add "Breaks" per Gianfranco Costamagna's suggestion
* Change lintian override to reflect package rename
* Switch from using postinst and postrm to using triggers
per Christian Seiler's recommendation.
# imported from the archive
Diffstat (limited to 'Documentation/btrfs-restore.asciidoc')
-rw-r--r-- | Documentation/btrfs-restore.asciidoc | 91 |
1 files changed, 91 insertions, 0 deletions
diff --git a/Documentation/btrfs-restore.asciidoc b/Documentation/btrfs-restore.asciidoc new file mode 100644 index 00000000..ec3a08bc --- /dev/null +++ b/Documentation/btrfs-restore.asciidoc @@ -0,0 +1,91 @@ +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) |