From btrfs Wiki
(Difference between revisions)
Jump to: navigation, search
(Update from git, v4.4)
(remove content)
(6 intermediate revisions by one user not shown)
Line 1: Line 1:
=btrfs-restore(8) Manual Page=
btrfs-restore - try to restore files from a damaged btrfs filesystem image
'''btrfs restore''' [options] <device> <path> | -l <device>
'''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 [[Manpage/btrfs-check|btrfs-check(8)]] or [[Manpage/btrfs-rescue|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:<br />
; -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 &lt;path&gt;.
; -t &lt;bytenr&gt;
: use &lt;bytenr&gt; to read root tree.
; -f &lt;bytenr&gt;
: only restore files that are under specified root whose root bytenr is &lt;bytenr&gt;.
; -u|--super &lt;mirror&gt;
: use given superblock mirror identified by &lt;mirror&gt;, it can be 0,1,2.
; -r|--root &lt;rootid&gt;
: only restore files that are under specified root whose objectid is &lt;rootid&gt;.
; -d
: find dir.
; -l|--list-roots
: list tree roots.
; -D|--dry-run
: dry run (only list files that would be recovered).
; --path-regex &lt;regex&gt;
: restore only filenames matching regex, you have to use following syntax (possibly quoted): <br /><code>^/(|home(|/username(|/Desktop(|/.*))))$</code>
; -c
: ignore case (--path-regex only).
'''btrfs restore''' returns a zero exit status if it succeeds. Non zero is returned in case of failure.
'''btrfs''' is part of btrfs-progs. Please refer to the btrfs wiki for further details.
[[Manpage/mkfs.btrfs|mkfs.btrfs(8)]], [[Manpage/btrfs-rescue|btrfs-rescue(8)]], [[Manpage/btrfs-check|btrfs-check(8)]]

Latest revision as of 12:33, 12 January 2022

Note: manual pages are located at read-the-docs site, please update your links.

Personal tools