From: Nikolaus Rath <Nikolaus@rath.org>
Date: Wed, 16 Nov 2016 19:28:42 +0000 (-0800)
Subject: Document "congestion_threshold" parameter.
X-Git-Tag: fuse-3.0.0rc3~25
X-Git-Url: http://git.maquefel.me/?a=commitdiff_plain;h=77eae112a75e142384a16c18b486b8f72ef82b14;p=qemu-gpiodev%2Flibfuse.git

Document "congestion_threshold" parameter.

Fixes #96.

Thanks to Maxim Patlasov <mpatlasov@virtuozzo.com> for help!
---

diff --git a/include/fuse_common.h b/include/fuse_common.h
index dc19083..a906bc5 100644
--- a/include/fuse_common.h
+++ b/include/fuse_common.h
@@ -288,10 +288,12 @@ struct fuse_conn_info {
 	unsigned max_background;
 
 	/**
-	 * Kernel congestion threshold parameter.  If you want to
-	 * know what this means, please refer to the kernel source
-	 * (and, ideally, submit a brief explanation that can be
-	 * included here).
+	 * Kernel congestion threshold parameter. If the number of pending
+	 * background requests exceeds this number, the FUSE kernel module will
+	 * mark the filesystem as "congested". This instructs the kernel to
+	 * expect that queued requests will take some time to complete, and to
+	 * adjust its algorithms accordingly (e.g. by putting a waiting thread
+	 * to sleep instead of using a busy-loop).
 	 */
 	unsigned congestion_threshold;