|
|
| (5 intermediate revisions by one user not shown) |
| Line 1: |
Line 1: |
| − | =btrfs-restore(8)=
| |
| | {{GeneratedManpage | | {{GeneratedManpage |
| | |name=btrfs-restore}} | | |name=btrfs-restore}} |
| − |
| |
| − | ==NAME==
| |
| − | btrfs-restore - try to restore files from a damaged btrfs filesystem image
| |
| − |
| |
| − | ==SYNOPSIS==
| |
| − |
| |
| − | <p><b>btrfs restore</b> [options] <emphasis><device></emphasis> <emphasis><path></emphasis> | -l <emphasis><device></emphasis></p>
| |
| − | ==DESCRIPTION==
| |
| − |
| |
| − | <p><b>btrfs restore</b> is used to try to salvage files from a damaged filesystem and
| |
| − | restore them into <emphasis><path></emphasis> or just list the tree roots.</p>
| |
| − | <p>Since current [[Manpage/btrfs-check|btrfs-check(8)]] or [[Manpage/btrfs-rescue|btrfs-rescue(8)]] only has very limited usage,
| |
| − | <b>btrfs restore</b> is normally a better choice.</p>
| |
| − | <blockquote><b>Note:</b>
| |
| − | It is recommended to read the following btrfs wiki page if your data is
| |
| − | not salvaged with default option:<text:line-break/>
| |
| − | https://btrfs.wiki.kernel.org/index.php/Restore</blockquote>
| |
| − | ==OPTIONS==
| |
| − |
| |
| − | <dl>
| |
| − | <dt>
| |
| − | -s|--snapshots
| |
| − | <dd>
| |
| − | <p>
| |
| − | get snapshots, btrfs restore skips snapshots in default.
| |
| − | </p>
| |
| − |
| |
| − | <dt>
| |
| − | -x|--xattr
| |
| − | <dd>
| |
| − | <p>
| |
| − | get extended attributes.
| |
| − | </p>
| |
| − |
| |
| − | <dt>
| |
| − | -m|--metadata
| |
| − | <dd>
| |
| − | <p>
| |
| − | restore owner, mode and times.
| |
| − | </p>
| |
| − |
| |
| − | <dt>
| |
| − | -S|--symlinks
| |
| − | <dd>
| |
| − | <p>
| |
| − | restore symbolic links as well as normal files.
| |
| − | </p>
| |
| − |
| |
| − | <dt>
| |
| − | -v|--verbose
| |
| − | <dd>
| |
| − | <p>
| |
| − | verbose.
| |
| − | </p>
| |
| − |
| |
| − | <dt>
| |
| − | -i|--ignore-errors
| |
| − | <dd>
| |
| − | <p>
| |
| − | ignore errors.
| |
| − | </p>
| |
| − |
| |
| − | <dt>
| |
| − | -o|--overwrite
| |
| − | <dd>
| |
| − | <p>
| |
| − | overwrite directories/files in <emphasis><path></emphasis>.
| |
| − | </p>
| |
| − |
| |
| − | <dt>
| |
| − | -t <emphasis><bytenr></emphasis>
| |
| − | <dd>
| |
| − | <p>
| |
| − | use <emphasis><bytenr></emphasis> to read root tree.
| |
| − | </p>
| |
| − |
| |
| − | <dt>
| |
| − | -f <emphasis><bytenr></emphasis>
| |
| − | <dd>
| |
| − | <p>
| |
| − | only restore files that are under specified root whose root bytenr is <emphasis><bytenr></emphasis>.
| |
| − | </p>
| |
| − |
| |
| − | <dt>
| |
| − | -u|--super <emphasis><mirror></emphasis>
| |
| − | <dd>
| |
| − | <p>
| |
| − | use given superblock mirror identified by <emphasis><mirror></emphasis>, it can be 0,1,2.
| |
| − | </p>
| |
| − |
| |
| − | <dt>
| |
| − | -r|--root <emphasis><rootid></emphasis>
| |
| − | <dd>
| |
| − | <p>
| |
| − | only restore files that are under specified root whose objectid is <emphasis><rootid></emphasis>.
| |
| − | </p>
| |
| − |
| |
| − | <dt>
| |
| − | -d
| |
| − | <dd>
| |
| − | <p>
| |
| − | find dir.
| |
| − | </p>
| |
| − |
| |
| − | <dt>
| |
| − | -l|--list-roots
| |
| − | <dd>
| |
| − | <p>
| |
| − | list tree roots.
| |
| − | </p>
| |
| − |
| |
| − | <dt>
| |
| − | -D|--dry-run
| |
| − | <dd>
| |
| − | <p>
| |
| − | dry run (only list files that would be recovered).
| |
| − | </p>
| |
| − |
| |
| − | <dt>
| |
| − | --path-regex <emphasis><regex></emphasis>
| |
| − | <dd>
| |
| − | <p>
| |
| − | restore only filenames matching regex, you have to use following syntax (possibly quoted):
| |
| − | </p>
| |
| − | <p><tt>^/(|home(|/username(|/Desktop(|/.*))))$</tt></p>
| |
| − |
| |
| − | <dt>
| |
| − | -c
| |
| − | <dd>
| |
| − | <p>
| |
| − | ignore case (--path-regex only).
| |
| − | </p>
| |
| − |
| |
| − | </dl>
| |
| − | ==EXIT STATUS==
| |
| − |
| |
| − | <p><b>btrfs restore</b> returns a zero exit status if it succeeds. Non zero is
| |
| − | returned in case of failure.</p>
| |
| − | ==AVAILABILITY==
| |
| − |
| |
| − | <p><b>btrfs</b> is part of btrfs-progs.
| |
| − | Please refer to the btrfs wiki http://btrfs.wiki.kernel.org for
| |
| − | further details.</p>
| |
| − | ==SEE ALSO==
| |
| − |
| |
| − | <p>[[Manpage/mkfs.btrfs|mkfs.btrfs(8)]],
| |
| − | [[Manpage/btrfs-rescue|btrfs-rescue(8)]],
| |
| − | [[Manpage/btrfs-check|btrfs-check(8)]]</p>
| |
| − | [[Category:Manpage]]
| |
