linux/fs/coda
NeilBrown 88d5baf690
Change inode_operations.mkdir to return struct dentry *
Some filesystems, such as NFS, cifs, ceph, and fuse, do not have
complete control of sequencing on the actual filesystem (e.g.  on a
different server) and may find that the inode created for a mkdir
request already exists in the icache and dcache by the time the mkdir
request returns.  For example, if the filesystem is mounted twice the
directory could be visible on the other mount before it is on the
original mount, and a pair of name_to_handle_at(), open_by_handle_at()
calls could instantiate the directory inode with an IS_ROOT() dentry
before the first mkdir returns.

This means that the dentry passed to ->mkdir() may not be the one that
is associated with the inode after the ->mkdir() completes.  Some
callers need to interact with the inode after the ->mkdir completes and
they currently need to perform a lookup in the (rare) case that the
dentry is no longer hashed.

This lookup-after-mkdir requires that the directory remains locked to
avoid races.  Planned future patches to lock the dentry rather than the
directory will mean that this lookup cannot be performed atomically with
the mkdir.

To remove this barrier, this patch changes ->mkdir to return the
resulting dentry if it is different from the one passed in.
Possible returns are:
  NULL - the directory was created and no other dentry was used
  ERR_PTR() - an error occurred
  non-NULL - this other dentry was spliced in

This patch only changes file-systems to return "ERR_PTR(err)" instead of
"err" or equivalent transformations.  Subsequent patches will make
further changes to some file-systems to return a correct dentry.

Not all filesystems reliably result in a positive hashed dentry:

- NFS, cifs, hostfs will sometimes need to perform a lookup of
  the name to get inode information.  Races could result in this
  returning something different. Note that this lookup is
  non-atomic which is what we are trying to avoid.  Placing the
  lookup in filesystem code means it only happens when the filesystem
  has no other option.
- kernfs and tracefs leave the dentry negative and the ->revalidate
  operation ensures that lookup will be called to correctly populate
  the dentry.  This could be fixed but I don't think it is important
  to any of the users of vfs_mkdir() which look at the dentry.

The recommendation to use
    d_drop();d_splice_alias()
is ugly but fits with current practice.  A planned future patch will
change this.

Reviewed-by: Jeff Layton <jlayton@kernel.org>
Reviewed-by: Jan Kara <jack@suse.cz>
Signed-off-by: NeilBrown <neilb@suse.de>
Link: https://lore.kernel.org/r/20250227013949.536172-2-neilb@suse.de
Signed-off-by: Christian Brauner <brauner@kernel.org>
2025-02-27 20:00:17 +01:00
..
cache.c dentry: switch the lists of children to hlist 2023-11-25 02:32:13 -05:00
cnode.c coda: avoid doing bad things on inode type changes during revalidation 2021-11-09 10:02:51 -08:00
coda_cache.h License cleanup: add SPDX GPL-2.0 license identifier to files with no license 2017-11-02 11:10:55 +01:00
coda_fs_i.h coda: add hinting support for partial file caching 2019-07-16 19:23:23 -07:00
coda_int.h coda: remove sysctl object from module when unused 2019-07-16 19:23:23 -07:00
coda_linux.c coda: convert to new timestamp accessors 2023-10-18 13:26:19 +02:00
coda_linux.h fs: port ->permission() to pass mnt_idmap 2023-01-19 09:24:28 +01:00
coda_psdev.h coda: add hinting support for partial file caching 2019-07-16 19:23:23 -07:00
dir.c Change inode_operations.mkdir to return struct dentry * 2025-02-27 20:00:17 +01:00
file.c fs: move file_start_write() into vfs_iter_write() 2023-11-24 10:09:51 +01:00
inode.c coda: use param->file for FSCONFIG_SET_FD 2024-08-19 13:45:03 +02:00
Kconfig docs: filesystems: convert coda.txt to ReST 2020-05-05 09:22:21 -06:00
Makefile coda: remove sysctl object from module when unused 2019-07-16 19:23:23 -07:00
pioctl.c fs: port ->permission() to pass mnt_idmap 2023-01-19 09:24:28 +01:00
psdev.c driver core: class: remove module * from class_create() 2023-03-17 15:16:33 +01:00
symlink.c coda: Convert coda_symlink_filler() to use folio_end_read() 2024-05-31 12:31:39 +02:00
sysctl.c treewide: const qualify ctl_tables where applicable 2025-01-28 13:48:37 +01:00
upcall.c coda: Avoid partial allocation of sig_inputArgs 2023-02-08 15:26:58 -08:00