doc update from Evan Jones

1 files changed, 8 insertions, 4 deletions

diff --git a/include/fuse_lowlevel.h b/include/fuse_lowlevel.h
index 0d97b69..1f2aa5e 100644
--- a/include/fuse_lowlevel.h
+++ b/include/fuse_lowlevel.h
@@ -75,11 +75,15 @@ struct fuse_entry_param {
      */
     fuse_ino_t ino;
 
-    /** The ino/generation pair should be unique for the filesystem's
-        lifetime */
+    /** Generation number for this entry. The ino/generation pair
+        should be unique for the filesystem's lifetime. It must be
+        non-zero, otherwise FUSE will treat it as an error. */
     unsigned long generation;
 
-    /** Inode attributes */
+    /** Inode attributes. Even if attr_timeout == 0, attr must be
+        correct. For example, for open(), FUSE uses attr.st_size from
+        lookup() to determine how many bytes to request. If this
+        value is not correct, incorrect data will be returned. */
     struct stat attr;
 
     /** Validity timeout (in seconds) for the attributes */
@@ -158,7 +162,7 @@ struct fuse_lowlevel_ops {
     void (*destroy) (void *userdata);
 
     /**
-     * Look up a directory entry by name
+     * Look up a directory entry by name and get its attributes.
      *
      * Valid replies:
      *   fuse_reply_entry