Re: Btrfs-progs: Update man page for mixed data+metadata option.

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

 



On Wed, Nov 10, 2010 at 9:53 PM, Mitch Harder
<mitch.harder@xxxxxxxxxxxxxxxx> wrote:
> On Wed, Nov 10, 2010 at 8:10 PM, Josef Bacik <josef@xxxxxxxxxx> wrote:
>> On Wed, Nov 10, 2010 at 12:02:18PM -0600, Mitch Harder wrote:
>>> Update the mkfs.btrfs man page for the -M option to mix data and
>>> metadata chunks.
>>>
>>> Signed-off-by: Mitch Harder <mitch.harder@xxxxxxxxxxxxxxxx>
>>> ---
>>>  man/mkfs.btrfs.8.in |    5 +++++
>>>  1 files changed, 5 insertions(+), 0 deletions(-)
>>>
>>> diff --git a/man/mkfs.btrfs.8.in b/man/mkfs.btrfs.8.in
>>> index 1e14c6c..c23dddc 100644
>>> --- a/man/mkfs.btrfs.8.in
>>> +++ b/man/mkfs.btrfs.8.in
>>> @@ -9,6 +9,7 @@ mkfs.btrfs \- create an btrfs filesystem
>>>  [ \fB \-l\fP\fI leafsize\fP ]
>>>  [ \fB \-L\fP\fI label\fP ]
>>>  [ \fB \-m\fP\fI metadata profile\fP ]
>>> +[ \fB \-M\fP\fI mixed data+metadata\fP ]
>>>  [ \fB \-n\fP\fI nodesize\fP ]
>>>  [ \fB \-s\fP\fI sectorsize\fP ]
>>>  [ \fB \-h\fP ]
>>> @@ -45,6 +46,10 @@ Specify a label for the filesystem.
>>>  Specify how metadata must be spanned across the devices specified. Valid
>>>  values are raid0, raid1, raid10 or single.
>>>  .TP
>>> +\fB\-M\fR, \fB\-\-mixed\fR
>>> +Mix data and metadata chunks together for more efficient space
>>> +utilization.
>>> +.TP
>>>  \fB\-n\fR, \fB\-\-nodesize \fIsize\fR
>>>  Specify the nodesize. By default the value is set to the pagesize.
>>>  .TP
>>> --
>>> 1.7.2.2
>>
>> Let's mention that it's for smaller filesystems since it has a significant
>> performance impact when using mixed block groups on larger filesystems.  Thanks,
>>
>> Josef
>>
>
> OK, how about:
>
> Mix data and metadata chunks together for more efficient space
> utilization, especially on smaller file systems.  Incurs a performance
> penalty.

in a previous message, Josef had mentioned it was specifically for
<1GB _only_...

if so, wording should probably make it perfectly clear that the option
is totally inappropriate for _anybody_ unless you meet
specific/special criteria.

something like DANGER DANGER WILL ROBINSON :-) unless i'm mistaken of course.

C Anthony
--
To unsubscribe from this list: send the line "unsubscribe linux-btrfs" in
the body of a message to majordomo@xxxxxxxxxxxxxxx
More majordomo info at  http://vger.kernel.org/majordomo-info.html


[Index of Archives]     [Linux Filesystem Development]     [Linux NFS]     [Linux NILFS]     [Linux USB Devel]     [Linux Audio Users]     [Yosemite News]     [Linux Kernel]     [Linux SCSI]

  Powered by Linux