summaryrefslogtreecommitdiff
path: root/include/linux
diff options
context:
space:
mode:
authorMiklos Szeredi <mszeredi@redhat.com>2016-06-30 08:53:27 +0200
committerMiklos Szeredi <mszeredi@redhat.com>2016-06-30 08:53:27 +0200
commite698b8a43659f9ece192fcab215abcadac8f88d7 (patch)
tree73bcdb2ecc6a7fe314d380ac2373ff53d5f935ae /include/linux
parent2d902671ce1cd98cdc88d78c481889a1b2996101 (diff)
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>
Diffstat (limited to 'include/linux')
-rw-r--r--include/linux/dcache.h14
1 files changed, 13 insertions, 1 deletions
diff --git a/include/linux/dcache.h b/include/linux/dcache.h
index 45b22de15ede..14df83609c7f 100644
--- a/include/linux/dcache.h
+++ b/include/linux/dcache.h
@@ -139,7 +139,8 @@ struct dentry_operations {
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 @@ static inline struct dentry *d_backing_dentry(struct dentry *upper)
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)