linux-kernel - Re: [PATCH] xfs: remove duplicate Zoned Filesystems sections in admin-guide

lists.openwall.net		lists / announce owl-users owl-dev john-users john-dev passwdqc-users yescrypt popa3d-users / oss-security kernel-hardening musl sabotage tlsify passwords / crypt-dev xvendor / Bugtraq Full-Disclosure linux-kernel linux-netdev linux-ext4 linux-hardening linux-cve-announce PHC
Open Source and information security mailing list archives

Hash Suite: Windows password security audit tool. GUI, reports in PDF.

[<prev] [next>] [<thread-prev] [thread-next>] [day] [month] [year] [list]

Message-ID: <7df3bda8-7450-4446-b810-ada1aaa8d5f2@wdc.com>
Date: Tue, 22 Apr 2025 12:35:04 +0000
From: Hans Holmberg <Hans.Holmberg@....com>
To: Carlos Maiolino <cem@...nel.org>
CC: Stephen Rothwell <sfr@...b.auug.org.au>, "Darrick J . Wong"
	<djwong@...nel.org>, hch <hch@....de>, "linux-xfs@...r.kernel.org"
	<linux-xfs@...r.kernel.org>, "linux-kernel@...r.kernel.org"
	<linux-kernel@...r.kernel.org>
Subject: Re: [PATCH] xfs: remove duplicate Zoned Filesystems sections in
 admin-guide

On 22/04/2025 14:10, Carlos Maiolino wrote:
> On Tue, Apr 22, 2025 at 11:50:07AM +0000, Hans Holmberg wrote:
>> Remove the duplicated section and while at it, turn spaces into tabs.
>>
>> Signed-off-by: Hans Holmberg <hans.holmberg@....com>
> 
> Sounds good.
> 
> Reviewed-by: Carlos Maiolino <cmaiolino@...hat.com>
> 
> Hans, I'm adding a Fixes tag before merging if you don't mind me editing the
> patch before applying.
> 
> Fixes: c7b67ddc3c9 ("xfs: document zoned rt specifics in admin-guide")

Thanks!

> 
> 
>> ---
>>
>> This fixes up the warning reported by Stephen Rothwell for linux-next
>>
>>  Documentation/admin-guide/xfs.rst | 29 ++++++++---------------------
>>  1 file changed, 8 insertions(+), 21 deletions(-)
>>
>> diff --git a/Documentation/admin-guide/xfs.rst b/Documentation/admin-guide/xfs.rst
>> index 3e76276bd488..5becb441c3cb 100644
>> --- a/Documentation/admin-guide/xfs.rst
>> +++ b/Documentation/admin-guide/xfs.rst
>> @@ -562,7 +562,7 @@ The interesting knobs for XFS workqueues are as follows:
>>  Zoned Filesystems
>>  =================
>>
>> -For zoned file systems, the following attribute is exposed in:
>> +For zoned file systems, the following attributes are exposed in:
>>
>>    /sys/fs/xfs/<dev>/zoned/
>>
>> @@ -572,23 +572,10 @@ For zoned file systems, the following attribute is exposed in:
>>  	is limited by the capabilities of the backing zoned device, file system
>>  	size and the max_open_zones mount option.
>>
>> -Zoned Filesystems
>> -=================
>> -
>> -For zoned file systems, the following attributes are exposed in:
>> -
>> - /sys/fs/xfs/<dev>/zoned/
>> -
>> - max_open_zones                 (Min:  1  Default:  Varies  Max:  UINTMAX)
>> -        This read-only attribute exposes the maximum number of open zones
>> -        available for data placement. The value is determined at mount time and
>> -        is limited by the capabilities of the backing zoned device, file system
>> -        size and the max_open_zones mount option.
>> -
>> - zonegc_low_space               (Min:  0  Default:  0  Max:  100)
>> -        Define a percentage for how much of the unused space that GC should keep
>> -        available for writing. A high value will reclaim more of the space
>> -        occupied by unused blocks, creating a larger buffer against write
>> -        bursts at the cost of increased write amplification.  Regardless
>> -        of this value, garbage collection will always aim to free a minimum
>> -        amount of blocks to keep max_open_zones open for data placement purposes.
>> +  zonegc_low_space		(Min:  0  Default:  0  Max:  100)
>> +	Define a percentage for how much of the unused space that GC should keep
>> +	available for writing. A high value will reclaim more of the space
>> +	occupied by unused blocks, creating a larger buffer against write
>> +	bursts at the cost of increased write amplification.  Regardless
>> +	of this value, garbage collection will always aim to free a minimum
>> +	amount of blocks to keep max_open_zones open for data placement purposes.
>> --
>> 2.34.1
>