---
name: "d_obtain_root"
section: "9"
platform: "linux"
package: "linux-manual-4.9"
version: "4.9.228-1"
release: "Debian 9 (Stretch)"
platforms: ["linux"]
url: "https://new.carta.tech/d_obtain_root"
---

# d\_obtain\_root(9)

find or allocate a dentry for a given inode

## 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 **NULL** *inode* replaced by ERR\_PTR(-ESTALE).

## COPYRIGHT