From 0a096eb2bf8d60b376fa1185bfc051b966114a14 Mon Sep 17 00:00:00 2001 From: Nikolaus Rath Date: Thu, 6 Apr 2017 11:41:48 -0700 Subject: [PATCH] Document true meaning of the 'use_ino' option. --- ChangeLog.rst | 5 ++++- include/fuse.h | 7 ++++++- 2 files changed, 10 insertions(+), 2 deletions(-) diff --git a/ChangeLog.rst b/ChangeLog.rst index 7b7e3c0..3c4c972 100644 --- a/ChangeLog.rst +++ b/ChangeLog.rst @@ -4,7 +4,10 @@ libfuse 3.1.0 (UNRELEASED) * Re-introduced examples/null.c. * Added experimental support for building with Meson. * Document that -o auto_unmount implies -o nodev,nosuid. - +* Document that `-o auto_unmount` implies `-o nodev,nosuid`. +* Document that the *use_ino* option of the high-level interface does + not affect the inode that libfuse and the kernel use internally. + libfuse 3.0.0 (2016-12-08) ========================== diff --git a/include/fuse.h b/include/fuse.h index 89798ef..6bba1ce 100644 --- a/include/fuse.h +++ b/include/fuse.h @@ -177,6 +177,9 @@ struct fuse_config { * field in the readdir(2) function. The filesystem does not * have to guarantee uniqueness, however some applications * rely on this value being unique for the whole filesystem. + * + * Note that this does *not* affect the inode that libfuse + * and the kernel use internally (also called the "nodeid"). */ int use_ino; @@ -292,7 +295,9 @@ struct fuse_operations { * * Similar to stat(). The 'st_dev' and 'st_blksize' fields are * ignored. The 'st_ino' field is ignored except if the 'use_ino' - * mount option is given. + * mount option is given. In that case it is passed to userspace, + * but libfuse and the kernel will still assign a different + * inode for internal use (called the "nodeid"). * * `fi` will always be NULL if the file is not currenly open, but * may also be NULL if the file is open. -- 2.30.2