From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from cn.fujitsu.com ([222.73.24.84]:15832 "EHLO song.cn.fujitsu.com" rhost-flags-OK-FAIL-OK-OK) by vger.kernel.org with ESMTP id S932094Ab3HGF4B (ORCPT ); Wed, 7 Aug 2013 01:56:01 -0400 From: Wang Shilong To: linux-btrfs@vger.kernel.org Cc: dsterba@suse.cz Subject: [v2 8/8] Btrfs-progs: add missing man page for btrfs-map-logical Date: Wed, 7 Aug 2013 13:54:09 +0800 Message-Id: <1375854849-15224-8-git-send-email-wangsl.fnst@cn.fujitsu.com> In-Reply-To: <1375854849-15224-1-git-send-email-wangsl.fnst@cn.fujitsu.com> References: <1375854849-15224-1-git-send-email-wangsl.fnst@cn.fujitsu.com> Sender: linux-btrfs-owner@vger.kernel.org List-ID: Signed-off-by: Wang Shilong Signed-off-by: Qu Wenruo --- V1->V2: GPLv3->GPLv2 --- man/Makefile | 2 +- man/btrfs-map-logical.8.in | 39 +++++++++++++++++++++++++++++++++++++++ 2 files changed, 40 insertions(+), 1 deletion(-) create mode 100644 man/btrfs-map-logical.8.in diff --git a/man/Makefile b/man/Makefile index 5ccb60a..690fa65 100644 --- a/man/Makefile +++ b/man/Makefile @@ -13,7 +13,7 @@ man8dir = $(mandir)/man8 MANPAGES = mkfs.btrfs.8.gz btrfsck.8.gz btrfs-image.8.gz btrfs.8.gz \ btrfs-debug-tree.8.gz btrfs-show-super.8.gz btrfs-find-root.8.gz \ - btrfs-convert.8.gz btrfstune.8.gz btrfs-zero-log.8.gz + btrfs-convert.8.gz btrfstune.8.gz btrfs-zero-log.8.gz btrfs-map-logical.8.gz INFILES = ${MANPAGES:.in=.gz} all: $(MANPAGES) diff --git a/man/btrfs-map-logical.8.in b/man/btrfs-map-logical.8.in new file mode 100644 index 0000000..a18cca4 --- /dev/null +++ b/man/btrfs-map-logical.8.in @@ -0,0 +1,39 @@ +.TH BTRFS-MAP-LOGICAL 8 +.SH NAME +btrfs-map-logical \- map btrfs logical extent to physical extent +.SH SYNOPSIS +.B btrfs-map-logical [\fIoptions\fP] \fI\fP +.SH DESCRIPTION +\fBbtrfs-map-logical\fP can be used to find out what the physical offsets are +on the mirrors, the result is dumped into stdout in default. + +\fIOptions\fP +.IP "\fB-l|--logical \fI\fP" 5 +Logical extent to map. +.IP "\fB-c|--copy \fI\fP" 5 +Copy of the extent to read(usually 1 or 2). +.IP "\fB-o|--output \fI\fP" 5 +Output file to hold the extent. +.IP "\fB-b|--bytes \fI\fP" 5 +Number of bytes to read. + +.SH EXIT CODE +\fBbtrfs-map-logical\fP will return 0 if no error happened. +If any problems happened, 1 will be returned. + +.SH AUTHOR +Written by Shilong Wang and Wenruo Qu. + +.SH COPYRIGHT +Copyright \(co 2013 Fujitsu, Inc. +License GPLv2: GNU GPL version 2 . +.br +This is free software: you are free to change and redistribute it. There is NO WARRANTY, to the extent permitted by law. +.SH AVAILABILITY +.B btrfs-map-logical +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 mkfs.btrfs (8) -- 1.8.0.1