Convert man page for btrfs-restore, which I forgot to convert in the previous patchset. :P
Signed-off-by: Qu Wenruo <quwen...@cn.fujitsu.com> --- Documentation/Makefile | 1 + Documentation/btrfs-restore.txt | 72 +++++++++++++++++++++++++++++++++++++++++ 2 files changed, 73 insertions(+) create mode 100644 Documentation/btrfs-restore.txt diff --git a/Documentation/Makefile b/Documentation/Makefile index 97a775a..dfacb93 100644 --- a/Documentation/Makefile +++ b/Documentation/Makefile @@ -30,6 +30,7 @@ MAN8_TXT += btrfs-quota.txt MAN8_TXT += btrfs-qgroup.txt MAN8_TXT += btrfs-replace.txt MAN8_TXT += btrfs-dedup.txt +MAN8_TXT += btrfs-restore.txt MAN_TXT = $(MAN8_TXT) MAN_XML = $(patsubst %.txt,%.xml,$(MAN_TXT)) diff --git a/Documentation/btrfs-restore.txt b/Documentation/btrfs-restore.txt new file mode 100644 index 0000000..ea18ebb --- /dev/null +++ b/Documentation/btrfs-restore.txt @@ -0,0 +1,72 @@ +btrfs-restore(8) +================ + +NAME +---- +btrfs-restore - try to restore files from a damaged btrfs filesystem(unmounted) + +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 `btrfsck`(8) or `btrfs-rescue`(8) only has very limited usage, +'btrfs restore' is normally a better choice. + +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 +----------- +'btrfs restore' returns a zero exist status if it succeeds. Non zero is +returned in case of failure. + +AVAILABILITY +------------ +'btrfs' is part of btrfs-progs. Btrfs filesystem is currently under heavy +development, +and not suitable for any uses other than benchmarking and review. +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) -- 1.9.2 -- To unsubscribe from this list: send the line "unsubscribe linux-btrfs" in the body of a message to majord...@vger.kernel.org More majordomo info at http://vger.kernel.org/majordomo-info.html
