On Mon, May 23, 2011 at 02:34:54AM +0400, CoolCold wrote:
> Basing on irc discussions and questions about reading xfs_info output
> I've added example in xfs_growfs manpage.
Alex, Dave, Eric, do you guys have any comments on this? Language
nitpicks from the native speakers? Otherwise I'd be inclined to put it
in.
> Signed-off-by: Roman Ovchinnikov <coolthecold@xxxxxxxxx>
> ---
> man/man8/xfs_growfs.8 | 34 ++++++++++++++++++++++++++++++++++
> 1 files changed, 34 insertions(+), 0 deletions(-)
>
> diff --git a/man/man8/xfs_growfs.8 b/man/man8/xfs_growfs.8
> index 02793ae..c782fc1 100644
> --- a/man/man8/xfs_growfs.8
> +++ b/man/man8/xfs_growfs.8
> @@ -1,3 +1,14 @@
> +.\" Verbatim blocks taken from openssl req manpage content
> +.de Vb \" Begin verbatim text
> +.ft CW
> +.nf
> +.ne \\$1
> +..
> +.de Ve \" End verbatim text
> +.ft R
> +.fi
> +..
> +
> .TH xfs_growfs 8
> .SH NAME
> xfs_growfs, xfs_info \- expand an XFS filesystem
> @@ -105,6 +116,7 @@ this is specified with
> Specifies that no change to the filesystem is to be made.
> The filesystem geometry is printed, and argument checking is performed,
> but no growth occurs.
> +.B See output examples below.
> .TP
> .BI "\-r | \-R " size
> Specifies that the real-time section of the filesystem should be grown. If
> the
> @@ -152,6 +164,28 @@ reside. In order to grow a filesystem, it is
> necessary to provide added
> space for it to occupy. Therefore there must be at least one spare new
> disk partition available. Adding the space is often done through the use
> of a logical volume manager.
> +.SH "EXAMPLES"
> +
> +Examining xfs_info output.
> +.PP
> +Let's assume one have the next xfs_info output:
> +.PP
> +.Vb 1
> +\& meta-data=/dev/sda isize=256 agcount=32, agsize=16777184 blks
> +\& = sectsz=512 attr=2
> +\& data = bsize=4096 blocks=536869888, imaxpct=5
> +\& = sunit=32 swidth=128 blks
> +\& naming =version 2 bsize=4096
> +\& log =internal bsize=4096 blocks=32768, version=2
> +\& = sectsz=512 sunit=32 blks, lazy-count=1
> +\& realtime =none extsz=524288 blocks=0, rtextents=0
> +.Ve
> +.PP
> +
> +Here, data section block size (bsize) is 4096 bytes. Therefore
> +"sunit=32 swidth=128 blks" means stripe unit is 32*4096 bytes = 128 kibibytes
> +and stripe width is 128*4096 bytes = 512 kibibytes. Filesystem is striped
> +over 4 ( 128 / 32 ) stripes.
> .SH SEE ALSO
> .BR mkfs.xfs (8),
> .BR md (4),
> --
> 1.7.2.5
>
> _______________________________________________
> xfs mailing list
> xfs@xxxxxxxxxxx
> http://oss.sgi.com/mailman/listinfo/xfs
---end quoted text---
|