From: Nikolaus Rath <Nikolaus@rath.org>
Date: Tue, 15 Nov 2016 00:13:11 +0000 (-0800)
Subject: Improve getattr() description
X-Git-Tag: fuse-3.0.0rc3~28
X-Git-Url: http://git.maquefel.me/?a=commitdiff_plain;h=ad463481c4e413f22aa47963bc1e0f34382b5e54;p=qemu-gpiodev%2Flibfuse.git

Improve getattr() description

When writeback caching is enabled, the st_size value reported
by the filesystem may be ignored.
---

diff --git a/include/fuse_lowlevel.h b/include/fuse_lowlevel.h
index 0ae7734..7b007e7 100644
--- a/include/fuse_lowlevel.h
+++ b/include/fuse_lowlevel.h
@@ -248,7 +248,15 @@ struct fuse_lowlevel_ops {
 	void (*forget) (fuse_req_t req, fuse_ino_t ino, uint64_t nlookup);
 
 	/**
-	 * Get file attributes
+	 * Get file attributes.
+	 *
+	 * If writeback caching is enabled, the kernel may have a
+	 * better idea of a file's length than the FUSE file system
+	 * (eg if there has been a write that extended the file size,
+	 * but that has not yet been passed to the filesystem.n
+	 *
+	 * In this case, the st_size value provided by the file system
+	 * will be ignored.
 	 *
 	 * Valid replies:
 	 *   fuse_reply_attr