From 064fe965618c5bbfc43e4519e80a299ee66ab6a8 Mon Sep 17 00:00:00 2001 From: Alan Somers Date: Sun, 10 Mar 2019 13:35:30 -0600 Subject: Improve documentation for the flush method (#378) Fixes: #373 --- include/fuse_lowlevel.h | 8 ++++++-- 1 file changed, 6 insertions(+), 2 deletions(-) (limited to 'include/fuse_lowlevel.h') diff --git a/include/fuse_lowlevel.h b/include/fuse_lowlevel.h index ae6736e..68fd521 100644 --- a/include/fuse_lowlevel.h +++ b/include/fuse_lowlevel.h @@ -583,8 +583,10 @@ struct fuse_lowlevel_ops { * * NOTE: the name of the method is misleading, since (unlike * fsync) the filesystem is not forced to flush pending writes. - * One reason to flush data, is if the filesystem wants to return - * write errors. + * One reason to flush data is if the filesystem wants to return + * write errors during close. However, such use is non-portable + * because POSIX does not require [close] to wait for delayed I/O to + * complete. * * If the filesystem supports file locking operations (setlk, * getlk) it should remove all locks belonging to 'fi->owner'. @@ -600,6 +602,8 @@ struct fuse_lowlevel_ops { * @param req request handle * @param ino the inode number * @param fi file information + * + * [close]: http://pubs.opengroup.org/onlinepubs/9699919799/functions/close.html */ void (*flush) (fuse_req_t req, fuse_ino_t ino, struct fuse_file_info *fi); -- cgit v1.2.3