Linux kernel mirror (for testing)
git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
kernel
os
linux
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>
authored by
Jan Blunck
and committed by
Linus Torvalds
a03a8a70
329c97f0
+16
-3
+16
-3
fs/dcache.c
+16
-3
fs/dcache.c
···
1843
1843
return ERR_PTR(-ENAMETOOLONG);
1844
1844
}
1845
1845
1846
-
/* write full pathname into buffer and return start of pathname */
1847
-
char * d_path(struct dentry *dentry, struct vfsmount *vfsmnt,
1848
-
char *buf, int buflen)
1846
+
/**
1847
+
* d_path - return the path of a dentry
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
+
*/
1860
+
char *d_path(struct dentry *dentry, struct vfsmount *vfsmnt,
1861
+
char *buf, int buflen)
1849
1862
{
1850
1863
char *res;
1851
1864
struct path root;