aboutsummaryrefslogtreecommitdiffstats
path: root/fs
diff options
context:
space:
mode:
authorJan Blunck <jblunck@suse.de>2008-02-14 22:38:32 -0500
committerLinus Torvalds <torvalds@woody.linux-foundation.org>2008-02-15 00:17:08 -0500
commita03a8a709a0c34b61b7aea1d54a0473a6b941fdb (patch)
tree726beca09574c6599ceece7c5cb82c7efed33f18 /fs
parent329c97f0af41bd580237b8fad0f3741849ee4e13 (diff)
d_path: kerneldoc cleanup
Move and update d_path() kernel API documentation. Signed-off-by: Jan Blunck <jblunck@suse.de> Acked-by: Christoph 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: Andrew Morton <akpm@linux-foundation.org> Signed-off-by: Linus Torvalds <torvalds@linux-foundation.org>
Diffstat (limited to 'fs')
-rw-r--r--fs/dcache.c19
1 files changed, 16 insertions, 3 deletions
diff --git a/fs/dcache.c b/fs/dcache.c
index 688aac951d11..170efbcb1a9b 100644
--- a/fs/dcache.c
+++ b/fs/dcache.c
@@ -1843,9 +1843,22 @@ Elong:
1843 return ERR_PTR(-ENAMETOOLONG); 1843 return ERR_PTR(-ENAMETOOLONG);
1844} 1844}
1845 1845
1846/* write full pathname into buffer and return start of pathname */ 1846/**
1847char * d_path(struct dentry *dentry, struct vfsmount *vfsmnt, 1847 * d_path - return the path of a dentry
1848 char *buf, int buflen) 1848 * @dentry: dentry to report
1849 * @vfsmnt: vfsmnt to which the dentry belongs
1850 * @buf: buffer to return value in
1851 * @buflen: buffer length
1852 *
1853 * Convert a dentry into an ASCII path name. If the entry has been deleted
1854 * the string " (deleted)" is appended. Note that this is ambiguous.
1855 *
1856 * Returns the buffer or an error code if the path was too long.
1857 *
1858 * "buflen" should be positive. Caller holds the dcache_lock.
1859 */
1860char *d_path(struct dentry *dentry, struct vfsmount *vfsmnt,
1861 char *buf, int buflen)
1849{ 1862{
1850 char *res; 1863 char *res;
1851 struct path root; 1864 struct path root;