diff options
author | Nikolaus Rath <Nikolaus@rath.org> | 2016-11-06 21:47:56 -0800 |
---|---|---|
committer | Nikolaus Rath <Nikolaus@rath.org> | 2016-11-06 21:47:56 -0800 |
commit | 108c8260d341c21770b776169394c3aec761ead1 (patch) | |
tree | b4503845178e732d75d3117254acdfc6d98f6f42 /include/fuse.h | |
parent | 079b3f625ec92920b60d55cc0d7c957e48bb47ef (diff) | |
download | libfuse-108c8260d341c21770b776169394c3aec761ead1.tar.gz |
Fix documentation: fuse_file_info may be NULL for open files
This turns issue #62 from a bug into an enhancement :-).
Diffstat (limited to 'include/fuse.h')
-rw-r--r-- | include/fuse.h | 20 |
1 files changed, 12 insertions, 8 deletions
diff --git a/include/fuse.h b/include/fuse.h index 399d104..682f731 100644 --- a/include/fuse.h +++ b/include/fuse.h @@ -250,9 +250,8 @@ struct fuse_config { * fsyncdir, lock, ioctl and poll. * * For the truncate, getattr, chmod, chown and utimens - * operations the path will be provided only if the file is - * not currently open (i.e., when the struct fuse_file_info - * argument is NULL). + * operations the path will be provided only if the struct + * fuse_file_info argument is NULL. */ int nullpath_ok; @@ -295,7 +294,8 @@ struct fuse_operations { * ignored. The 'st_ino' field is ignored except if the 'use_ino' * mount option is given. * - * *fi* will be NULL if the file is not currenly opened. + * `fi` will always be NULL if the file is not currenly open, but + * may also be NULL if the file is open. */ int (*getattr) (const char *, struct stat *, struct fuse_file_info *fi); @@ -342,19 +342,22 @@ struct fuse_operations { /** Change the permission bits of a file * - * *fi* will be NULL if the file is not currenly opened. + * `fi` will always be NULL if the file is not currenly open, but + * may also be NULL if the file is open. */ int (*chmod) (const char *, mode_t, struct fuse_file_info *fi); /** Change the owner and group of a file * - * *fi* will be NULL if the file is not currenly opened. + * `fi` will always be NULL if the file is not currenly open, but + * may also be NULL if the file is open. */ int (*chown) (const char *, uid_t, gid_t, struct fuse_file_info *fi); /** Change the size of a file * - * *fi* will be NULL if the file is not currenly opened. + * `fi` will always be NULL if the file is not currenly open, but + * may also be NULL if the file is open. */ int (*truncate) (const char *, off_t, struct fuse_file_info *fi); @@ -577,7 +580,8 @@ struct fuse_operations { * This supersedes the old utime() interface. New applications * should use this. * - * *fi* will be NULL if the file is not currenly opened. + * `fi` will always be NULL if the file is not currenly open, but + * may also be NULL if the file is open. * * See the utimensat(2) man page for details. */ |