xfs
[Top] [All Lists]

Re: [PATCH] mkfs: add missing noalign suboption information

To: Carlos Maiolino <cmaiolino@xxxxxxxxxx>
Subject: Re: [PATCH] mkfs: add missing noalign suboption information
From: Eric Sandeen <sandeen@xxxxxxxxxxx>
Date: Mon, 08 Jul 2013 19:01:37 -0500
Cc: xfs@xxxxxxxxxxx
Delivered-to: xfs@xxxxxxxxxxx
In-reply-to: <1373327110-5533-1-git-send-email-cmaiolino@xxxxxxxxxx>
References: <1373327110-5533-1-git-send-email-cmaiolino@xxxxxxxxxx>
User-agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10.8; rv:17.0) Gecko/20130620 Thunderbird/17.0.7
On 7/8/13 6:45 PM, Carlos Maiolino wrote:
> Adds to the mkfs man page, information about noalign mkfs option which is
> missing until now.
> 
> Signed-off-by: Carlos Maiolino <cmaiolino@xxxxxxxxxx>
> ---
>  man/man8/mkfs.xfs.8 | 6 ++++++
>  1 file changed, 6 insertions(+)
> 
> diff --git a/man/man8/mkfs.xfs.8 b/man/man8/mkfs.xfs.8
> index 04c19b4..2435814 100644
> --- a/man/man8/mkfs.xfs.8
> +++ b/man/man8/mkfs.xfs.8
> @@ -244,6 +244,12 @@ will automatically query the logical volume for 
> appropriate
>  and
>  .B swidth
>  values.
> +.TP
> +.BI noalign
> +This option is used to bypass data alignment configuration. In rare
> +circunstances, data alignment might decrease performance, for such cases,
> +use this option to avoid data alignment, this will set stripe unit and
> +stripe width to 0.

Thanks for this, Carlos.

I think it might be better to just state plainly that it overrides automatic
stripe unit detection, and leave the tuning / performance parts out.
Most of the manpage today is more "what" than "why."

So maybe simply:

+This option disables automatic stripe geometry detection, and creates
+the filesystem without stripe geometry even if the underlying storage
+device reports this information.

FWIW, there is a 'noalign' option for the realtime subvolume
as well, and that should probably get documented too.

-Eric

>  .RE
>  .TP
>  .B \-f
> 

<Prev in Thread] Current Thread [Next in Thread>