Document possible NULL paths when directories are removed (#633)

When directories with open handles are removed, the releasedir and
fsyncdir operations might be called with a NULL path. That is because
there is no hiding behavior like for regular files and the nodes get
removed immediately.

diff --git a/include/fuse.h b/include/fuse.h
index 9e6c63361ce6106ee2efb996d54521a39c9c1fc2..a273b15b9161d5c1c31cdfc15fe4226d2ef38d68 100644 (file)
--- a/include/fuse.h
+++ b/include/fuse.h
@@ -560,10 +560,16 @@ struct fuse_operations {
                        struct fuse_file_info *, enum fuse_readdir_flags);
 
        /** Release directory
+        *
+        * If the directory has been removed after the call to opendir, the
+        * path parameter will be NULL.
         */
        int (*releasedir) (const char *, struct fuse_file_info *);
 
        /** Synchronize directory contents
+        *
+        * If the directory has been removed after the call to opendir, the
+        * path parameter will be NULL.
         *
         * If the datasync parameter is non-zero, then only the user data
         * should be flushed, not the meta data