<?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>The Userspace I/O HOWTO</title><meta name="generator" content="DocBook XSL Stylesheets V1.75.2" /><meta name="description" content="This HOWTO describes concept and usage of Linux kernel's Userspace I/O system." /><link rel="home" href="index.html" title="The Userspace I/O HOWTO" /><link rel="next" href="aboutthis.html" title="Chapter 1. About this document" /></head><body><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">The Userspace I/O HOWTO</th></tr><tr><td width="20%" align="left"> </td><th width="60%" align="center"> </th><td width="20%" align="right"> <a accesskey="n" href="aboutthis.html">Next</a></td></tr></table><hr /></div><div class="book" title="The Userspace I/O HOWTO"><div class="titlepage"><div><div><h1 class="title"><a id="index"></a>The Userspace I/O HOWTO</h1></div><div><div class="author"><h3 class="author"><span class="firstname">Hans-Jürgen</span> <span class="surname">Koch</span></h3><div class="affiliation"><span class="orgname"> <a class="ulink" href="http://www.linutronix.de" target="_top">Linutronix</a> <br /></span><div class="address"><p><br />    <code class="email"><<a class="email" href="mailto:hjk@linutronix.de">hjk@linutronix.de</a>></code><br /> </p></div></div></div></div><div><p class="copyright">Copyright © 2006-2008 Hans-Jürgen Koch.</p></div><div><p class="copyright">Copyright © 2009 Red Hat Inc, Michael S. Tsirkin (mst@redhat.com)</p></div><div><div class="legalnotice" title="Legal Notice"><a id="id2756374"></a><p> This documentation is Free Software licensed under the terms of the GPL version 2. </p></div></div><div><p class="pubdate">2006-12-11</p></div><div><div class="revhistory"><table border="1" width="100%" summary="Revision history"><tr><th align="left" valign="top" colspan="3"><b>Revision History</b></th></tr><tr><td align="left">Revision 0.9</td><td align="left">2009-07-16</td><td align="left">mst</td></tr><tr><td align="left" colspan="3">Added generic pci driver </td></tr><tr><td align="left">Revision 0.8</td><td align="left">2008-12-24</td><td align="left">hjk</td></tr><tr><td align="left" colspan="3">Added name attributes in mem and portio sysfs directories. </td></tr><tr><td align="left">Revision 0.7</td><td align="left">2008-12-23</td><td align="left">hjk</td></tr><tr><td align="left" colspan="3">Added generic platform drivers and offset attribute.</td></tr><tr><td align="left">Revision 0.6</td><td align="left">2008-12-05</td><td align="left">hjk</td></tr><tr><td align="left" colspan="3">Added description of portio sysfs attributes.</td></tr><tr><td align="left">Revision 0.5</td><td align="left">2008-05-22</td><td align="left">hjk</td></tr><tr><td align="left" colspan="3">Added description of write() function.</td></tr><tr><td align="left">Revision 0.4</td><td align="left">2007-11-26</td><td align="left">hjk</td></tr><tr><td align="left" colspan="3">Removed section about uio_dummy.</td></tr><tr><td align="left">Revision 0.3</td><td align="left">2007-04-29</td><td align="left">hjk</td></tr><tr><td align="left" colspan="3">Added section about userspace drivers.</td></tr><tr><td align="left">Revision 0.2</td><td align="left">2007-02-13</td><td align="left">hjk</td></tr><tr><td align="left" colspan="3">Update after multiple mappings were added.</td></tr><tr><td align="left">Revision 0.1</td><td align="left">2006-12-11</td><td align="left">hjk</td></tr><tr><td align="left" colspan="3">First draft.</td></tr></table></div></div><div><div class="abstract" title="Abstract"><p class="title"><b>Abstract</b></p><p>This HOWTO describes concept and usage of Linux kernel's Userspace I/O system.</p></div></div></div><hr /></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="chapter"><a href="aboutthis.html">1. About this document</a></span></dt><dd><dl><dt><span class="sect1"><a href="aboutthis.html#translations">Translations</a></span></dt><dt><span class="sect1"><a href="ch01s02.html">Preface</a></span></dt><dt><span class="sect1"><a href="ch01s03.html">Acknowledgments</a></span></dt><dt><span class="sect1"><a href="ch01s04.html">Feedback</a></span></dt></dl></dd><dt><span class="chapter"><a href="about.html">2. About UIO</a></span></dt><dd><dl><dt><span class="sect1"><a href="about.html#how_uio_works">How UIO works</a></span></dt></dl></dd><dt><span class="chapter"><a href="custom_kernel_module.html">3. Writing your own kernel module</a></span></dt><dd><dl><dt><span class="sect1"><a href="custom_kernel_module.html#uio_info">struct uio_info</a></span></dt><dt><span class="sect1"><a href="ch03s02.html">Adding an interrupt handler</a></span></dt><dt><span class="sect1"><a href="ch03s03.html">Using uio_pdrv for platform devices</a></span></dt><dt><span class="sect1"><a href="ch03s04.html">Using uio_pdrv_genirq for platform devices</a></span></dt></dl></dd><dt><span class="chapter"><a href="userspace_driver.html">4. Writing a driver in userspace</a></span></dt><dd><dl><dt><span class="sect1"><a href="userspace_driver.html#getting_uio_information">Getting information about your UIO device</a></span></dt><dt><span class="sect1"><a href="ch04s02.html">mmap() device memory</a></span></dt><dt><span class="sect1"><a href="ch04s03.html">Waiting for interrupts</a></span></dt></dl></dd><dt><span class="chapter"><a href="uio_pci_generic.html">5. Generic PCI UIO driver</a></span></dt><dd><dl><dt><span class="sect1"><a href="uio_pci_generic.html#uio_pci_generic_binding">Making the driver recognize the device</a></span></dt><dt><span class="sect1"><a href="ch05s02.html">Things to know about uio_pci_generic</a></span></dt><dt><span class="sect1"><a href="ch05s03.html">Writing userspace driver using uio_pci_generic</a></span></dt><dt><span class="sect1"><a href="ch05s04.html">Example code using uio_pci_generic</a></span></dt></dl></dd><dt><span class="appendix"><a href="apa.html">A. Further information</a></span></dt></dl></div></div><div class="navfooter"><hr /><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"> </td><td width="20%" align="center"> </td><td width="40%" align="right"> <a accesskey="n" href="aboutthis.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"> </td><td width="20%" align="center"> </td><td width="40%" align="right" valign="top"> Chapter 1. About this document</td></tr></table></div></body></html>
