vfs: document ->d_real()
Add missing documentation for the d_op->d_real() method and d_real()
helper.
Signed-off-by: Miklos Szeredi <mszeredi@redhat.com>
diff --git a/include/linux/dcache.h b/include/linux/dcache.h
index 45b22de..14df836 100644
--- a/include/linux/dcache.h
+++ b/include/linux/dcache.h
@@ -139,7 +139,8 @@
char *(*d_dname)(struct dentry *, char *, int);
struct vfsmount *(*d_automount)(struct path *);
int (*d_manage)(struct dentry *, bool);
- struct dentry *(*d_real)(struct dentry *, const struct inode *, unsigned int);
+ struct dentry *(*d_real)(struct dentry *, const struct inode *,
+ unsigned int);
} ____cacheline_aligned;
/*
@@ -554,6 +555,17 @@
return upper;
}
+/**
+ * d_real - Return the real dentry
+ * @dentry: the dentry to query
+ * @inode: inode to select the dentry from multiple layers (can be NULL)
+ * @flags: open flags to control copy-up behavior
+ *
+ * If dentry is on an union/overlay, then return the underlying, real dentry.
+ * Otherwise return the dentry itself.
+ *
+ * See also: Documentation/filesystems/vfs.txt
+ */
static inline struct dentry *d_real(struct dentry *dentry,
const struct inode *inode,
unsigned int flags)