]> git.ipfire.org Git - thirdparty/kernel/stable.git/commitdiff
doc: fuse: Add max_background and congestion_threshold
authorChen Linxuan <chenlinxuan@uniontech.com>
Tue, 10 Jun 2025 02:11:25 +0000 (10:11 +0800)
committerMiklos Szeredi <mszeredi@redhat.com>
Wed, 27 Aug 2025 12:29:43 +0000 (14:29 +0200)
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>
Signed-off-by: Miklos Szeredi <mszeredi@redhat.com>
Documentation/filesystems/fuse.rst

index 1e31e87aee68c5417ad1422603480b29895826b1..c589316c8bb35aeb10fbf4a8087d4018014edbd5 100644 (file)
@@ -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