Commit 39191628ed169510db2f3f472e1ec14e08f9690f

Authored by Randy Dunlap
Committed by Linus Torvalds
1 parent 0c21e3aaf6

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>

Showing 1 changed file with 4 additions and 4 deletions Side-by-side Diff

... ... @@ -202,7 +202,7 @@
202 202 * @inode: inode to check access rights for
203 203 * @mask: right to check for (%MAY_READ, %MAY_WRITE, %MAY_EXEC)
204 204 * @check_acl: optional callback to check for Posix ACLs
205   - * @flags IPERM_FLAG_ flags.
  205 + * @flags: IPERM_FLAG_ flags.
206 206 *
207 207 * Used to check for read/write/execute permissions on a file.
208 208 * We use "fsuid" for this, letting us set arbitrary permissions
... ... @@ -407,7 +407,7 @@
407 407 /**
408 408 * nameidata_drop_rcu - drop this nameidata out of rcu-walk
409 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 412 * Path walking has 2 modes, rcu-walk and ref-walk (see
413 413 * Documentation/filesystems/path-lookup.txt). __drop_rcu* functions attempt
... ... @@ -468,7 +468,7 @@
468 468 * nameidata_dentry_drop_rcu - drop nameidata and dentry out of rcu-walk
469 469 * @nd: nameidata pathwalk data to drop
470 470 * @dentry: dentry to drop
471   - * @Returns: 0 on success, -ECHLID on failure
  471 + * Returns: 0 on success, -ECHILD on failure
472 472 *
473 473 * nameidata_dentry_drop_rcu attempts to drop the current nd->path and nd->root,
474 474 * and dentry into ref-walk. @dentry must be a path found by a do_lookup call on
... ... @@ -530,7 +530,7 @@
530 530 /**
531 531 * nameidata_drop_rcu_last - drop nameidata ending path walk out of rcu-walk
532 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 535 * nameidata_drop_rcu_last attempts to drop the current nd->path into ref-walk.
536 536 * nd->path should be the final element of the lookup, so nd->root is discarded.