[PATCH RESEND] doc: fuse: Add max_background and congestion_threshold

[PATCH RESEND] doc: fuse: Add max_background and congestion_threshold

[Chen Linxuan]

As I preparing patches adding selftests for fusectl,
I notice that documentation of max_background and congestion_threshold
is missing.

This patch add some descriptions about these two files.

Cc: Amir Goldstein <amir73il@gmail.com>
Signed-off-by: Chen Linxuan <chenlinxuan@uniontech.com>
---
 Documentation/filesystems/fuse.rst | 14 ++++++++++++++
 1 file changed, 14 insertions(+)

diff --git a/Documentation/filesystems/fuse.rst b/Documentation/filesystems/fuse.rst
index 1e31e87aee68c..c589316c8bb35 100644
--- a/Documentation/filesystems/fuse.rst
+++ b/Documentation/filesystems/fuse.rst
@@ -129,6 +129,20 @@ For each connection the following files exist within this directory:
 	  connection.  This means that all waiting requests will be aborted an
 	  error returned for all aborted and new requests.
 
+        max_background
+          The maximum number of background requests that can be outstanding
+          at a time. When the number of background requests reaches this limit,
+          further requests will be blocked until some are completed, potentially
+          causing I/O operations to stall.
+
+        congestion_threshold
+          The threshold of background requests at which the kernel considers
+          the filesystem to be congested. When the number of background requests
+          exceeds this value, the kernel will skip asynchronous readahead
+          operations, reducing read-ahead optimizations but preserving essential
+          I/O, as well as suspending non-synchronous writeback operations
+          (WB_SYNC_NONE), delaying page cache flushing to the filesystem.
+
 Only the owner of the mount may read or write these files.
 
 Interrupting filesystem operations
-- 
2.43.0

Re: [PATCH RESEND] doc: fuse: Add max_background and congestion_threshold

[Bagas Sanjaya]

[-- Attachment #1: Type: text/plain, Size: 527 bytes --]

On Tue, Jun 10, 2025 at 10:11:25AM +0800, Chen Linxuan wrote:
> +        max_background
> +          The maximum number of background requests that can be outstanding
                                   outstanding background requests
> +          at a time. When the number of background requests reaches this limit,
> +          further requests will be blocked until some are completed, potentially
> +          causing I/O operations to stall.

Thanks.

-- 
An old man doll... just what I always wanted! - Clara

[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 228 bytes --]

Re: [PATCH RESEND] doc: fuse: Add max_background and congestion_threshold

[Miklos Szeredi]

On Tue, 10 Jun 2025 at 04:11, Chen Linxuan <chenlinxuan@uniontech.com> wrote:
>
> As I preparing patches adding selftests for fusectl,
> I notice that documentation of max_background and congestion_threshold
> is missing.
>
> This patch add some descriptions about these two files.
>
> Cc: Amir Goldstein <amir73il@gmail.com>
> Signed-off-by: Chen Linxuan <chenlinxuan@uniontech.com>

Applied, thanks.

Miklos