<?xml version="1.0" encoding="ANSI_X3.4-1968" standalone="no"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968" /><title>dget</title><meta name="generator" content="DocBook XSL Stylesheets V1.75.2" /><link rel="home" href="index.html" title="Linux Filesystems API" /><link rel="up" href="ch01s02.html" title="The Directory Cache" /><link rel="prev" href="re26.html" title="d_add_unique" /><link rel="next" href="re28.html" title="d_unhashed" /></head><body><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center"><span>dget</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="re26.html">Prev</a> </td><th width="60%" align="center">The Directory Cache</th><td width="20%" align="right"> <a accesskey="n" href="re28.html">Next</a></td></tr></table><hr /></div><div class="refentry" title="dget"><a id="API-dget"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>dget —
get a reference to a dentry
</p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><div class="funcsynopsis"><table border="0" summary="Function synopsis" cellspacing="0" cellpadding="0" class="funcprototype-table"><tr><td><code class="funcdef">struct dentry * <b class="fsfunc">dget </b>(</code></td><td>struct dentry * <var class="pdparam">dentry</var><code>)</code>;</td></tr></table><div class="funcprototype-spacer"> </div></div></div><div class="refsect1" title="Arguments"><a id="id3100303"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>dentry</code></em></span></dt><dd><p>
dentry to get a reference to
</p></dd></dl></div></div><div class="refsect1" title="Description"><a id="id3100329"></a><h2>Description</h2><p>
Given a dentry or <code class="constant">NULL</code> pointer increment the reference count
if appropriate and return the dentry. A dentry will not be
destroyed when it has references. <code class="function">dget</code> should never be
called for dentries with zero reference counter. For these cases
(preferably none, functions in dcache.c are sufficient for normal
needs and they take necessary precautions) you should hold dcache_lock
and call <code class="function">dget_locked</code> instead of <code class="function">dget</code>.
</p></div></div><div class="navfooter"><hr /><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="re26.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="ch01s02.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="re28.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>d_add_unique</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>d_unhashed</span></td></tr></table></div></body></html>
