diff options
author | Randy Dunlap <randy.dunlap@oracle.com> | 2011-01-08 22:36:21 -0500 |
---|---|---|
committer | Linus Torvalds <torvalds@linux-foundation.org> | 2011-01-10 10:38:53 -0500 |
commit | 39191628ed169510db2f3f472e1ec14e08f9690f (patch) | |
tree | edea4bf852861bc126274b186f2997366ea09a34 /fs/namei.c | |
parent | 0c21e3aaf6ae85bee804a325aa29c325209180fd (diff) |
fs: fix namei.c kernel-doc notation
Fix new kernel-doc notation warnings in fs/namei.c and spell
ECHILD correctly.
Warning(fs/namei.c:218): No description found for parameter 'flags'
Warning(fs/namei.c:425): Excess function parameter 'Returns' description in 'nameidata_drop_rcu'
Warning(fs/namei.c:478): Excess function parameter 'Returns' description in 'nameidata_dentry_drop_rcu'
Warning(fs/namei.c:540): Excess function parameter 'Returns' description in 'nameidata_drop_rcu_last'
Signed-off-by: Randy Dunlap <randy.dunlap@oracle.com>
Cc: Nick Piggin <npiggin@kernel.dk>
Signed-off-by: Linus Torvalds <torvalds@linux-foundation.org>
Diffstat (limited to 'fs/namei.c')
-rw-r--r-- | fs/namei.c | 8 |
1 files changed, 4 insertions, 4 deletions
diff --git a/fs/namei.c b/fs/namei.c index 19433cdba011..24ece10470b6 100644 --- a/fs/namei.c +++ b/fs/namei.c | |||
@@ -202,7 +202,7 @@ static int acl_permission_check(struct inode *inode, int mask, unsigned int flag | |||
202 | * @inode: inode to check access rights for | 202 | * @inode: inode to check access rights for |
203 | * @mask: right to check for (%MAY_READ, %MAY_WRITE, %MAY_EXEC) | 203 | * @mask: right to check for (%MAY_READ, %MAY_WRITE, %MAY_EXEC) |
204 | * @check_acl: optional callback to check for Posix ACLs | 204 | * @check_acl: optional callback to check for Posix ACLs |
205 | * @flags IPERM_FLAG_ flags. | 205 | * @flags: IPERM_FLAG_ flags. |
206 | * | 206 | * |
207 | * Used to check for read/write/execute permissions on a file. | 207 | * Used to check for read/write/execute permissions on a file. |
208 | * We use "fsuid" for this, letting us set arbitrary permissions | 208 | * We use "fsuid" for this, letting us set arbitrary permissions |
@@ -407,7 +407,7 @@ void path_put_long(struct path *path) | |||
407 | /** | 407 | /** |
408 | * nameidata_drop_rcu - drop this nameidata out of rcu-walk | 408 | * nameidata_drop_rcu - drop this nameidata out of rcu-walk |
409 | * @nd: nameidata pathwalk data to drop | 409 | * @nd: nameidata pathwalk data to drop |
410 | * @Returns: 0 on success, -ECHLID on failure | 410 | * Returns: 0 on success, -ECHILD on failure |
411 | * | 411 | * |
412 | * Path walking has 2 modes, rcu-walk and ref-walk (see | 412 | * Path walking has 2 modes, rcu-walk and ref-walk (see |
413 | * Documentation/filesystems/path-lookup.txt). __drop_rcu* functions attempt | 413 | * Documentation/filesystems/path-lookup.txt). __drop_rcu* functions attempt |
@@ -468,7 +468,7 @@ static inline int nameidata_drop_rcu_maybe(struct nameidata *nd) | |||
468 | * nameidata_dentry_drop_rcu - drop nameidata and dentry out of rcu-walk | 468 | * nameidata_dentry_drop_rcu - drop nameidata and dentry out of rcu-walk |
469 | * @nd: nameidata pathwalk data to drop | 469 | * @nd: nameidata pathwalk data to drop |
470 | * @dentry: dentry to drop | 470 | * @dentry: dentry to drop |
471 | * @Returns: 0 on success, -ECHLID on failure | 471 | * Returns: 0 on success, -ECHILD on failure |
472 | * | 472 | * |
473 | * nameidata_dentry_drop_rcu attempts to drop the current nd->path and nd->root, | 473 | * nameidata_dentry_drop_rcu attempts to drop the current nd->path and nd->root, |
474 | * and dentry into ref-walk. @dentry must be a path found by a do_lookup call on | 474 | * and dentry into ref-walk. @dentry must be a path found by a do_lookup call on |
@@ -530,7 +530,7 @@ static inline int nameidata_dentry_drop_rcu_maybe(struct nameidata *nd, struct d | |||
530 | /** | 530 | /** |
531 | * nameidata_drop_rcu_last - drop nameidata ending path walk out of rcu-walk | 531 | * nameidata_drop_rcu_last - drop nameidata ending path walk out of rcu-walk |
532 | * @nd: nameidata pathwalk data to drop | 532 | * @nd: nameidata pathwalk data to drop |
533 | * @Returns: 0 on success, -ECHLID on failure | 533 | * Returns: 0 on success, -ECHILD on failure |
534 | * | 534 | * |
535 | * nameidata_drop_rcu_last attempts to drop the current nd->path into ref-walk. | 535 | * nameidata_drop_rcu_last attempts to drop the current nd->path into ref-walk. |
536 | * nd->path should be the final element of the lookup, so nd->root is discarded. | 536 | * nd->path should be the final element of the lookup, so nd->root is discarded. |