Manpage/btrfs-restore

From btrfs Wiki
(Difference between revisions)
Jump to: navigation, search
(Update from git, v4.2)
(remove content)
 
(8 intermediate revisions by one user not shown)
Line 1: Line 1:
=btrfs-restore(8) Manual Page=
 
 
{{GeneratedManpage
 
{{GeneratedManpage
 
|name=btrfs-restore}}
 
|name=btrfs-restore}}
 
==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 [[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 />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 &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).
 
 
==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==
 
 
[[Manpage/mkfs.btrfs|mkfs.btrfs(8)]], [[Manpage/btrfs-rescue|btrfs-rescue(8)]], [[Manpage/btrfs-check|btrfs-check(8)]]
 
 
[[Category:Manpage]]
 

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