From bf2b9d2ba459d43b150f5ad36ff0f2c8b0264f88 Mon Sep 17 00:00:00 2001 From: Peng Tao Date: Wed, 3 Jun 2009 12:00:20 -0400 Subject: [PATCH] Add btrfs-image man page Signed-off-by: Peng Tao Signed-off-by: Chris Mason --- man/Makefile | 5 ++++- man/btrfs-image.8.in | 34 ++++++++++++++++++++++++++++++++++ 2 files changed, 38 insertions(+), 1 deletion(-) create mode 100644 man/btrfs-image.8.in diff --git a/man/Makefile b/man/Makefile index 2665dd1..b7a7340 100644 --- a/man/Makefile +++ b/man/Makefile @@ -6,7 +6,7 @@ bindir = $(prefix)/bin mandir = $(prefix)/man man8dir = $(mandir)/man8 -MANPAGES = mkfs.btrfs.8.gz btrfsctl.8.gz btrfsck.8.gz +MANPAGES = mkfs.btrfs.8.gz btrfsctl.8.gz btrfsck.8.gz btrfs-image.8.gz all: $(MANPAGES) @@ -19,6 +19,9 @@ btrfsctl.8.gz: btrfsctl.8.in btrfsck.8.gz: btrfsck.8.in $(GZIP) -n -c btrfsck.8.in > btrfsck.8.gz +btrfs-image.8.gz: btrfs-image.8.in + $(GZIP) -n -c btrfs-image.8.in > btrfs-image.8.gz + clean : rm -f $(MANPAGES) diff --git a/man/btrfs-image.8.in b/man/btrfs-image.8.in new file mode 100644 index 0000000..722c433 --- /dev/null +++ b/man/btrfs-image.8.in @@ -0,0 +1,34 @@ +.TH MKFS.BTRFS 8 +.SH NAME +btrfs-image \- create/restore an image of the filesystem +.SH SYNOPSIS +.B btrfs-image +[options] \fIsource\fP \fItarget\fP +.SH DESCRIPTION +.B btrfs-image +is used to create an image of a btrfs filesystem. All data will be zeroed, +but metadata and the like is preserved. +.I source +is the special file corresponding to the device containing a btrfs filesystem. +(e.g \fI/dev/sdXX\fP). +.I target +is the image file that btrfs-image creates. When used with \fB-r\fP option, +\fBbtrfs-image\fP restores the image file from source into target. +.SH OPTIONS +.TP +\fB\-r\fP +restore metadump image. +.TP +\fB\-c\fR \fIvalue\fP +compression level (0 ~ 9). +.TP +\fB\-t\fR \fIvalue\fP +number of threads (1 ~ 32) to be used to process the image dump or restore. +.SH AVAILABILITY +.B btrfs-image +is part of btrfs-progs. Btrfs 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. +.SH SEE ALSO +.BR btrfsck (8), btrfsctl (8), mkfs.btrfs (8) -- 2.7.4