d_obtain_root (9) - Linux Manuals

d_obtain_root: find or allocate a dentry for a given inode

Command to display d_obtain_root manual in Linux: $ man 9 d_obtain_root

NAME

d_obtain_root - find or allocate a dentry for a given inode

SYNOPSIS

struct dentry * d_obtain_root(struct inode * inode);

ARGUMENTS

inode

: inode to allocate the dentry for

DESCRIPTION

Obtain an IS_ROOT dentry for the root of a filesystem.

We must ensure that directory inodes only ever have one dentry. If a dentry is found, that is returned instead of allocating a new one.

On successful return, the reference to the inode has been transferred to the dentry. In case of an error the reference on the inode is released. A NULL or IS_ERR inode may be passed in and will be the error will be propagate to the return value, with a NULLinode replaced by ERR_PTR(-ESTALE).