Donate to e Foundation | Murena handsets with /e/OS | Own a part of Murena! Learn more

Commit a03a8a70 authored by Jan Blunck's avatar Jan Blunck Committed by Linus Torvalds
Browse files

d_path: kerneldoc cleanup



Move and update d_path() kernel API documentation.

Signed-off-by: default avatarJan Blunck <jblunck@suse.de>
Acked-by: default avatarChristoph Hellwig <hch@infradead.org>
Cc: Al Viro <viro@zeniv.linux.org.uk>
Cc: "J. Bruce Fields" <bfields@fieldses.org>
Cc: Neil Brown <neilb@suse.de>
Signed-off-by: default avatarAndrew Morton <akpm@linux-foundation.org>
Signed-off-by: default avatarLinus Torvalds <torvalds@linux-foundation.org>
parent 329c97f0
Loading
Loading
Loading
Loading
+16 −3
Original line number Diff line number Diff line
@@ -1843,7 +1843,20 @@ static char *__d_path(struct dentry *dentry, struct vfsmount *vfsmnt,
	return ERR_PTR(-ENAMETOOLONG);
}

/* write full pathname into buffer and return start of pathname */
/**
 * d_path - return the path of a dentry
 * @dentry: dentry to report
 * @vfsmnt: vfsmnt to which the dentry belongs
 * @buf: buffer to return value in
 * @buflen: buffer length
 *
 * Convert a dentry into an ASCII path name. If the entry has been deleted
 * the string " (deleted)" is appended. Note that this is ambiguous.
 *
 * Returns the buffer or an error code if the path was too long.
 *
 * "buflen" should be positive. Caller holds the dcache_lock.
 */
char *d_path(struct dentry *dentry, struct vfsmount *vfsmnt,
	     char *buf, int buflen)
{