diff mbox series

[v2,4/4] man: add -b option to e2image

Message ID 20171116135546.9991-5-artem.blagodarenko@gmail.com
State Superseded, archived
Headers show
Series e2image -b option to pass superblock number | expand

Commit Message

Artem Blagodarenko Nov. 16, 2017, 1:55 p.m. UTC
From: Artem Blagodarenko <artem.blagodarenko@seagate.com>

Add manual page for e2image -b option.

Signed-off-by: Artem Blagodarenko <artem.blagodarenko@gmail.com>
---
 misc/e2image.8.in | 32 ++++++++++++++++++++++++++++++++
 1 file changed, 32 insertions(+)

Comments

Andreas Dilger Nov. 20, 2017, 7:59 p.m. UTC | #1
On Nov 16, 2017, at 6:55 AM, Artem Blagodarenko <artem.blagodarenko@gmail.com> wrote:
> 
> From: Artem Blagodarenko <artem.blagodarenko@seagate.com>
> 
> Add manual page for e2image -b option.
> 
> Signed-off-by: Artem Blagodarenko <artem.blagodarenko@gmail.com>

Personally, I would include this into the patch that adds this option,
but it looks fine as-is.

Reviewed-by: Andreas Dilger <adilger@dilger.ca>

> ---
> misc/e2image.8.in | 32 ++++++++++++++++++++++++++++++++
> 1 file changed, 32 insertions(+)
> 
> diff --git a/misc/e2image.8.in b/misc/e2image.8.in
> index f28a76ea..d6125bb4 100644
> --- a/misc/e2image.8.in
> +++ b/misc/e2image.8.in
> @@ -11,6 +11,14 @@ e2image \- Save critical ext2/ext3/ext4 filesystem metadata to a file
> .B \-r|Q
> ]
> [
> +.B \-b
> +.I superblock
> +]
> +[
> +.B \-B
> +.I blocksize
> +]
> +[
> .B \-fr
> ]
> .I device
> @@ -167,6 +175,22 @@ the
> option will prevent analysis of problems related to hash-tree indexed
> directories.
> .PP
> +Option
> +.B \-b
> +.I superblock
> +can be used to get image from partition with broken primary superblock.
> +The partition is copied as is including broken primary superblock.
> +.PP
> +Option
> +.B \-B
> +.I blocksize
> +can be used to set superblock block size. Normally,  e2fsck  will  search
> +for  the superblock at various different block sizes in an attempt to find
> +the appropriate blocksize. This search can be fooled in some cases.  This
> +option forces e2fsck to only try locating the superblock at a particular
> +blocksize. If the superblock is not found, e2fsck will terminate with a
> +fatal error.
> +.PP
> Note that this will work even if you substitute "/dev/hda1" for another raw
> disk image, or QCOW2 image previously created by
> .BR e2image .
> @@ -217,6 +241,14 @@ This can be useful to write a qcow2 image containing all data to a
> sparse image file where it can be loop mounted, or to a disk partition.
> Note that this may not work with qcow2 images not generated by e2image.
> .PP
> +Options
> +.B \-b
> +.I superblock
> +and
> +.B \-B
> +.I blocksize
> +can be used same way as for raw images.
> +.PP
> .SH INCLUDING DATA
> Normally
> .B e2image
> --
> 2.13.6 (Apple Git-96)
> 


Cheers, Andreas
diff mbox series

Patch

diff --git a/misc/e2image.8.in b/misc/e2image.8.in
index f28a76ea..d6125bb4 100644
--- a/misc/e2image.8.in
+++ b/misc/e2image.8.in
@@ -11,6 +11,14 @@  e2image \- Save critical ext2/ext3/ext4 filesystem metadata to a file
 .B \-r|Q
 ]
 [
+.B \-b
+.I superblock
+]
+[
+.B \-B
+.I blocksize
+]
+[
 .B \-fr
 ]
 .I device
@@ -167,6 +175,22 @@  the
 option will prevent analysis of problems related to hash-tree indexed
 directories.
 .PP
+Option
+.B \-b
+.I superblock
+can be used to get image from partition with broken primary superblock.
+The partition is copied as is including broken primary superblock.
+.PP
+Option
+.B \-B
+.I blocksize
+can be used to set superblock block size. Normally,  e2fsck  will  search
+for  the superblock at various different block sizes in an attempt to find
+the appropriate blocksize. This search can be fooled in some cases.  This
+option forces e2fsck to only try locating the superblock at a particular
+blocksize. If the superblock is not found, e2fsck will terminate with a
+fatal error.
+.PP
 Note that this will work even if you substitute "/dev/hda1" for another raw
 disk image, or QCOW2 image previously created by
 .BR e2image .
@@ -217,6 +241,14 @@  This can be useful to write a qcow2 image containing all data to a
 sparse image file where it can be loop mounted, or to a disk partition.
 Note that this may not work with qcow2 images not generated by e2image.
 .PP
+Options
+.B \-b
+.I superblock
+and
+.B \-B
+.I blocksize
+can be used same way as for raw images.
+.PP
 .SH INCLUDING DATA
 Normally
 .B e2image