diff options
| author | Alan Somers <asomers@gmail.com> | 2019-03-10 13:35:30 -0600 |
|---|---|---|
| committer | Nikolaus Rath <Nikolaus@rath.org> | 2019-03-10 19:35:30 +0000 |
| commit | 064fe965618c5bbfc43e4519e80a299ee66ab6a8 (patch) | |
| tree | 961a48683cb8fcf1ac8ff7e002834606ef2bd55c /include/fuse_lowlevel.h | |
| parent | 16337224ea221965b02ce538184cf28170b15e67 (diff) | |
| download | libfuse-064fe965618c5bbfc43e4519e80a299ee66ab6a8.tar.gz | |
Improve documentation for the flush method (#378)
Fixes: #373
Diffstat (limited to 'include/fuse_lowlevel.h')
| -rw-r--r-- | include/fuse_lowlevel.h | 8 |
1 files changed, 6 insertions, 2 deletions
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); |