From: Nikolaus Rath <Nikolaus@rath.org>
Date: Sat, 13 Jul 2019 00:58:59 +0000 (-0700)
Subject: Improve description of READDIRPLUS_AUTO.
X-Git-Tag: fuse-3.7.0~9
X-Git-Url: http://git.maquefel.me/?a=commitdiff_plain;h=3c31bead28170dd75daf50b2865d99d2dd3c106b;p=qemu-gpiodev%2Flibfuse.git

Improve description of READDIRPLUS_AUTO.
---

diff --git a/include/fuse_common.h b/include/fuse_common.h
index efee194..e9b3e3e 100644
--- a/include/fuse_common.h
+++ b/include/fuse_common.h
@@ -264,6 +264,15 @@ struct fuse_loop_config {
  * will issue both readdir() and readdirplus() requests, depending on
  * how much information is expected to be required.
  *
+ * As of Linux 4.20, the algorithm is as follows: when userspace
+ * starts to read directory entries, issue a READDIRPLUS request to
+ * the filesystem. If any entry attributes have been looked up by the
+ * time userspace requests the next batch of entries continue with
+ * READDIRPLUS, otherwise switch to plain READDIR.  This will reasult
+ * in eg plain "ls" triggering READDIRPLUS first then READDIR after
+ * that because it doesn't do lookups.  "ls -l" should result in all
+ * READDIRPLUS, except if dentries are already cached.
+ *
  * This feature is enabled by default when supported by the kernel and
  * if the filesystem implements both a readdirplus() and a readdir()
  * handler.