lkml.org 
[lkml]   [2007]   [Nov]   [5]   [last100]   RSS Feed
Views: [wrap][no wrap]   [headers]  [forward] 
 
Messages in this thread
    Patch in this message
    /
    Date
    From
    Subject[PATCH 2/9] 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>
    ---
    fs/dcache.c | 35 ++++++++++++++++-------------------
    1 file changed, 16 insertions(+), 19 deletions(-)

    Index: b/fs/dcache.c
    ===================================================================
    --- a/fs/dcache.c
    +++ b/fs/dcache.c
    @@ -1762,22 +1762,6 @@ shouldnt_be_hashed:
    goto shouldnt_be_hashed;
    }

    -/**
    - * d_path - return the path of a dentry
    - * @dentry: dentry to report
    - * @vfsmnt: vfsmnt to which the dentry belongs
    - * @root: root dentry
    - * @rootmnt: vfsmnt to which the root dentry belongs
    - * @buffer: 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.
    - */
    static char * __d_path(struct dentry *dentry, struct vfsmount *vfsmnt,
    struct path *root, char *buffer, int buflen)
    {
    @@ -1845,9 +1829,22 @@ Elong:
    return ERR_PTR(-ENAMETOOLONG);
    }

    -/* write full pathname into buffer and return start of pathname */
    -char * d_path(struct dentry *dentry, struct vfsmount *vfsmnt,
    - char *buf, int buflen)
    +/**
    + * 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)
    {
    char *res;
    struct path root;

    -
    To unsubscribe from this list: send the line "unsubscribe linux-kernel" in
    the body of a message to majordomo@vger.kernel.org
    More majordomo info at http://vger.kernel.org/majordomo-info.html
    Please read the FAQ at http://www.tux.org/lkml/

    \
     
     \ /
      Last update: 2007-11-05 17:39    [W:0.019 / U:8.588 seconds]
    ©2003-2017 Jasper Spaans. hosted at Digital OceanAdvertise on this site