From c95846bcc6a7ff30642694445d0bd8523f9056eb Mon Sep 17 00:00:00 2001 From: Nikolaus Rath Date: Thu, 10 Nov 2016 14:04:51 -0800 Subject: Improve documentation of fuse_conn_info.time_gran. Fixes #97. --- include/fuse_common.h | 15 ++++++++++++--- 1 file changed, 12 insertions(+), 3 deletions(-) (limited to 'include') diff --git a/include/fuse_common.h b/include/fuse_common.h index 44b0634..2ba3888 100644 --- a/include/fuse_common.h +++ b/include/fuse_common.h @@ -259,15 +259,24 @@ struct fuse_conn_info { unsigned max_background; /** + * Kernel congestion threshold parameter */ unsigned congestion_threshold; /** - * Time granularity if kernel is responsible for setting times (in nsec) + * When FUSE_CAP_WRITEBACK_CACHE is enabled, the kernel is responsible + * for updating mtime and ctime when write requests are received. The + * updated values are passed to the filesystem with setattr() requests. + * However, if the filesystem does not support the full resolution of + * the kernel timestamps (nanoseconds), the mtime and ctime values used + * by kernel and filesystem will differ (and result in an apparent + * change of times after a cache flush). * - * Should be power of 10. A zero (default) value is equivalent to - * 1000000000 (1sec). + * To prevent this problem, this variable can be used to inform the + * kernel about the timestamp granularity supported by the file-system. + * The value should be power of 10. A zero (default) value is + * equivalent to 1000000000 (1sec). */ unsigned time_gran; -- cgit v1.2.3