Doc fix for dget_dlock and dget
PATCH 1/1 Doc fix for dget_dlock and dget
dcache header:
1. Remove a warning for dget_dlock
2. Add a similar comment for dget and
mention the difference between dget and dget_dlock as suggested by Mr. Randy Dunlap
Signed-off-by Anup K Parikh <[email protected]>
--- include/linux/dcache.h | 24 +++++++++++++++++++----- 1 file changed, 19 insertions(+), 5 deletions(-)
include/linux/dcache.h +19 -5
@@ -299,12 +299,15 @@ extern char *dentry_path(const struct dentry *, char *, int);/* Allocation counts.. */ /** -* dget, dget_dlock - get a reference to a dentry -* @dentry: dentry to get a reference to +* dget_dlock - get a reference to a dentry +* @dentry: dentry to get a reference to * -* Given a dentry or %NULL pointer increment the reference count -* if appropriate and return the dentry. A dentry will not be -* destroyed when it has references. +* Given a dentry or %NULL pointer increment the reference count +* if appropriate and return the dentry. A dentry will not be +* destroyed when it has references. +* +* The reference count increment in this function is not atomic. +* Consider dget() if atomicity is required. */ static inline struct dentry *dget_dlock (struct dentry *dentry) {
@@ -313,6 +316,17 @@ static inline struct dentry *dget_dlock(struct dentry *dentry)return dentry; } +/** +* dget - get a reference to a dentry +* @dentry: dentry to get a reference to +* +* Given a dentry or %NULL pointer increment the reference count +* if appropriate and return the dentry. A dentry will not be +* destroyed when it has references. +* +* This function atomically increments the reference count. +* Consider dget_dlock() if atomicity is not required or manually managed. +*/ static inline struct dentry *dget (struct dentry *dentry) {if (dentry)
Signature · 1 line
2.35.1