Sophie: kernel-doc-3.11.10-100.fc18 noarch

kernel-doc-3.11.10-100.fc18.noarch.rpm

<?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>device_register</title><meta name="generator" content="DocBook XSL Stylesheets V1.78.1" /><link rel="home" href="index.html" title="Linux Device Drivers" /><link rel="up" href="ch02s02.html" title="Device Drivers Base" /><link rel="prev" href="API-device-add.html" title="device_add" /><link rel="next" href="API-get-device.html" title="get_device" /></head><body><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center"><span class="phrase">device_register</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-device-add.html">Prev</a>&#160;</td><th width="60%" align="center">Device Drivers Base</th><td width="20%" align="right">&#160;<a accesskey="n" href="API-get-device.html">Next</a></td></tr></table><hr /></div><div class="refentry"><a id="API-device-register"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>device_register &#8212; 
     register a device with the system.
 </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">int <strong class="fsfunc">device_register </strong>(</code></td><td>struct device * <var class="pdparam">dev</var><code>)</code>;</td></tr></table><div class="funcprototype-spacer">&#160;</div></div></div><div class="refsect1"><a id="idm140404964938160"></a><h2>Arguments</h2><div class="variablelist"><dl class="variablelist"><dt><span class="term"><em class="parameter"><code>dev</code></em></span></dt><dd><p>
     pointer to the device structure
    </p></dd></dl></div></div><div class="refsect1"><a id="idm140404964934976"></a><h2>Description</h2><p>
   This happens in two clean steps - initialize the device
   and add it to the system. The two steps can be called
   separately, but this is the easiest and most common.
   I.e. you should only call the two helpers separately if
   have a clearly defined need to use and refcount the device
   before it is added to the hierarchy.
   </p><p>

   For more information, see the kerneldoc for <code class="function">device_initialize</code>
   and <code class="function">device_add</code>.
</p></div><div class="refsect1"><a id="idm140404964931712"></a><h2>NOTE</h2><p>
   _Never_ directly free <em class="parameter"><code>dev</code></em> after calling this function, even
   if it returned an error! Always use <code class="function">put_device</code> to give up the
   reference initialized in this function instead.
</p></div></div><div class="navfooter"><hr /><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-device-add.html">Prev</a>&#160;</td><td width="20%" align="center"><a accesskey="u" href="ch02s02.html">Up</a></td><td width="40%" align="right">&#160;<a accesskey="n" href="API-get-device.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span class="phrase">device_add</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">get_device</span></td></tr></table></div></body></html>