1<!-- HTML header for doxygen 1.8.8--> 2<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> 3<html xmlns="http://www.w3.org/1999/xhtml"> 4 <head> 5 <meta http-equiv="X-UA-Compatible" content="IE=edge"> 6 <!-- For Mobile Devices --> 7 <meta name="viewport" content="width=device-width, initial-scale=1"> 8 <meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/> 9 <meta name="generator" content="Doxygen 1.9.1"/> 10 <script type="text/javascript" src="https://code.jquery.com/jquery-2.1.1.min.js"></script> 11 <title>libevdev: Compatibility and Behavior across kernel versions</title> 12 <!--<link href="tabs.css" rel="stylesheet" type="text/css"/>--> 13 <script type="text/javascript" src="dynsections.js"></script> 14 <link href="search/search.css" rel="stylesheet" type="text/css"/> 15<script type="text/javascript" src="search/searchdata.js"></script> 16<script type="text/javascript" src="search/search.js"></script> 17 <link href="doxygen.css" rel="stylesheet" type="text/css" /> 18 <link href="bootstrap.css" rel="stylesheet" type="text/css"/> 19<link href="customdoxygen.css" rel="stylesheet" type="text/css"/> 20<link href="libevdevdoxygen.css" rel="stylesheet" type="text/css"/> 21 <script src="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.1/js/bootstrap.min.js"></script> 22 <script type="text/javascript" src="doxy-boot.js"></script> 23 </head> 24 <body> 25 <nav class="navbar navbar-default" role="navigation"> 26 <div class="container"> 27 <div class="navbar-header"> 28 <a class="navbar-brand">libevdev 1.12.1</a> 29 </div> 30 </div> 31 </nav> 32 <div id="top"><!-- do not remove this div, it is closed by doxygen! --> 33 <div class="content" id="content"> 34 <div class="container"> 35 <div class="row"> 36 <div class="col-sm-12 panel panel-default" style="padding-bottom: 15px;"> 37 <div style="margin-bottom: 15px;"> 38<!-- end header part --> 39<!-- Generated by Doxygen 1.9.1 --> 40<script type="text/javascript"> 41/* @license magnet:?xt=urn:btih:cf05388f2679ee054f2beb29a391d25f4e673ac3&dn=gpl-2.0.txt GPL-v2 */ 42var searchBox = new SearchBox("searchBox", "search",false,'Search','.html'); 43/* @license-end */ 44</script> 45<script type="text/javascript" src="menudata.js"></script> 46<script type="text/javascript" src="menu.js"></script> 47<script type="text/javascript"> 48/* @license magnet:?xt=urn:btih:cf05388f2679ee054f2beb29a391d25f4e673ac3&dn=gpl-2.0.txt GPL-v2 */ 49$(function() { 50 initMenu('',true,false,'search.php','Search'); 51 $(document).ready(function() { init_search(); }); 52}); 53/* @license-end */</script> 54<div id="main-nav"></div> 55<!-- window showing the filter options --> 56<div id="MSearchSelectWindow" 57 onmouseover="return searchBox.OnSearchSelectShow()" 58 onmouseout="return searchBox.OnSearchSelectHide()" 59 onkeydown="return searchBox.OnSearchSelectKey(event)"> 60</div> 61 62<!-- iframe showing the search results (closed by default) --> 63<div id="MSearchResultsWindow"> 64<iframe src="javascript:void(0)" frameborder="0" 65 name="MSearchResults" id="MSearchResults"> 66</iframe> 67</div> 68 69</div><!-- top --> 70<div class="PageDoc"><div class="header"> 71 <div class="headertitle"> 72<div class="title">Compatibility and Behavior across kernel versions </div> </div> 73</div><!--header--> 74<div class="contents"> 75<div class="textblock"><p>This page describes libevdev's behavior when the build-time kernel and the run-time kernel differ in their feature set.</p> 76<p>With the exception of event names, libevdev defines features that may be missing on older kernels and building on such kernels will not disable features. Running libevdev on a kernel that is missing some feature will change libevdev's behavior. In most cases, the new behavior should be obvious, but it is spelled out below in detail.</p> 77<h1><a class="anchor" id="autotoc_md14"></a> 78Minimum requirements</h1> 79<p>libevdev requires a 2.6.36 kernel as minimum. Specifically, it requires kernel-support for <code>ABS_MT_SLOT</code>.</p> 80<h1><a class="anchor" id="autotoc_md15"></a> 81Event and input property names</h1> 82<p>Event names and input property names are defined at build-time by the linux/input.h shipped with libevdev. The list of event names is compiled at build-time, any events not defined at build time will not resolve. Specifically, <a class="el" href="group__misc.html#gab407b3c2caaae502859c28460cad17bb">libevdev_event_code_get_name()</a> for an undefined type or code will always return <code>NULL</code>. Likewise, <a class="el" href="group__misc.html#gacc12bdb7b912070ac9c375428f2c9892">libevdev_property_get_name()</a> will return NULL for properties undefined at build-time.</p> 83<h1><a class="anchor" id="autotoc_md16"></a> 84Input properties</h1> 85<p>If the kernel does not support input properties, specifically the <code>EVIOCGPROPS</code> ioctl, libevdev does not expose input properties to the caller. Specifically, <a class="el" href="group__bits.html#ga36d529ea53f4522004bc7d16c051464b">libevdev_has_property()</a> will always return 0 unless the property has been manually set with <a class="el" href="group__kernel.html#gafc552080520c9d886452b05f3a1d75b6">libevdev_enable_property()</a>.</p> 86<p>This also applies to the libevdev-uinput code. If uinput does not honor <code>UI_SET_PROPBIT</code>, libevdev will continue without setting the properties on the device.</p> 87<h1><a class="anchor" id="autotoc_md17"></a> 88MT slot behavior</h1> 89<p>If the kernel does not support the <code>EVIOCGMTSLOTS</code> ioctl, libevdev assumes all values in all slots are 0 and continues without an error.</p> 90<h1><a class="anchor" id="autotoc_md18"></a> 91SYN_DROPPED behavior</h1> 92<p>A kernel without <code>SYN_DROPPED</code> won't send such an event. <a class="el" href="group__events.html#gabb96c864e836c0b98788f4ab771c3a76" title="Get the next event from the device.">libevdev_next_event()</a> will never require the switch to sync mode. </p> 93</div></div><!-- contents --> 94</div><!-- PageDoc --> 95<!-- HTML footer for doxygen 1.8.8--> 96<!-- start footer part --> 97</div> 98</div> 99</div> 100</div> 101</div> 102<hr class="footer"/><address class="footer"><small> 103Generated by  <a href="http://www.doxygen.org/index.html"> 104<img class="footer" src="doxygen.png" alt="doxygen"/> 105</a> 1.9.1 106</small></address> 107</body> 108</html> 109
