Skip to contentSkip to conversation

doc: fuse: Add max_background and congestion_threshold

PATCH RESEND Applied Chen Linxuan 3 participants 3 messages Jun 10, 2025 – Jun 12, 2025

Subsystems (2)
lore
Share & tools
lore
#0 lore raw

PATCH RESEND 1/1 doc: fuse: Add max_background and congestion_threshold

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 <[email protected]>
---
 Documentation/filesystems/fuse.rst | 14 ++++++++++++++
 1 file changed, 14 insertions(+)
Documentation/filesystems/fuse.rst +14 -0
index 1e31e87aee68c..c589316c8bb35 100644
@@ -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
Signature · 1 line
2.43.0
#1 lore raw

Documentation/filesystems/fuse.rst For each connection the following files exist within this directory: · line 133

Quoted 2 lines · Chen Linxuan
Documentation/filesystems/fuse.rst +2 -0
+        max_background
+          The maximum number of background requests that can be outstanding

outstanding background requests

Documentation/filesystems/fuse.rst For each connection the following files exist within this directory: · line 136

Quoted 3 lines
Documentation/filesystems/fuse.rst +3 -0
+          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.

Signature · 1 line
An old man doll... just what I always wanted! - Clara