centos man page for vfs_rename

VFS_RENAME(9)							   The Linux VFS						     VFS_RENAME(9)

NAME
       vfs_rename - rename a filesystem object

SYNOPSIS
       int vfs_rename(struct inode * old_dir, struct dentry * old_dentry, struct inode * new_dir, struct dentry * new_dentry,
		      struct inode ** delegated_inode);

ARGUMENTS
       old_dir
	   parent of source

       old_dentry
	   source

       new_dir
	   parent of destination

       new_dentry
	   destination

       delegated_inode
	   returns an inode needing a delegation break

DESCRIPTION
       The caller must hold multiple mutexes--see lock_rename).

       If vfs_rename discovers a delegation in need of breaking at either the source or destination, it will return -EWOULDBLOCK and return a
       reference to the inode in delegated_inode. The caller should then break the delegation and retry. Because breaking a delegation may take a
       long time, the caller should drop all locks before doing so.

       Alternatively, a caller may pass NULL for delegated_inode. This may be appropriate for callers that expect the underlying filesystem not to
       be NFS exported.

COPYRIGHT
Kernel Hackers Manual 3.10					     June 2014							     VFS_RENAME(9)