1<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>d_obtain_alias</title><meta name="generator" content="DocBook XSL Stylesheets V1.78.1"><link rel="home" href="index.html" title="Linux Filesystems API"><link rel="up" href="the_directory_cache.html" title="The Directory Cache"><link rel="prev" href="API-d-find-any-alias.html" title="d_find_any_alias"><link rel="next" href="API-d-obtain-root.html" title="d_obtain_root"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center"><span class="phrase">d_obtain_alias</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-d-find-any-alias.html">Prev</a>&#160;</td><th width="60%" align="center">The Directory Cache</th><td width="20%" align="right">&#160;<a accesskey="n" href="API-d-obtain-root.html">Next</a></td></tr></table><hr></div><div class="refentry"><a name="API-d-obtain-alias"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>d_obtain_alias &#8212; 
2     find or allocate a DISCONNECTED dentry for a given inode
3 </p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="funcsynopsis"><table border="0" class="funcprototype-table" summary="Function synopsis" style="cellspacing: 0; cellpadding: 0;"><tr><td><code class="funcdef">struct dentry * <b class="fsfunc">d_obtain_alias </b>(</code></td><td>struct inode * <var class="pdparam">inode</var><code>)</code>;</td></tr></table><div class="funcprototype-spacer">&#160;</div></div></div><div class="refsect1"><a name="idp1101469636"></a><h2>Arguments</h2><div class="variablelist"><dl class="variablelist"><dt><span class="term"><em class="parameter"><code>inode</code></em></span></dt><dd><p>
4     inode to allocate the dentry for
5    </p></dd></dl></div></div><div class="refsect1"><a name="idp1101471212"></a><h2>Description</h2><p>
6   Obtain a dentry for an inode resulting from NFS filehandle conversion or
7   similar open by handle operations.  The returned dentry may be anonymous,
8   or may have a full name (if the inode was already in the cache).
9   </p><p>
10
11   When called on a directory inode, we must ensure that the inode only ever
12   has one dentry.  If a dentry is found, that is returned instead of
13   allocating a new one.
14   </p><p>
15
16   On successful return, the reference to the inode has been transferred
17   to the dentry.  In case of an error the reference on the inode is released.
18   To make it easier to use in export operations a <code class="constant">NULL</code> or IS_ERR inode may
19   be passed in and the error will be propagated to the return value,
20   with a <code class="constant">NULL</code> <em class="parameter"><code>inode</code></em> replaced by ERR_PTR(-ESTALE).
21</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-d-find-any-alias.html">Prev</a>&#160;</td><td width="20%" align="center"><a accesskey="u" href="the_directory_cache.html">Up</a></td><td width="40%" align="right">&#160;<a accesskey="n" href="API-d-obtain-root.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span class="phrase">d_find_any_alias</span>&#160;</td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top">&#160;<span class="phrase">d_obtain_root</span></td></tr></table></div></body></html>
22