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: Modifying the appearance or capabilities of the device</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</div><!-- top --> 56<!-- window showing the filter options --> 57<div id="MSearchSelectWindow" 58 onmouseover="return searchBox.OnSearchSelectShow()" 59 onmouseout="return searchBox.OnSearchSelectHide()" 60 onkeydown="return searchBox.OnSearchSelectKey(event)"> 61</div> 62 63<!-- iframe showing the search results (closed by default) --> 64<div id="MSearchResultsWindow"> 65<iframe src="javascript:void(0)" frameborder="0" 66 name="MSearchResults" id="MSearchResults"> 67</iframe> 68</div> 69 70<div class="header"> 71 <div class="summary"> 72<a href="#enum-members">Enumerations</a> | 73<a href="#func-members">Functions</a> </div> 74 <div class="headertitle"> 75<div class="title">Modifying the appearance or capabilities of the device</div> </div> 76</div><!--header--> 77<div class="contents"> 78 79<p>Modifying the set of events reported by this device. 80<a href="#details">More...</a></p> 81<table class="memberdecls"> 82<tr class="heading"><td colspan="2"><h2 class="groupheader"><a name="enum-members"></a> 83Enumerations</h2></td></tr> 84<tr class="memitem:ga8cddf7779debef0067665671e911ec41"><td class="memItemLeft" align="right" valign="top">enum  </td><td class="memItemRight" valign="bottom"><a class="el" href="group__kernel.html#ga8cddf7779debef0067665671e911ec41">libevdev_led_value</a> { <a class="el" href="group__kernel.html#gga8cddf7779debef0067665671e911ec41a69d5a4cdf2a9357915fff0251a61d2ab">LIBEVDEV_LED_ON</a> 85, <a class="el" href="group__kernel.html#gga8cddf7779debef0067665671e911ec41a23e508440306c387ddf89acd2db9e065">LIBEVDEV_LED_OFF</a> 86 }</td></tr> 87<tr class="separator:ga8cddf7779debef0067665671e911ec41"><td class="memSeparator" colspan="2"> </td></tr> 88</table><table class="memberdecls"> 89<tr class="heading"><td colspan="2"><h2 class="groupheader"><a name="func-members"></a> 90Functions</h2></td></tr> 91<tr class="memitem:gae5dcdb7678cdc9be4ab1989725b4ed32"><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="group__kernel.html#gae5dcdb7678cdc9be4ab1989725b4ed32">libevdev_set_name</a> (struct libevdev *dev, const char *name)</td></tr> 92<tr class="memdesc:gae5dcdb7678cdc9be4ab1989725b4ed32"><td class="mdescLeft"> </td><td class="mdescRight">Change the device's name as returned by <a class="el" href="group__bits.html#gaed0328c67b7a78422636d9fe09a73f12" title="Retrieve the device's name, either as set by the caller or as read from the kernel.">libevdev_get_name()</a>. <a href="group__kernel.html#gae5dcdb7678cdc9be4ab1989725b4ed32">More...</a><br /></td></tr> 93<tr class="separator:gae5dcdb7678cdc9be4ab1989725b4ed32"><td class="memSeparator" colspan="2"> </td></tr> 94<tr class="memitem:gacd57c8d6ace8e0b1417809a9c1c67af3"><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="group__kernel.html#gacd57c8d6ace8e0b1417809a9c1c67af3">libevdev_set_phys</a> (struct libevdev *dev, const char *phys)</td></tr> 95<tr class="memdesc:gacd57c8d6ace8e0b1417809a9c1c67af3"><td class="mdescLeft"> </td><td class="mdescRight">Change the device's physical location as returned by <a class="el" href="group__bits.html#ga5df483b0b24d7b96ea1181808fab851d" title="Retrieve the device's physical location, either as set by the caller or as read from the kernel.">libevdev_get_phys()</a>. <a href="group__kernel.html#gacd57c8d6ace8e0b1417809a9c1c67af3">More...</a><br /></td></tr> 96<tr class="separator:gacd57c8d6ace8e0b1417809a9c1c67af3"><td class="memSeparator" colspan="2"> </td></tr> 97<tr class="memitem:ga4e4fd2627744fd5811c50c7403f27ad7"><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="group__kernel.html#ga4e4fd2627744fd5811c50c7403f27ad7">libevdev_set_uniq</a> (struct libevdev *dev, const char *uniq)</td></tr> 98<tr class="memdesc:ga4e4fd2627744fd5811c50c7403f27ad7"><td class="mdescLeft"> </td><td class="mdescRight">Change the device's unique identifier as returned by <a class="el" href="group__bits.html#ga6d9f7d44bff8828ead3d251177035ca4" title="Retrieve the device's unique identifier, either as set by the caller or as read from the kernel.">libevdev_get_uniq()</a>. <a href="group__kernel.html#ga4e4fd2627744fd5811c50c7403f27ad7">More...</a><br /></td></tr> 99<tr class="separator:ga4e4fd2627744fd5811c50c7403f27ad7"><td class="memSeparator" colspan="2"> </td></tr> 100<tr class="memitem:ga62fbdaac056ab5c3db154a9eeaf33799"><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="group__kernel.html#ga62fbdaac056ab5c3db154a9eeaf33799">libevdev_set_id_product</a> (struct libevdev *dev, int product_id)</td></tr> 101<tr class="separator:ga62fbdaac056ab5c3db154a9eeaf33799"><td class="memSeparator" colspan="2"> </td></tr> 102<tr class="memitem:ga8ce28051ebbb73de1d04d782f4d0d6fe"><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="group__kernel.html#ga8ce28051ebbb73de1d04d782f4d0d6fe">libevdev_set_id_vendor</a> (struct libevdev *dev, int vendor_id)</td></tr> 103<tr class="separator:ga8ce28051ebbb73de1d04d782f4d0d6fe"><td class="memSeparator" colspan="2"> </td></tr> 104<tr class="memitem:gaf99139c728ba1bd4b37ede612780b6b0"><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="group__kernel.html#gaf99139c728ba1bd4b37ede612780b6b0">libevdev_set_id_bustype</a> (struct libevdev *dev, int bustype)</td></tr> 105<tr class="separator:gaf99139c728ba1bd4b37ede612780b6b0"><td class="memSeparator" colspan="2"> </td></tr> 106<tr class="memitem:gaee1d2db88b191ec21d5bf22dd4fe3055"><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="group__kernel.html#gaee1d2db88b191ec21d5bf22dd4fe3055">libevdev_set_id_version</a> (struct libevdev *dev, int version)</td></tr> 107<tr class="separator:gaee1d2db88b191ec21d5bf22dd4fe3055"><td class="memSeparator" colspan="2"> </td></tr> 108<tr class="memitem:gafc552080520c9d886452b05f3a1d75b6"><td class="memItemLeft" align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="group__kernel.html#gafc552080520c9d886452b05f3a1d75b6">libevdev_enable_property</a> (struct libevdev *dev, unsigned int prop)</td></tr> 109<tr class="separator:gafc552080520c9d886452b05f3a1d75b6"><td class="memSeparator" colspan="2"> </td></tr> 110<tr class="memitem:ga8f6367c36331c803ad69b2591e210019"><td class="memItemLeft" align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="group__kernel.html#ga8f6367c36331c803ad69b2591e210019">libevdev_disable_property</a> (struct libevdev *dev, unsigned int prop)</td></tr> 111<tr class="separator:ga8f6367c36331c803ad69b2591e210019"><td class="memSeparator" colspan="2"> </td></tr> 112<tr class="memitem:ga79e82ee2a95cb08adb4172aabe0c7184"><td class="memItemLeft" align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="group__kernel.html#ga79e82ee2a95cb08adb4172aabe0c7184">libevdev_set_event_value</a> (struct libevdev *dev, unsigned int type, unsigned int code, int value)</td></tr> 113<tr class="memdesc:ga79e82ee2a95cb08adb4172aabe0c7184"><td class="mdescLeft"> </td><td class="mdescRight">Set the value for a given event type and code. <a href="group__kernel.html#ga79e82ee2a95cb08adb4172aabe0c7184">More...</a><br /></td></tr> 114<tr class="separator:ga79e82ee2a95cb08adb4172aabe0c7184"><td class="memSeparator" colspan="2"> </td></tr> 115<tr class="memitem:ga0c61f4919b03b0850529a50c37a20333"><td class="memItemLeft" align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="group__kernel.html#ga0c61f4919b03b0850529a50c37a20333">libevdev_set_slot_value</a> (struct libevdev *dev, unsigned int slot, unsigned int code, int value)</td></tr> 116<tr class="memdesc:ga0c61f4919b03b0850529a50c37a20333"><td class="mdescLeft"> </td><td class="mdescRight">Set the value for a given code for the given slot. <a href="group__kernel.html#ga0c61f4919b03b0850529a50c37a20333">More...</a><br /></td></tr> 117<tr class="separator:ga0c61f4919b03b0850529a50c37a20333"><td class="memSeparator" colspan="2"> </td></tr> 118<tr class="memitem:gaca62172c2a823cd02eacf0d2292d917a"><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="group__kernel.html#gaca62172c2a823cd02eacf0d2292d917a">libevdev_set_abs_minimum</a> (struct libevdev *dev, unsigned int code, int val)</td></tr> 119<tr class="memdesc:gaca62172c2a823cd02eacf0d2292d917a"><td class="mdescLeft"> </td><td class="mdescRight">Change the minimum for the given EV_ABS event code, if the code exists. <a href="group__kernel.html#gaca62172c2a823cd02eacf0d2292d917a">More...</a><br /></td></tr> 120<tr class="separator:gaca62172c2a823cd02eacf0d2292d917a"><td class="memSeparator" colspan="2"> </td></tr> 121<tr class="memitem:ga2302fd9a491d8e27280157d67a703af6"><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="group__kernel.html#ga2302fd9a491d8e27280157d67a703af6">libevdev_set_abs_maximum</a> (struct libevdev *dev, unsigned int code, int val)</td></tr> 122<tr class="memdesc:ga2302fd9a491d8e27280157d67a703af6"><td class="mdescLeft"> </td><td class="mdescRight">Change the maximum for the given EV_ABS event code, if the code exists. <a href="group__kernel.html#ga2302fd9a491d8e27280157d67a703af6">More...</a><br /></td></tr> 123<tr class="separator:ga2302fd9a491d8e27280157d67a703af6"><td class="memSeparator" colspan="2"> </td></tr> 124<tr class="memitem:gaa192bf0c68620be819337da6ec361c21"><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="group__kernel.html#gaa192bf0c68620be819337da6ec361c21">libevdev_set_abs_fuzz</a> (struct libevdev *dev, unsigned int code, int val)</td></tr> 125<tr class="memdesc:gaa192bf0c68620be819337da6ec361c21"><td class="mdescLeft"> </td><td class="mdescRight">Change the fuzz for the given EV_ABS event code, if the code exists. <a href="group__kernel.html#gaa192bf0c68620be819337da6ec361c21">More...</a><br /></td></tr> 126<tr class="separator:gaa192bf0c68620be819337da6ec361c21"><td class="memSeparator" colspan="2"> </td></tr> 127<tr class="memitem:gabd309f30744a49e9391250b00ba2d67a"><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="group__kernel.html#gabd309f30744a49e9391250b00ba2d67a">libevdev_set_abs_flat</a> (struct libevdev *dev, unsigned int code, int val)</td></tr> 128<tr class="memdesc:gabd309f30744a49e9391250b00ba2d67a"><td class="mdescLeft"> </td><td class="mdescRight">Change the flat for the given EV_ABS event code, if the code exists. <a href="group__kernel.html#gabd309f30744a49e9391250b00ba2d67a">More...</a><br /></td></tr> 129<tr class="separator:gabd309f30744a49e9391250b00ba2d67a"><td class="memSeparator" colspan="2"> </td></tr> 130<tr class="memitem:ga2266b59711cdaa4fc12fa56c9313a038"><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="group__kernel.html#ga2266b59711cdaa4fc12fa56c9313a038">libevdev_set_abs_resolution</a> (struct libevdev *dev, unsigned int code, int val)</td></tr> 131<tr class="memdesc:ga2266b59711cdaa4fc12fa56c9313a038"><td class="mdescLeft"> </td><td class="mdescRight">Change the resolution for the given EV_ABS event code, if the code exists. <a href="group__kernel.html#ga2266b59711cdaa4fc12fa56c9313a038">More...</a><br /></td></tr> 132<tr class="separator:ga2266b59711cdaa4fc12fa56c9313a038"><td class="memSeparator" colspan="2"> </td></tr> 133<tr class="memitem:gafc7a4f5308e2dbf55f875630b8dca049"><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="group__kernel.html#gafc7a4f5308e2dbf55f875630b8dca049">libevdev_set_abs_info</a> (struct libevdev *dev, unsigned int code, const struct input_absinfo *abs)</td></tr> 134<tr class="memdesc:gafc7a4f5308e2dbf55f875630b8dca049"><td class="mdescLeft"> </td><td class="mdescRight">Change the abs info for the given EV_ABS event code, if the code exists. <a href="group__kernel.html#gafc7a4f5308e2dbf55f875630b8dca049">More...</a><br /></td></tr> 135<tr class="separator:gafc7a4f5308e2dbf55f875630b8dca049"><td class="memSeparator" colspan="2"> </td></tr> 136<tr class="memitem:ga59ef78b1557f9543d0060ab25b0167ca"><td class="memItemLeft" align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="group__kernel.html#ga59ef78b1557f9543d0060ab25b0167ca">libevdev_enable_event_type</a> (struct libevdev *dev, unsigned int type)</td></tr> 137<tr class="memdesc:ga59ef78b1557f9543d0060ab25b0167ca"><td class="mdescLeft"> </td><td class="mdescRight">Forcibly enable an event type on this device, even if the underlying device does not support it. <a href="group__kernel.html#ga59ef78b1557f9543d0060ab25b0167ca">More...</a><br /></td></tr> 138<tr class="separator:ga59ef78b1557f9543d0060ab25b0167ca"><td class="memSeparator" colspan="2"> </td></tr> 139<tr class="memitem:gabbacb53b66882b5335055c0fd1f40d9a"><td class="memItemLeft" align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="group__kernel.html#gabbacb53b66882b5335055c0fd1f40d9a">libevdev_disable_event_type</a> (struct libevdev *dev, unsigned int type)</td></tr> 140<tr class="memdesc:gabbacb53b66882b5335055c0fd1f40d9a"><td class="mdescLeft"> </td><td class="mdescRight">Forcibly disable an event type on this device, even if the underlying device provides it. <a href="group__kernel.html#gabbacb53b66882b5335055c0fd1f40d9a">More...</a><br /></td></tr> 141<tr class="separator:gabbacb53b66882b5335055c0fd1f40d9a"><td class="memSeparator" colspan="2"> </td></tr> 142<tr class="memitem:ga51cfda33fd526549046399aadd764fca"><td class="memItemLeft" align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="group__kernel.html#ga51cfda33fd526549046399aadd764fca">libevdev_enable_event_code</a> (struct libevdev *dev, unsigned int type, unsigned int code, const void *data)</td></tr> 143<tr class="memdesc:ga51cfda33fd526549046399aadd764fca"><td class="mdescLeft"> </td><td class="mdescRight">Forcibly enable an event code on this device, even if the underlying device does not support it. <a href="group__kernel.html#ga51cfda33fd526549046399aadd764fca">More...</a><br /></td></tr> 144<tr class="separator:ga51cfda33fd526549046399aadd764fca"><td class="memSeparator" colspan="2"> </td></tr> 145<tr class="memitem:ga6199a7c8144f54e092e913c2d2df16de"><td class="memItemLeft" align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="group__kernel.html#ga6199a7c8144f54e092e913c2d2df16de">libevdev_disable_event_code</a> (struct libevdev *dev, unsigned int type, unsigned int code)</td></tr> 146<tr class="memdesc:ga6199a7c8144f54e092e913c2d2df16de"><td class="mdescLeft"> </td><td class="mdescRight">Forcibly disable an event code on this device, even if the underlying device provides it. <a href="group__kernel.html#ga6199a7c8144f54e092e913c2d2df16de">More...</a><br /></td></tr> 147<tr class="separator:ga6199a7c8144f54e092e913c2d2df16de"><td class="memSeparator" colspan="2"> </td></tr> 148<tr class="memitem:ga41c0321b93349d0ddd1f1c007ccf7de9"><td class="memItemLeft" align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="group__kernel.html#ga41c0321b93349d0ddd1f1c007ccf7de9">libevdev_kernel_set_abs_info</a> (struct libevdev *dev, unsigned int code, const struct input_absinfo *abs)</td></tr> 149<tr class="memdesc:ga41c0321b93349d0ddd1f1c007ccf7de9"><td class="mdescLeft"> </td><td class="mdescRight">Set the device's EV_ABS axis to the value defined in the abs parameter. <a href="group__kernel.html#ga41c0321b93349d0ddd1f1c007ccf7de9">More...</a><br /></td></tr> 150<tr class="separator:ga41c0321b93349d0ddd1f1c007ccf7de9"><td class="memSeparator" colspan="2"> </td></tr> 151<tr class="memitem:gaa7d13aeac3c40e16f296467780e67c01"><td class="memItemLeft" align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="group__kernel.html#gaa7d13aeac3c40e16f296467780e67c01">libevdev_kernel_set_led_value</a> (struct libevdev *dev, unsigned int code, enum <a class="el" href="group__kernel.html#ga8cddf7779debef0067665671e911ec41">libevdev_led_value</a> value)</td></tr> 152<tr class="memdesc:gaa7d13aeac3c40e16f296467780e67c01"><td class="mdescLeft"> </td><td class="mdescRight">Turn an LED on or off. <a href="group__kernel.html#gaa7d13aeac3c40e16f296467780e67c01">More...</a><br /></td></tr> 153<tr class="separator:gaa7d13aeac3c40e16f296467780e67c01"><td class="memSeparator" colspan="2"> </td></tr> 154<tr class="memitem:ga93a19fa6e5be57903aff7c4a60af2a00"><td class="memItemLeft" align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="group__kernel.html#ga93a19fa6e5be57903aff7c4a60af2a00">libevdev_kernel_set_led_values</a> (struct libevdev *dev,...)</td></tr> 155<tr class="memdesc:ga93a19fa6e5be57903aff7c4a60af2a00"><td class="mdescLeft"> </td><td class="mdescRight">Turn multiple LEDs on or off simultaneously. <a href="group__kernel.html#ga93a19fa6e5be57903aff7c4a60af2a00">More...</a><br /></td></tr> 156<tr class="separator:ga93a19fa6e5be57903aff7c4a60af2a00"><td class="memSeparator" colspan="2"> </td></tr> 157<tr class="memitem:ga2925b6fbf8c7991ff2164424b840b82d"><td class="memItemLeft" align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="group__kernel.html#ga2925b6fbf8c7991ff2164424b840b82d">libevdev_set_clock_id</a> (struct libevdev *dev, int clockid)</td></tr> 158<tr class="memdesc:ga2925b6fbf8c7991ff2164424b840b82d"><td class="mdescLeft"> </td><td class="mdescRight">Set the clock ID to be used for timestamps. <a href="group__kernel.html#ga2925b6fbf8c7991ff2164424b840b82d">More...</a><br /></td></tr> 159<tr class="separator:ga2925b6fbf8c7991ff2164424b840b82d"><td class="memSeparator" colspan="2"> </td></tr> 160</table> 161<a name="details" id="details"></a><h2 class="groupheader">Detailed Description</h2> 162<p>Modifying the set of events reported by this device. </p> 163<p>By default, the libevdev device mirrors the kernel device, enabling only those bits exported by the kernel. This set of functions enable or disable bits as seen from the caller.</p> 164<p>Enabling an event type or code does not affect event reporting - a software-enabled event will not be generated by the physical hardware. Disabling an event will prevent libevdev from routing such events to the caller. Enabling and disabling event types and codes is at the library level and thus only affects the caller.</p> 165<p>If an event type or code is enabled at kernel-level, future users of this device will see this event enabled. Currently there is no option of disabling an event type or code at kernel-level. </p> 166<h2 class="groupheader">Enumeration Type Documentation</h2> 167<a id="ga8cddf7779debef0067665671e911ec41"></a> 168<h2 class="memtitle"><span class="permalink"><a href="#ga8cddf7779debef0067665671e911ec41">◆ </a></span>libevdev_led_value</h2> 169 170<div class="memitem"> 171<div class="memproto"> 172 <table class="memname"> 173 <tr> 174 <td class="memname">enum <a class="el" href="group__kernel.html#ga8cddf7779debef0067665671e911ec41">libevdev_led_value</a></td> 175 </tr> 176 </table> 177</div><div class="memdoc"> 178<table class="fieldtable"> 179<tr><th colspan="2">Enumerator</th></tr><tr><td class="fieldname"><a id="gga8cddf7779debef0067665671e911ec41a69d5a4cdf2a9357915fff0251a61d2ab"></a>LIBEVDEV_LED_ON </td><td class="fielddoc"><p>Turn the LED on. </p> 180</td></tr> 181<tr><td class="fieldname"><a id="gga8cddf7779debef0067665671e911ec41a23e508440306c387ddf89acd2db9e065"></a>LIBEVDEV_LED_OFF </td><td class="fielddoc"><p>Turn the LED off. </p> 182</td></tr> 183</table> 184 185</div> 186</div> 187<h2 class="groupheader">Function Documentation</h2> 188<a id="ga6199a7c8144f54e092e913c2d2df16de"></a> 189<h2 class="memtitle"><span class="permalink"><a href="#ga6199a7c8144f54e092e913c2d2df16de">◆ </a></span>libevdev_disable_event_code()</h2> 190 191<div class="memitem"> 192<div class="memproto"> 193 <table class="memname"> 194 <tr> 195 <td class="memname">int libevdev_disable_event_code </td> 196 <td>(</td> 197 <td class="paramtype">struct libevdev * </td> 198 <td class="paramname"><em>dev</em>, </td> 199 </tr> 200 <tr> 201 <td class="paramkey"></td> 202 <td></td> 203 <td class="paramtype">unsigned int </td> 204 <td class="paramname"><em>type</em>, </td> 205 </tr> 206 <tr> 207 <td class="paramkey"></td> 208 <td></td> 209 <td class="paramtype">unsigned int </td> 210 <td class="paramname"><em>code</em> </td> 211 </tr> 212 <tr> 213 <td></td> 214 <td>)</td> 215 <td></td><td></td> 216 </tr> 217 </table> 218</div><div class="memdoc"> 219 220<p>Forcibly disable an event code on this device, even if the underlying device provides it. </p> 221<p>This effectively mutes the respective set of events. libevdev will filter any events matching this type and code and none will reach the caller. <a class="el" href="group__bits.html#gab2ab9dad417f33daa79fa0c3d682df0b">libevdev_has_event_code()</a> will return false for this code.</p> 222<p>Disabling all event codes for a given type will not disable the event type. Use <a class="el" href="group__kernel.html#gabbacb53b66882b5335055c0fd1f40d9a" title="Forcibly disable an event type on this device, even if the underlying device provides it.">libevdev_disable_event_type()</a> for that.</p> 223<p>This is a local modification only affecting only this representation of this device.</p> 224<p>Disabling codes of type EV_SYN will not work. Don't shoot yourself in the foot. It hurts.</p> 225<dl class="params"><dt>Parameters</dt><dd> 226 <table class="params"> 227 <tr><td class="paramname">dev</td><td>The evdev device, already initialized with <a class="el" href="group__init.html#ga6658ac490d68c307ff8b8d1536c12b44" title="Set the fd for this struct and initialize internal data.">libevdev_set_fd()</a> </td></tr> 228 <tr><td class="paramname">type</td><td>The event type to disable (EV_ABS, EV_KEY, ...) </td></tr> 229 <tr><td class="paramname">code</td><td>The event code to disable (ABS_X, REL_X, etc.)</td></tr> 230 </table> 231 </dd> 232</dl> 233<dl class="section return"><dt>Returns</dt><dd>0 on success or -1 otherwise</dd></dl> 234<dl class="section see"><dt>See also</dt><dd><a class="el" href="group__bits.html#gab2ab9dad417f33daa79fa0c3d682df0b">libevdev_has_event_code</a> </dd> 235<dd> 236<a class="el" href="group__kernel.html#gabbacb53b66882b5335055c0fd1f40d9a" title="Forcibly disable an event type on this device, even if the underlying device provides it.">libevdev_disable_event_type</a> </dd></dl> 237 238</div> 239</div> 240<a id="gabbacb53b66882b5335055c0fd1f40d9a"></a> 241<h2 class="memtitle"><span class="permalink"><a href="#gabbacb53b66882b5335055c0fd1f40d9a">◆ </a></span>libevdev_disable_event_type()</h2> 242 243<div class="memitem"> 244<div class="memproto"> 245 <table class="memname"> 246 <tr> 247 <td class="memname">int libevdev_disable_event_type </td> 248 <td>(</td> 249 <td class="paramtype">struct libevdev * </td> 250 <td class="paramname"><em>dev</em>, </td> 251 </tr> 252 <tr> 253 <td class="paramkey"></td> 254 <td></td> 255 <td class="paramtype">unsigned int </td> 256 <td class="paramname"><em>type</em> </td> 257 </tr> 258 <tr> 259 <td></td> 260 <td>)</td> 261 <td></td><td></td> 262 </tr> 263 </table> 264</div><div class="memdoc"> 265 266<p>Forcibly disable an event type on this device, even if the underlying device provides it. </p> 267<p>This effectively mutes the respective set of events. libevdev will filter any events matching this type and none will reach the caller. <a class="el" href="group__bits.html#ga398bef155fa4a0cfb832de30723ebd14">libevdev_has_event_type()</a> will return false for this type.</p> 268<p>In most cases, a caller likely only wants to disable a single code, not the whole type. Use <a class="el" href="group__kernel.html#ga6199a7c8144f54e092e913c2d2df16de" title="Forcibly disable an event code on this device, even if the underlying device provides it.">libevdev_disable_event_code()</a> for that.</p> 269<p>Disabling EV_SYN will not work. Don't shoot yourself in the foot. It hurts.</p> 270<p>This is a local modification only affecting only this representation of this device.</p> 271<dl class="params"><dt>Parameters</dt><dd> 272 <table class="params"> 273 <tr><td class="paramname">dev</td><td>The evdev device, already initialized with <a class="el" href="group__init.html#ga6658ac490d68c307ff8b8d1536c12b44" title="Set the fd for this struct and initialize internal data.">libevdev_set_fd()</a> </td></tr> 274 <tr><td class="paramname">type</td><td>The event type to disable (EV_ABS, EV_KEY, ...)</td></tr> 275 </table> 276 </dd> 277</dl> 278<dl class="section return"><dt>Returns</dt><dd>0 on success or -1 otherwise</dd></dl> 279<dl class="section see"><dt>See also</dt><dd><a class="el" href="group__bits.html#ga398bef155fa4a0cfb832de30723ebd14">libevdev_has_event_type</a> </dd> 280<dd> 281<a class="el" href="group__kernel.html#gabbacb53b66882b5335055c0fd1f40d9a" title="Forcibly disable an event type on this device, even if the underlying device provides it.">libevdev_disable_event_type</a> </dd></dl> 282 283</div> 284</div> 285<a id="ga8f6367c36331c803ad69b2591e210019"></a> 286<h2 class="memtitle"><span class="permalink"><a href="#ga8f6367c36331c803ad69b2591e210019">◆ </a></span>libevdev_disable_property()</h2> 287 288<div class="memitem"> 289<div class="memproto"> 290 <table class="memname"> 291 <tr> 292 <td class="memname">int libevdev_disable_property </td> 293 <td>(</td> 294 <td class="paramtype">struct libevdev * </td> 295 <td class="paramname"><em>dev</em>, </td> 296 </tr> 297 <tr> 298 <td class="paramkey"></td> 299 <td></td> 300 <td class="paramtype">unsigned int </td> 301 <td class="paramname"><em>prop</em> </td> 302 </tr> 303 <tr> 304 <td></td> 305 <td>)</td> 306 <td></td><td></td> 307 </tr> 308 </table> 309</div><div class="memdoc"> 310<dl class="params"><dt>Parameters</dt><dd> 311 <table class="params"> 312 <tr><td class="paramname">dev</td><td>The evdev device </td></tr> 313 <tr><td class="paramname">prop</td><td>The input property to disable, one of INPUT_PROP_...</td></tr> 314 </table> 315 </dd> 316</dl> 317<dl class="section return"><dt>Returns</dt><dd>0 on success or -1 on failure </dd></dl> 318 319</div> 320</div> 321<a id="ga51cfda33fd526549046399aadd764fca"></a> 322<h2 class="memtitle"><span class="permalink"><a href="#ga51cfda33fd526549046399aadd764fca">◆ </a></span>libevdev_enable_event_code()</h2> 323 324<div class="memitem"> 325<div class="memproto"> 326 <table class="memname"> 327 <tr> 328 <td class="memname">int libevdev_enable_event_code </td> 329 <td>(</td> 330 <td class="paramtype">struct libevdev * </td> 331 <td class="paramname"><em>dev</em>, </td> 332 </tr> 333 <tr> 334 <td class="paramkey"></td> 335 <td></td> 336 <td class="paramtype">unsigned int </td> 337 <td class="paramname"><em>type</em>, </td> 338 </tr> 339 <tr> 340 <td class="paramkey"></td> 341 <td></td> 342 <td class="paramtype">unsigned int </td> 343 <td class="paramname"><em>code</em>, </td> 344 </tr> 345 <tr> 346 <td class="paramkey"></td> 347 <td></td> 348 <td class="paramtype">const void * </td> 349 <td class="paramname"><em>data</em> </td> 350 </tr> 351 <tr> 352 <td></td> 353 <td>)</td> 354 <td></td><td></td> 355 </tr> 356 </table> 357</div><div class="memdoc"> 358 359<p>Forcibly enable an event code on this device, even if the underlying device does not support it. </p> 360<p>While this cannot make the device actually report such events, it will now return true for <a class="el" href="group__bits.html#gab2ab9dad417f33daa79fa0c3d682df0b">libevdev_has_event_code()</a>.</p> 361<p>The last argument depends on the type and code:</p><ul> 362<li>If type is EV_ABS, data must be a pointer to a struct input_absinfo containing the data for this axis.</li> 363<li>If type is EV_REP, data must be a pointer to a int containing the data for this axis</li> 364<li>For all other types, the argument must be NULL.</li> 365</ul> 366<p>This function calls <a class="el" href="group__kernel.html#ga59ef78b1557f9543d0060ab25b0167ca" title="Forcibly enable an event type on this device, even if the underlying device does not support it.">libevdev_enable_event_type()</a> if necessary.</p> 367<p>This is a local modification only affecting only this representation of this device.</p> 368<p>If this function is called with a type of EV_ABS and EV_REP on a device that already has the given event code enabled, the values in data overwrite the previous values.</p> 369<dl class="params"><dt>Parameters</dt><dd> 370 <table class="params"> 371 <tr><td class="paramname">dev</td><td>The evdev device, already initialized with <a class="el" href="group__init.html#ga6658ac490d68c307ff8b8d1536c12b44" title="Set the fd for this struct and initialize internal data.">libevdev_set_fd()</a> </td></tr> 372 <tr><td class="paramname">type</td><td>The event type to enable (EV_ABS, EV_KEY, ...) </td></tr> 373 <tr><td class="paramname">code</td><td>The event code to enable (ABS_X, REL_X, etc.) </td></tr> 374 <tr><td class="paramname">data</td><td>If type is EV_ABS, data points to a struct input_absinfo. If type is EV_REP, data points to an integer. Otherwise, data must be NULL.</td></tr> 375 </table> 376 </dd> 377</dl> 378<dl class="section return"><dt>Returns</dt><dd>0 on success or -1 otherwise</dd></dl> 379<dl class="section see"><dt>See also</dt><dd><a class="el" href="group__kernel.html#ga59ef78b1557f9543d0060ab25b0167ca" title="Forcibly enable an event type on this device, even if the underlying device does not support it.">libevdev_enable_event_type</a> </dd></dl> 380 381</div> 382</div> 383<a id="ga59ef78b1557f9543d0060ab25b0167ca"></a> 384<h2 class="memtitle"><span class="permalink"><a href="#ga59ef78b1557f9543d0060ab25b0167ca">◆ </a></span>libevdev_enable_event_type()</h2> 385 386<div class="memitem"> 387<div class="memproto"> 388 <table class="memname"> 389 <tr> 390 <td class="memname">int libevdev_enable_event_type </td> 391 <td>(</td> 392 <td class="paramtype">struct libevdev * </td> 393 <td class="paramname"><em>dev</em>, </td> 394 </tr> 395 <tr> 396 <td class="paramkey"></td> 397 <td></td> 398 <td class="paramtype">unsigned int </td> 399 <td class="paramname"><em>type</em> </td> 400 </tr> 401 <tr> 402 <td></td> 403 <td>)</td> 404 <td></td><td></td> 405 </tr> 406 </table> 407</div><div class="memdoc"> 408 409<p>Forcibly enable an event type on this device, even if the underlying device does not support it. </p> 410<p>While this cannot make the device actually report such events, it will now return true for <a class="el" href="group__bits.html#ga398bef155fa4a0cfb832de30723ebd14">libevdev_has_event_type()</a>.</p> 411<p>This is a local modification only affecting only this representation of this device.</p> 412<dl class="params"><dt>Parameters</dt><dd> 413 <table class="params"> 414 <tr><td class="paramname">dev</td><td>The evdev device, already initialized with <a class="el" href="group__init.html#ga6658ac490d68c307ff8b8d1536c12b44" title="Set the fd for this struct and initialize internal data.">libevdev_set_fd()</a> </td></tr> 415 <tr><td class="paramname">type</td><td>The event type to enable (EV_ABS, EV_KEY, ...)</td></tr> 416 </table> 417 </dd> 418</dl> 419<dl class="section return"><dt>Returns</dt><dd>0 on success or -1 otherwise</dd></dl> 420<dl class="section see"><dt>See also</dt><dd><a class="el" href="group__bits.html#ga398bef155fa4a0cfb832de30723ebd14">libevdev_has_event_type</a> </dd></dl> 421 422</div> 423</div> 424<a id="gafc552080520c9d886452b05f3a1d75b6"></a> 425<h2 class="memtitle"><span class="permalink"><a href="#gafc552080520c9d886452b05f3a1d75b6">◆ </a></span>libevdev_enable_property()</h2> 426 427<div class="memitem"> 428<div class="memproto"> 429 <table class="memname"> 430 <tr> 431 <td class="memname">int libevdev_enable_property </td> 432 <td>(</td> 433 <td class="paramtype">struct libevdev * </td> 434 <td class="paramname"><em>dev</em>, </td> 435 </tr> 436 <tr> 437 <td class="paramkey"></td> 438 <td></td> 439 <td class="paramtype">unsigned int </td> 440 <td class="paramname"><em>prop</em> </td> 441 </tr> 442 <tr> 443 <td></td> 444 <td>)</td> 445 <td></td><td></td> 446 </tr> 447 </table> 448</div><div class="memdoc"> 449<dl class="params"><dt>Parameters</dt><dd> 450 <table class="params"> 451 <tr><td class="paramname">dev</td><td>The evdev device </td></tr> 452 <tr><td class="paramname">prop</td><td>The input property to enable, one of INPUT_PROP_...</td></tr> 453 </table> 454 </dd> 455</dl> 456<dl class="section return"><dt>Returns</dt><dd>0 on success or -1 on failure</dd></dl> 457<dl class="section note"><dt>Note</dt><dd>This function may be called before <a class="el" href="group__init.html#ga6658ac490d68c307ff8b8d1536c12b44" title="Set the fd for this struct and initialize internal data.">libevdev_set_fd()</a>. A call to <a class="el" href="group__init.html#ga6658ac490d68c307ff8b8d1536c12b44" title="Set the fd for this struct and initialize internal data.">libevdev_set_fd()</a> will overwrite any previously set value. </dd></dl> 458 459</div> 460</div> 461<a id="ga41c0321b93349d0ddd1f1c007ccf7de9"></a> 462<h2 class="memtitle"><span class="permalink"><a href="#ga41c0321b93349d0ddd1f1c007ccf7de9">◆ </a></span>libevdev_kernel_set_abs_info()</h2> 463 464<div class="memitem"> 465<div class="memproto"> 466 <table class="memname"> 467 <tr> 468 <td class="memname">int libevdev_kernel_set_abs_info </td> 469 <td>(</td> 470 <td class="paramtype">struct libevdev * </td> 471 <td class="paramname"><em>dev</em>, </td> 472 </tr> 473 <tr> 474 <td class="paramkey"></td> 475 <td></td> 476 <td class="paramtype">unsigned int </td> 477 <td class="paramname"><em>code</em>, </td> 478 </tr> 479 <tr> 480 <td class="paramkey"></td> 481 <td></td> 482 <td class="paramtype">const struct input_absinfo * </td> 483 <td class="paramname"><em>abs</em> </td> 484 </tr> 485 <tr> 486 <td></td> 487 <td>)</td> 488 <td></td><td></td> 489 </tr> 490 </table> 491</div><div class="memdoc"> 492 493<p>Set the device's EV_ABS axis to the value defined in the abs parameter. </p> 494<p>This will be written to the kernel.</p> 495<dl class="params"><dt>Parameters</dt><dd> 496 <table class="params"> 497 <tr><td class="paramname">dev</td><td>The evdev device, already initialized with <a class="el" href="group__init.html#ga6658ac490d68c307ff8b8d1536c12b44" title="Set the fd for this struct and initialize internal data.">libevdev_set_fd()</a> </td></tr> 498 <tr><td class="paramname">code</td><td>The EV_ABS event code to modify, one of ABS_X, ABS_Y, etc. </td></tr> 499 <tr><td class="paramname">abs</td><td>Axis info to set the kernel axis to</td></tr> 500 </table> 501 </dd> 502</dl> 503<dl class="section return"><dt>Returns</dt><dd>0 on success, or a negative errno on failure</dd></dl> 504<dl class="section see"><dt>See also</dt><dd><a class="el" href="group__kernel.html#ga51cfda33fd526549046399aadd764fca" title="Forcibly enable an event code on this device, even if the underlying device does not support it.">libevdev_enable_event_code</a> </dd></dl> 505 506</div> 507</div> 508<a id="gaa7d13aeac3c40e16f296467780e67c01"></a> 509<h2 class="memtitle"><span class="permalink"><a href="#gaa7d13aeac3c40e16f296467780e67c01">◆ </a></span>libevdev_kernel_set_led_value()</h2> 510 511<div class="memitem"> 512<div class="memproto"> 513 <table class="memname"> 514 <tr> 515 <td class="memname">int libevdev_kernel_set_led_value </td> 516 <td>(</td> 517 <td class="paramtype">struct libevdev * </td> 518 <td class="paramname"><em>dev</em>, </td> 519 </tr> 520 <tr> 521 <td class="paramkey"></td> 522 <td></td> 523 <td class="paramtype">unsigned int </td> 524 <td class="paramname"><em>code</em>, </td> 525 </tr> 526 <tr> 527 <td class="paramkey"></td> 528 <td></td> 529 <td class="paramtype">enum <a class="el" href="group__kernel.html#ga8cddf7779debef0067665671e911ec41">libevdev_led_value</a> </td> 530 <td class="paramname"><em>value</em> </td> 531 </tr> 532 <tr> 533 <td></td> 534 <td>)</td> 535 <td></td><td></td> 536 </tr> 537 </table> 538</div><div class="memdoc"> 539 540<p>Turn an LED on or off. </p> 541<p>Convenience function, if you need to modify multiple LEDs simultaneously, use <a class="el" href="group__kernel.html#ga93a19fa6e5be57903aff7c4a60af2a00" title="Turn multiple LEDs on or off simultaneously.">libevdev_kernel_set_led_values()</a> instead.</p> 542<dl class="section note"><dt>Note</dt><dd>enabling an LED requires write permissions on the device's file descriptor.</dd></dl> 543<dl class="params"><dt>Parameters</dt><dd> 544 <table class="params"> 545 <tr><td class="paramname">dev</td><td>The evdev device, already initialized with <a class="el" href="group__init.html#ga6658ac490d68c307ff8b8d1536c12b44" title="Set the fd for this struct and initialize internal data.">libevdev_set_fd()</a> </td></tr> 546 <tr><td class="paramname">code</td><td>The EV_LED event code to modify, one of LED_NUML, LED_CAPSL, ... </td></tr> 547 <tr><td class="paramname">value</td><td>Specifies whether to turn the LED on or off </td></tr> 548 </table> 549 </dd> 550</dl> 551<dl class="section return"><dt>Returns</dt><dd>0 on success, or a negative errno on failure </dd></dl> 552 553</div> 554</div> 555<a id="ga93a19fa6e5be57903aff7c4a60af2a00"></a> 556<h2 class="memtitle"><span class="permalink"><a href="#ga93a19fa6e5be57903aff7c4a60af2a00">◆ </a></span>libevdev_kernel_set_led_values()</h2> 557 558<div class="memitem"> 559<div class="memproto"> 560 <table class="memname"> 561 <tr> 562 <td class="memname">int libevdev_kernel_set_led_values </td> 563 <td>(</td> 564 <td class="paramtype">struct libevdev * </td> 565 <td class="paramname"><em>dev</em>, </td> 566 </tr> 567 <tr> 568 <td class="paramkey"></td> 569 <td></td> 570 <td class="paramtype"> </td> 571 <td class="paramname"><em>...</em> </td> 572 </tr> 573 <tr> 574 <td></td> 575 <td>)</td> 576 <td></td><td></td> 577 </tr> 578 </table> 579</div><div class="memdoc"> 580 581<p>Turn multiple LEDs on or off simultaneously. </p> 582<p>This function expects a pair of LED codes and values to set them to, terminated by a -1. For example, to switch the NumLock LED on but the CapsLock LED off, use:</p> 583<div class="fragment"><div class="line"><a class="code" href="group__kernel.html#ga93a19fa6e5be57903aff7c4a60af2a00">libevdev_kernel_set_led_values</a>(dev, LED_NUML, <a class="code" href="group__kernel.html#gga8cddf7779debef0067665671e911ec41a69d5a4cdf2a9357915fff0251a61d2ab">LIBEVDEV_LED_ON</a>,</div> 584<div class="line"> LED_CAPSL, <a class="code" href="group__kernel.html#gga8cddf7779debef0067665671e911ec41a23e508440306c387ddf89acd2db9e065">LIBEVDEV_LED_OFF</a>,</div> 585<div class="line"> -1);</div> 586<div class="ttc" id="agroup__kernel_html_ga93a19fa6e5be57903aff7c4a60af2a00"><div class="ttname"><a href="group__kernel.html#ga93a19fa6e5be57903aff7c4a60af2a00">libevdev_kernel_set_led_values</a></div><div class="ttdeci">int libevdev_kernel_set_led_values(struct libevdev *dev,...)</div><div class="ttdoc">Turn multiple LEDs on or off simultaneously.</div></div> 587<div class="ttc" id="agroup__kernel_html_gga8cddf7779debef0067665671e911ec41a23e508440306c387ddf89acd2db9e065"><div class="ttname"><a href="group__kernel.html#gga8cddf7779debef0067665671e911ec41a23e508440306c387ddf89acd2db9e065">LIBEVDEV_LED_OFF</a></div><div class="ttdeci">@ LIBEVDEV_LED_OFF</div><div class="ttdoc">Turn the LED off.</div><div class="ttdef"><b>Definition:</b> libevdev.h:1921</div></div> 588<div class="ttc" id="agroup__kernel_html_gga8cddf7779debef0067665671e911ec41a69d5a4cdf2a9357915fff0251a61d2ab"><div class="ttname"><a href="group__kernel.html#gga8cddf7779debef0067665671e911ec41a69d5a4cdf2a9357915fff0251a61d2ab">LIBEVDEV_LED_ON</a></div><div class="ttdeci">@ LIBEVDEV_LED_ON</div><div class="ttdoc">Turn the LED on.</div><div class="ttdef"><b>Definition:</b> libevdev.h:1920</div></div> 589</div><!-- fragment --><p>If any LED code or value is invalid, this function returns -EINVAL and no LEDs are modified.</p> 590<dl class="section note"><dt>Note</dt><dd>enabling an LED requires write permissions on the device's file descriptor.</dd></dl> 591<dl class="params"><dt>Parameters</dt><dd> 592 <table class="params"> 593 <tr><td class="paramname">dev</td><td>The evdev device, already initialized with <a class="el" href="group__init.html#ga6658ac490d68c307ff8b8d1536c12b44" title="Set the fd for this struct and initialize internal data.">libevdev_set_fd()</a> </td></tr> 594 <tr><td class="paramname">...</td><td>A pair of LED_* event codes and libevdev_led_value_t, followed by -1 to terminate the list. </td></tr> 595 </table> 596 </dd> 597</dl> 598<dl class="section return"><dt>Returns</dt><dd>0 on success, or a negative errno on failure </dd></dl> 599 600</div> 601</div> 602<a id="gabd309f30744a49e9391250b00ba2d67a"></a> 603<h2 class="memtitle"><span class="permalink"><a href="#gabd309f30744a49e9391250b00ba2d67a">◆ </a></span>libevdev_set_abs_flat()</h2> 604 605<div class="memitem"> 606<div class="memproto"> 607 <table class="memname"> 608 <tr> 609 <td class="memname">void libevdev_set_abs_flat </td> 610 <td>(</td> 611 <td class="paramtype">struct libevdev * </td> 612 <td class="paramname"><em>dev</em>, </td> 613 </tr> 614 <tr> 615 <td class="paramkey"></td> 616 <td></td> 617 <td class="paramtype">unsigned int </td> 618 <td class="paramname"><em>code</em>, </td> 619 </tr> 620 <tr> 621 <td class="paramkey"></td> 622 <td></td> 623 <td class="paramtype">int </td> 624 <td class="paramname"><em>val</em> </td> 625 </tr> 626 <tr> 627 <td></td> 628 <td>)</td> 629 <td></td><td></td> 630 </tr> 631 </table> 632</div><div class="memdoc"> 633 634<p>Change the flat for the given EV_ABS event code, if the code exists. </p> 635<p>This function has no effect if <a class="el" href="group__bits.html#gab2ab9dad417f33daa79fa0c3d682df0b">libevdev_has_event_code()</a> returns false for this code.</p> 636<dl class="params"><dt>Parameters</dt><dd> 637 <table class="params"> 638 <tr><td class="paramname">dev</td><td>The evdev device, already initialized with <a class="el" href="group__init.html#ga6658ac490d68c307ff8b8d1536c12b44" title="Set the fd for this struct and initialize internal data.">libevdev_set_fd()</a> </td></tr> 639 <tr><td class="paramname">code</td><td>One of ABS_X, ABS_Y, ... </td></tr> 640 <tr><td class="paramname">val</td><td>The new flat for this axis </td></tr> 641 </table> 642 </dd> 643</dl> 644 645</div> 646</div> 647<a id="gaa192bf0c68620be819337da6ec361c21"></a> 648<h2 class="memtitle"><span class="permalink"><a href="#gaa192bf0c68620be819337da6ec361c21">◆ </a></span>libevdev_set_abs_fuzz()</h2> 649 650<div class="memitem"> 651<div class="memproto"> 652 <table class="memname"> 653 <tr> 654 <td class="memname">void libevdev_set_abs_fuzz </td> 655 <td>(</td> 656 <td class="paramtype">struct libevdev * </td> 657 <td class="paramname"><em>dev</em>, </td> 658 </tr> 659 <tr> 660 <td class="paramkey"></td> 661 <td></td> 662 <td class="paramtype">unsigned int </td> 663 <td class="paramname"><em>code</em>, </td> 664 </tr> 665 <tr> 666 <td class="paramkey"></td> 667 <td></td> 668 <td class="paramtype">int </td> 669 <td class="paramname"><em>val</em> </td> 670 </tr> 671 <tr> 672 <td></td> 673 <td>)</td> 674 <td></td><td></td> 675 </tr> 676 </table> 677</div><div class="memdoc"> 678 679<p>Change the fuzz for the given EV_ABS event code, if the code exists. </p> 680<p>This function has no effect if <a class="el" href="group__bits.html#gab2ab9dad417f33daa79fa0c3d682df0b">libevdev_has_event_code()</a> returns false for this code.</p> 681<dl class="params"><dt>Parameters</dt><dd> 682 <table class="params"> 683 <tr><td class="paramname">dev</td><td>The evdev device, already initialized with <a class="el" href="group__init.html#ga6658ac490d68c307ff8b8d1536c12b44" title="Set the fd for this struct and initialize internal data.">libevdev_set_fd()</a> </td></tr> 684 <tr><td class="paramname">code</td><td>One of ABS_X, ABS_Y, ... </td></tr> 685 <tr><td class="paramname">val</td><td>The new fuzz for this axis </td></tr> 686 </table> 687 </dd> 688</dl> 689 690</div> 691</div> 692<a id="gafc7a4f5308e2dbf55f875630b8dca049"></a> 693<h2 class="memtitle"><span class="permalink"><a href="#gafc7a4f5308e2dbf55f875630b8dca049">◆ </a></span>libevdev_set_abs_info()</h2> 694 695<div class="memitem"> 696<div class="memproto"> 697 <table class="memname"> 698 <tr> 699 <td class="memname">void libevdev_set_abs_info </td> 700 <td>(</td> 701 <td class="paramtype">struct libevdev * </td> 702 <td class="paramname"><em>dev</em>, </td> 703 </tr> 704 <tr> 705 <td class="paramkey"></td> 706 <td></td> 707 <td class="paramtype">unsigned int </td> 708 <td class="paramname"><em>code</em>, </td> 709 </tr> 710 <tr> 711 <td class="paramkey"></td> 712 <td></td> 713 <td class="paramtype">const struct input_absinfo * </td> 714 <td class="paramname"><em>abs</em> </td> 715 </tr> 716 <tr> 717 <td></td> 718 <td>)</td> 719 <td></td><td></td> 720 </tr> 721 </table> 722</div><div class="memdoc"> 723 724<p>Change the abs info for the given EV_ABS event code, if the code exists. </p> 725<p>This function has no effect if <a class="el" href="group__bits.html#gab2ab9dad417f33daa79fa0c3d682df0b">libevdev_has_event_code()</a> returns false for this code.</p> 726<dl class="params"><dt>Parameters</dt><dd> 727 <table class="params"> 728 <tr><td class="paramname">dev</td><td>The evdev device, already initialized with <a class="el" href="group__init.html#ga6658ac490d68c307ff8b8d1536c12b44" title="Set the fd for this struct and initialize internal data.">libevdev_set_fd()</a> </td></tr> 729 <tr><td class="paramname">code</td><td>One of ABS_X, ABS_Y, ... </td></tr> 730 <tr><td class="paramname">abs</td><td>The new absolute axis data (min, max, fuzz, flat, resolution) </td></tr> 731 </table> 732 </dd> 733</dl> 734 735</div> 736</div> 737<a id="ga2302fd9a491d8e27280157d67a703af6"></a> 738<h2 class="memtitle"><span class="permalink"><a href="#ga2302fd9a491d8e27280157d67a703af6">◆ </a></span>libevdev_set_abs_maximum()</h2> 739 740<div class="memitem"> 741<div class="memproto"> 742 <table class="memname"> 743 <tr> 744 <td class="memname">void libevdev_set_abs_maximum </td> 745 <td>(</td> 746 <td class="paramtype">struct libevdev * </td> 747 <td class="paramname"><em>dev</em>, </td> 748 </tr> 749 <tr> 750 <td class="paramkey"></td> 751 <td></td> 752 <td class="paramtype">unsigned int </td> 753 <td class="paramname"><em>code</em>, </td> 754 </tr> 755 <tr> 756 <td class="paramkey"></td> 757 <td></td> 758 <td class="paramtype">int </td> 759 <td class="paramname"><em>val</em> </td> 760 </tr> 761 <tr> 762 <td></td> 763 <td>)</td> 764 <td></td><td></td> 765 </tr> 766 </table> 767</div><div class="memdoc"> 768 769<p>Change the maximum for the given EV_ABS event code, if the code exists. </p> 770<p>This function has no effect if <a class="el" href="group__bits.html#gab2ab9dad417f33daa79fa0c3d682df0b">libevdev_has_event_code()</a> returns false for this code.</p> 771<dl class="params"><dt>Parameters</dt><dd> 772 <table class="params"> 773 <tr><td class="paramname">dev</td><td>The evdev device, already initialized with <a class="el" href="group__init.html#ga6658ac490d68c307ff8b8d1536c12b44" title="Set the fd for this struct and initialize internal data.">libevdev_set_fd()</a> </td></tr> 774 <tr><td class="paramname">code</td><td>One of ABS_X, ABS_Y, ... </td></tr> 775 <tr><td class="paramname">val</td><td>The new maxium for this axis </td></tr> 776 </table> 777 </dd> 778</dl> 779 780</div> 781</div> 782<a id="gaca62172c2a823cd02eacf0d2292d917a"></a> 783<h2 class="memtitle"><span class="permalink"><a href="#gaca62172c2a823cd02eacf0d2292d917a">◆ </a></span>libevdev_set_abs_minimum()</h2> 784 785<div class="memitem"> 786<div class="memproto"> 787 <table class="memname"> 788 <tr> 789 <td class="memname">void libevdev_set_abs_minimum </td> 790 <td>(</td> 791 <td class="paramtype">struct libevdev * </td> 792 <td class="paramname"><em>dev</em>, </td> 793 </tr> 794 <tr> 795 <td class="paramkey"></td> 796 <td></td> 797 <td class="paramtype">unsigned int </td> 798 <td class="paramname"><em>code</em>, </td> 799 </tr> 800 <tr> 801 <td class="paramkey"></td> 802 <td></td> 803 <td class="paramtype">int </td> 804 <td class="paramname"><em>val</em> </td> 805 </tr> 806 <tr> 807 <td></td> 808 <td>)</td> 809 <td></td><td></td> 810 </tr> 811 </table> 812</div><div class="memdoc"> 813 814<p>Change the minimum for the given EV_ABS event code, if the code exists. </p> 815<p>This function has no effect if <a class="el" href="group__bits.html#gab2ab9dad417f33daa79fa0c3d682df0b">libevdev_has_event_code()</a> returns false for this code.</p> 816<dl class="params"><dt>Parameters</dt><dd> 817 <table class="params"> 818 <tr><td class="paramname">dev</td><td>The evdev device, already initialized with <a class="el" href="group__init.html#ga6658ac490d68c307ff8b8d1536c12b44" title="Set the fd for this struct and initialize internal data.">libevdev_set_fd()</a> </td></tr> 819 <tr><td class="paramname">code</td><td>One of ABS_X, ABS_Y, ... </td></tr> 820 <tr><td class="paramname">val</td><td>The new minimum for this axis </td></tr> 821 </table> 822 </dd> 823</dl> 824 825</div> 826</div> 827<a id="ga2266b59711cdaa4fc12fa56c9313a038"></a> 828<h2 class="memtitle"><span class="permalink"><a href="#ga2266b59711cdaa4fc12fa56c9313a038">◆ </a></span>libevdev_set_abs_resolution()</h2> 829 830<div class="memitem"> 831<div class="memproto"> 832 <table class="memname"> 833 <tr> 834 <td class="memname">void libevdev_set_abs_resolution </td> 835 <td>(</td> 836 <td class="paramtype">struct libevdev * </td> 837 <td class="paramname"><em>dev</em>, </td> 838 </tr> 839 <tr> 840 <td class="paramkey"></td> 841 <td></td> 842 <td class="paramtype">unsigned int </td> 843 <td class="paramname"><em>code</em>, </td> 844 </tr> 845 <tr> 846 <td class="paramkey"></td> 847 <td></td> 848 <td class="paramtype">int </td> 849 <td class="paramname"><em>val</em> </td> 850 </tr> 851 <tr> 852 <td></td> 853 <td>)</td> 854 <td></td><td></td> 855 </tr> 856 </table> 857</div><div class="memdoc"> 858 859<p>Change the resolution for the given EV_ABS event code, if the code exists. </p> 860<p>This function has no effect if <a class="el" href="group__bits.html#gab2ab9dad417f33daa79fa0c3d682df0b">libevdev_has_event_code()</a> returns false for this code.</p> 861<dl class="params"><dt>Parameters</dt><dd> 862 <table class="params"> 863 <tr><td class="paramname">dev</td><td>The evdev device, already initialized with <a class="el" href="group__init.html#ga6658ac490d68c307ff8b8d1536c12b44" title="Set the fd for this struct and initialize internal data.">libevdev_set_fd()</a> </td></tr> 864 <tr><td class="paramname">code</td><td>One of ABS_X, ABS_Y, ... </td></tr> 865 <tr><td class="paramname">val</td><td>The new axis resolution </td></tr> 866 </table> 867 </dd> 868</dl> 869 870</div> 871</div> 872<a id="ga2925b6fbf8c7991ff2164424b840b82d"></a> 873<h2 class="memtitle"><span class="permalink"><a href="#ga2925b6fbf8c7991ff2164424b840b82d">◆ </a></span>libevdev_set_clock_id()</h2> 874 875<div class="memitem"> 876<div class="memproto"> 877 <table class="memname"> 878 <tr> 879 <td class="memname">int libevdev_set_clock_id </td> 880 <td>(</td> 881 <td class="paramtype">struct libevdev * </td> 882 <td class="paramname"><em>dev</em>, </td> 883 </tr> 884 <tr> 885 <td class="paramkey"></td> 886 <td></td> 887 <td class="paramtype">int </td> 888 <td class="paramname"><em>clockid</em> </td> 889 </tr> 890 <tr> 891 <td></td> 892 <td>)</td> 893 <td></td><td></td> 894 </tr> 895 </table> 896</div><div class="memdoc"> 897 898<p>Set the clock ID to be used for timestamps. </p> 899<p>Further events from this device will report an event time based on the given clock.</p> 900<p>This is a modification only affecting this representation of this device.</p> 901<dl class="params"><dt>Parameters</dt><dd> 902 <table class="params"> 903 <tr><td class="paramname">dev</td><td>The evdev device, already initialized with <a class="el" href="group__init.html#ga6658ac490d68c307ff8b8d1536c12b44" title="Set the fd for this struct and initialize internal data.">libevdev_set_fd()</a> </td></tr> 904 <tr><td class="paramname">clockid</td><td>The clock to use for future events. Permitted values are CLOCK_MONOTONIC and CLOCK_REALTIME (the default). </td></tr> 905 </table> 906 </dd> 907</dl> 908<dl class="section return"><dt>Returns</dt><dd>0 on success, or a negative errno on failure </dd></dl> 909 910</div> 911</div> 912<a id="ga79e82ee2a95cb08adb4172aabe0c7184"></a> 913<h2 class="memtitle"><span class="permalink"><a href="#ga79e82ee2a95cb08adb4172aabe0c7184">◆ </a></span>libevdev_set_event_value()</h2> 914 915<div class="memitem"> 916<div class="memproto"> 917 <table class="memname"> 918 <tr> 919 <td class="memname">int libevdev_set_event_value </td> 920 <td>(</td> 921 <td class="paramtype">struct libevdev * </td> 922 <td class="paramname"><em>dev</em>, </td> 923 </tr> 924 <tr> 925 <td class="paramkey"></td> 926 <td></td> 927 <td class="paramtype">unsigned int </td> 928 <td class="paramname"><em>type</em>, </td> 929 </tr> 930 <tr> 931 <td class="paramkey"></td> 932 <td></td> 933 <td class="paramtype">unsigned int </td> 934 <td class="paramname"><em>code</em>, </td> 935 </tr> 936 <tr> 937 <td class="paramkey"></td> 938 <td></td> 939 <td class="paramtype">int </td> 940 <td class="paramname"><em>value</em> </td> 941 </tr> 942 <tr> 943 <td></td> 944 <td>)</td> 945 <td></td><td></td> 946 </tr> 947 </table> 948</div><div class="memdoc"> 949 950<p>Set the value for a given event type and code. </p> 951<p>This only makes sense for some event types, e.g. setting the value for EV_REL is pointless.</p> 952<p>This is a local modification only affecting only this representation of this device. A future call to <a class="el" href="group__bits.html#ga6259f4c6bdba950329ff9cd48c2ef8a3" title="Behaviour of this function is undefined if the device does not provide the event.">libevdev_get_event_value()</a> will return this value, unless the value was overwritten by an event.</p> 953<p>If the device supports ABS_MT_SLOT, the value set for any ABS_MT_* event code is the value of the currently active slot. You should use <a class="el" href="group__kernel.html#ga0c61f4919b03b0850529a50c37a20333" title="Set the value for a given code for the given slot.">libevdev_set_slot_value()</a> instead.</p> 954<p>If the device supports ABS_MT_SLOT and the type is EV_ABS and the code is ABS_MT_SLOT, the value must be a positive number less then the number of slots on the device. Otherwise, <a class="el" href="group__kernel.html#ga79e82ee2a95cb08adb4172aabe0c7184" title="Set the value for a given event type and code.">libevdev_set_event_value()</a> returns -1.</p> 955<dl class="params"><dt>Parameters</dt><dd> 956 <table class="params"> 957 <tr><td class="paramname">dev</td><td>The evdev device, already initialized with <a class="el" href="group__init.html#ga6658ac490d68c307ff8b8d1536c12b44" title="Set the fd for this struct and initialize internal data.">libevdev_set_fd()</a> </td></tr> 958 <tr><td class="paramname">type</td><td>The event type for the code to query (EV_SYN, EV_REL, etc.) </td></tr> 959 <tr><td class="paramname">code</td><td>The event code to set the value for, one of ABS_X, LED_NUML, etc. </td></tr> 960 <tr><td class="paramname">value</td><td>The new value to set</td></tr> 961 </table> 962 </dd> 963</dl> 964<dl class="section return"><dt>Returns</dt><dd>0 on success, or -1 on failure. </dd></dl> 965<dl class="retval"><dt>Return values</dt><dd> 966 <table class="retval"> 967 <tr><td class="paramname">-1</td><td><ul> 968<li>the device does not have the event type or</li> 969<li>code enabled, or the code is outside the, or</li> 970<li>the code is outside the allowed limits for the given type, or</li> 971<li>the type cannot be set, or</li> 972<li>the value is not permitted for the given code.</li> 973</ul> 974</td></tr> 975 </table> 976 </dd> 977</dl> 978<dl class="section see"><dt>See also</dt><dd><a class="el" href="group__kernel.html#ga0c61f4919b03b0850529a50c37a20333" title="Set the value for a given code for the given slot.">libevdev_set_slot_value</a> </dd> 979<dd> 980<a class="el" href="group__bits.html#ga6259f4c6bdba950329ff9cd48c2ef8a3" title="Behaviour of this function is undefined if the device does not provide the event.">libevdev_get_event_value</a> </dd></dl> 981 982</div> 983</div> 984<a id="gaf99139c728ba1bd4b37ede612780b6b0"></a> 985<h2 class="memtitle"><span class="permalink"><a href="#gaf99139c728ba1bd4b37ede612780b6b0">◆ </a></span>libevdev_set_id_bustype()</h2> 986 987<div class="memitem"> 988<div class="memproto"> 989 <table class="memname"> 990 <tr> 991 <td class="memname">void libevdev_set_id_bustype </td> 992 <td>(</td> 993 <td class="paramtype">struct libevdev * </td> 994 <td class="paramname"><em>dev</em>, </td> 995 </tr> 996 <tr> 997 <td class="paramkey"></td> 998 <td></td> 999 <td class="paramtype">int </td> 1000 <td class="paramname"><em>bustype</em> </td> 1001 </tr> 1002 <tr> 1003 <td></td> 1004 <td>)</td> 1005 <td></td><td></td> 1006 </tr> 1007 </table> 1008</div><div class="memdoc"> 1009<dl class="params"><dt>Parameters</dt><dd> 1010 <table class="params"> 1011 <tr><td class="paramname">dev</td><td>The evdev device </td></tr> 1012 <tr><td class="paramname">bustype</td><td>The bustype to assign to this device</td></tr> 1013 </table> 1014 </dd> 1015</dl> 1016<dl class="section note"><dt>Note</dt><dd>This function may be called before <a class="el" href="group__init.html#ga6658ac490d68c307ff8b8d1536c12b44" title="Set the fd for this struct and initialize internal data.">libevdev_set_fd()</a>. A call to <a class="el" href="group__init.html#ga6658ac490d68c307ff8b8d1536c12b44" title="Set the fd for this struct and initialize internal data.">libevdev_set_fd()</a> will overwrite any previously set value. Even though the function accepts an int for bustype the value is truncated at 16 bits. </dd></dl> 1017 1018</div> 1019</div> 1020<a id="ga62fbdaac056ab5c3db154a9eeaf33799"></a> 1021<h2 class="memtitle"><span class="permalink"><a href="#ga62fbdaac056ab5c3db154a9eeaf33799">◆ </a></span>libevdev_set_id_product()</h2> 1022 1023<div class="memitem"> 1024<div class="memproto"> 1025 <table class="memname"> 1026 <tr> 1027 <td class="memname">void libevdev_set_id_product </td> 1028 <td>(</td> 1029 <td class="paramtype">struct libevdev * </td> 1030 <td class="paramname"><em>dev</em>, </td> 1031 </tr> 1032 <tr> 1033 <td class="paramkey"></td> 1034 <td></td> 1035 <td class="paramtype">int </td> 1036 <td class="paramname"><em>product_id</em> </td> 1037 </tr> 1038 <tr> 1039 <td></td> 1040 <td>)</td> 1041 <td></td><td></td> 1042 </tr> 1043 </table> 1044</div><div class="memdoc"> 1045<dl class="params"><dt>Parameters</dt><dd> 1046 <table class="params"> 1047 <tr><td class="paramname">dev</td><td>The evdev device </td></tr> 1048 <tr><td class="paramname">product_id</td><td>The product ID to assign to this device</td></tr> 1049 </table> 1050 </dd> 1051</dl> 1052<dl class="section note"><dt>Note</dt><dd>This function may be called before <a class="el" href="group__init.html#ga6658ac490d68c307ff8b8d1536c12b44" title="Set the fd for this struct and initialize internal data.">libevdev_set_fd()</a>. A call to <a class="el" href="group__init.html#ga6658ac490d68c307ff8b8d1536c12b44" title="Set the fd for this struct and initialize internal data.">libevdev_set_fd()</a> will overwrite any previously set value. Even though the function accepts an int for product_id the value is truncated at 16 bits. </dd></dl> 1053 1054</div> 1055</div> 1056<a id="ga8ce28051ebbb73de1d04d782f4d0d6fe"></a> 1057<h2 class="memtitle"><span class="permalink"><a href="#ga8ce28051ebbb73de1d04d782f4d0d6fe">◆ </a></span>libevdev_set_id_vendor()</h2> 1058 1059<div class="memitem"> 1060<div class="memproto"> 1061 <table class="memname"> 1062 <tr> 1063 <td class="memname">void libevdev_set_id_vendor </td> 1064 <td>(</td> 1065 <td class="paramtype">struct libevdev * </td> 1066 <td class="paramname"><em>dev</em>, </td> 1067 </tr> 1068 <tr> 1069 <td class="paramkey"></td> 1070 <td></td> 1071 <td class="paramtype">int </td> 1072 <td class="paramname"><em>vendor_id</em> </td> 1073 </tr> 1074 <tr> 1075 <td></td> 1076 <td>)</td> 1077 <td></td><td></td> 1078 </tr> 1079 </table> 1080</div><div class="memdoc"> 1081<dl class="params"><dt>Parameters</dt><dd> 1082 <table class="params"> 1083 <tr><td class="paramname">dev</td><td>The evdev device </td></tr> 1084 <tr><td class="paramname">vendor_id</td><td>The vendor ID to assign to this device</td></tr> 1085 </table> 1086 </dd> 1087</dl> 1088<dl class="section note"><dt>Note</dt><dd>This function may be called before <a class="el" href="group__init.html#ga6658ac490d68c307ff8b8d1536c12b44" title="Set the fd for this struct and initialize internal data.">libevdev_set_fd()</a>. A call to <a class="el" href="group__init.html#ga6658ac490d68c307ff8b8d1536c12b44" title="Set the fd for this struct and initialize internal data.">libevdev_set_fd()</a> will overwrite any previously set value. Even though the function accepts an int for vendor_id the value is truncated at 16 bits. </dd></dl> 1089 1090</div> 1091</div> 1092<a id="gaee1d2db88b191ec21d5bf22dd4fe3055"></a> 1093<h2 class="memtitle"><span class="permalink"><a href="#gaee1d2db88b191ec21d5bf22dd4fe3055">◆ </a></span>libevdev_set_id_version()</h2> 1094 1095<div class="memitem"> 1096<div class="memproto"> 1097 <table class="memname"> 1098 <tr> 1099 <td class="memname">void libevdev_set_id_version </td> 1100 <td>(</td> 1101 <td class="paramtype">struct libevdev * </td> 1102 <td class="paramname"><em>dev</em>, </td> 1103 </tr> 1104 <tr> 1105 <td class="paramkey"></td> 1106 <td></td> 1107 <td class="paramtype">int </td> 1108 <td class="paramname"><em>version</em> </td> 1109 </tr> 1110 <tr> 1111 <td></td> 1112 <td>)</td> 1113 <td></td><td></td> 1114 </tr> 1115 </table> 1116</div><div class="memdoc"> 1117<dl class="params"><dt>Parameters</dt><dd> 1118 <table class="params"> 1119 <tr><td class="paramname">dev</td><td>The evdev device </td></tr> 1120 <tr><td class="paramname">version</td><td>The version to assign to this device</td></tr> 1121 </table> 1122 </dd> 1123</dl> 1124<dl class="section note"><dt>Note</dt><dd>This function may be called before <a class="el" href="group__init.html#ga6658ac490d68c307ff8b8d1536c12b44" title="Set the fd for this struct and initialize internal data.">libevdev_set_fd()</a>. A call to <a class="el" href="group__init.html#ga6658ac490d68c307ff8b8d1536c12b44" title="Set the fd for this struct and initialize internal data.">libevdev_set_fd()</a> will overwrite any previously set value. Even though the function accepts an int for version the value is truncated at 16 bits. </dd></dl> 1125 1126</div> 1127</div> 1128<a id="gae5dcdb7678cdc9be4ab1989725b4ed32"></a> 1129<h2 class="memtitle"><span class="permalink"><a href="#gae5dcdb7678cdc9be4ab1989725b4ed32">◆ </a></span>libevdev_set_name()</h2> 1130 1131<div class="memitem"> 1132<div class="memproto"> 1133 <table class="memname"> 1134 <tr> 1135 <td class="memname">void libevdev_set_name </td> 1136 <td>(</td> 1137 <td class="paramtype">struct libevdev * </td> 1138 <td class="paramname"><em>dev</em>, </td> 1139 </tr> 1140 <tr> 1141 <td class="paramkey"></td> 1142 <td></td> 1143 <td class="paramtype">const char * </td> 1144 <td class="paramname"><em>name</em> </td> 1145 </tr> 1146 <tr> 1147 <td></td> 1148 <td>)</td> 1149 <td></td><td></td> 1150 </tr> 1151 </table> 1152</div><div class="memdoc"> 1153 1154<p>Change the device's name as returned by <a class="el" href="group__bits.html#gaed0328c67b7a78422636d9fe09a73f12" title="Retrieve the device's name, either as set by the caller or as read from the kernel.">libevdev_get_name()</a>. </p> 1155<p>This function destroys the string previously returned by <a class="el" href="group__bits.html#gaed0328c67b7a78422636d9fe09a73f12" title="Retrieve the device's name, either as set by the caller or as read from the kernel.">libevdev_get_name()</a>, a caller must take care that no references are kept.</p> 1156<dl class="params"><dt>Parameters</dt><dd> 1157 <table class="params"> 1158 <tr><td class="paramname">dev</td><td>The evdev device </td></tr> 1159 <tr><td class="paramname">name</td><td>The new, non-NULL, name to assign to this device.</td></tr> 1160 </table> 1161 </dd> 1162</dl> 1163<dl class="section note"><dt>Note</dt><dd>This function may be called before <a class="el" href="group__init.html#ga6658ac490d68c307ff8b8d1536c12b44" title="Set the fd for this struct and initialize internal data.">libevdev_set_fd()</a>. A call to <a class="el" href="group__init.html#ga6658ac490d68c307ff8b8d1536c12b44" title="Set the fd for this struct and initialize internal data.">libevdev_set_fd()</a> will overwrite any previously set value. </dd></dl> 1164 1165</div> 1166</div> 1167<a id="gacd57c8d6ace8e0b1417809a9c1c67af3"></a> 1168<h2 class="memtitle"><span class="permalink"><a href="#gacd57c8d6ace8e0b1417809a9c1c67af3">◆ </a></span>libevdev_set_phys()</h2> 1169 1170<div class="memitem"> 1171<div class="memproto"> 1172 <table class="memname"> 1173 <tr> 1174 <td class="memname">void libevdev_set_phys </td> 1175 <td>(</td> 1176 <td class="paramtype">struct libevdev * </td> 1177 <td class="paramname"><em>dev</em>, </td> 1178 </tr> 1179 <tr> 1180 <td class="paramkey"></td> 1181 <td></td> 1182 <td class="paramtype">const char * </td> 1183 <td class="paramname"><em>phys</em> </td> 1184 </tr> 1185 <tr> 1186 <td></td> 1187 <td>)</td> 1188 <td></td><td></td> 1189 </tr> 1190 </table> 1191</div><div class="memdoc"> 1192 1193<p>Change the device's physical location as returned by <a class="el" href="group__bits.html#ga5df483b0b24d7b96ea1181808fab851d" title="Retrieve the device's physical location, either as set by the caller or as read from the kernel.">libevdev_get_phys()</a>. </p> 1194<p>This function destroys the string previously returned by <a class="el" href="group__bits.html#ga5df483b0b24d7b96ea1181808fab851d" title="Retrieve the device's physical location, either as set by the caller or as read from the kernel.">libevdev_get_phys()</a>, a caller must take care that no references are kept.</p> 1195<dl class="params"><dt>Parameters</dt><dd> 1196 <table class="params"> 1197 <tr><td class="paramname">dev</td><td>The evdev device </td></tr> 1198 <tr><td class="paramname">phys</td><td>The new phys to assign to this device.</td></tr> 1199 </table> 1200 </dd> 1201</dl> 1202<dl class="section note"><dt>Note</dt><dd>This function may be called before <a class="el" href="group__init.html#ga6658ac490d68c307ff8b8d1536c12b44" title="Set the fd for this struct and initialize internal data.">libevdev_set_fd()</a>. A call to <a class="el" href="group__init.html#ga6658ac490d68c307ff8b8d1536c12b44" title="Set the fd for this struct and initialize internal data.">libevdev_set_fd()</a> will overwrite any previously set value. </dd></dl> 1203 1204</div> 1205</div> 1206<a id="ga0c61f4919b03b0850529a50c37a20333"></a> 1207<h2 class="memtitle"><span class="permalink"><a href="#ga0c61f4919b03b0850529a50c37a20333">◆ </a></span>libevdev_set_slot_value()</h2> 1208 1209<div class="memitem"> 1210<div class="memproto"> 1211 <table class="memname"> 1212 <tr> 1213 <td class="memname">int libevdev_set_slot_value </td> 1214 <td>(</td> 1215 <td class="paramtype">struct libevdev * </td> 1216 <td class="paramname"><em>dev</em>, </td> 1217 </tr> 1218 <tr> 1219 <td class="paramkey"></td> 1220 <td></td> 1221 <td class="paramtype">unsigned int </td> 1222 <td class="paramname"><em>slot</em>, </td> 1223 </tr> 1224 <tr> 1225 <td class="paramkey"></td> 1226 <td></td> 1227 <td class="paramtype">unsigned int </td> 1228 <td class="paramname"><em>code</em>, </td> 1229 </tr> 1230 <tr> 1231 <td class="paramkey"></td> 1232 <td></td> 1233 <td class="paramtype">int </td> 1234 <td class="paramname"><em>value</em> </td> 1235 </tr> 1236 <tr> 1237 <td></td> 1238 <td>)</td> 1239 <td></td><td></td> 1240 </tr> 1241 </table> 1242</div><div class="memdoc"> 1243 1244<p>Set the value for a given code for the given slot. </p> 1245<p>This is a local modification only affecting only this representation of this device. A future call to <a class="el" href="group__mt.html#ga8c6303391cb4f90b2d46763cf4eb8bc8" title="Return the current value of the code for the given slot.">libevdev_get_slot_value()</a> will return this value, unless the value was overwritten by an event.</p> 1246<p>This function does not set event values for axes outside the ABS_MT range, use <a class="el" href="group__kernel.html#ga79e82ee2a95cb08adb4172aabe0c7184" title="Set the value for a given event type and code.">libevdev_set_event_value()</a> instead.</p> 1247<dl class="params"><dt>Parameters</dt><dd> 1248 <table class="params"> 1249 <tr><td class="paramname">dev</td><td>The evdev device, already initialized with <a class="el" href="group__init.html#ga6658ac490d68c307ff8b8d1536c12b44" title="Set the fd for this struct and initialize internal data.">libevdev_set_fd()</a> </td></tr> 1250 <tr><td class="paramname">slot</td><td>The numerical slot number, must be smaller than the total number of slots on this device </td></tr> 1251 <tr><td class="paramname">code</td><td>The event code to set the value for, one of ABS_MT_POSITION_X, etc. </td></tr> 1252 <tr><td class="paramname">value</td><td>The new value to set</td></tr> 1253 </table> 1254 </dd> 1255</dl> 1256<dl class="section return"><dt>Returns</dt><dd>0 on success, or -1 on failure. </dd></dl> 1257<dl class="retval"><dt>Return values</dt><dd> 1258 <table class="retval"> 1259 <tr><td class="paramname">-1</td><td><ul> 1260<li>the device does not have the event code enabled, or</li> 1261<li>the code is outside the allowed limits for multitouch events, or</li> 1262<li>the slot number is outside the limits for this device, or</li> 1263<li>the device does not support multitouch events.</li> 1264</ul> 1265</td></tr> 1266 </table> 1267 </dd> 1268</dl> 1269<dl class="section see"><dt>See also</dt><dd><a class="el" href="group__kernel.html#ga79e82ee2a95cb08adb4172aabe0c7184" title="Set the value for a given event type and code.">libevdev_set_event_value</a> </dd> 1270<dd> 1271<a class="el" href="group__mt.html#ga8c6303391cb4f90b2d46763cf4eb8bc8" title="Return the current value of the code for the given slot.">libevdev_get_slot_value</a> </dd></dl> 1272 1273</div> 1274</div> 1275<a id="ga4e4fd2627744fd5811c50c7403f27ad7"></a> 1276<h2 class="memtitle"><span class="permalink"><a href="#ga4e4fd2627744fd5811c50c7403f27ad7">◆ </a></span>libevdev_set_uniq()</h2> 1277 1278<div class="memitem"> 1279<div class="memproto"> 1280 <table class="memname"> 1281 <tr> 1282 <td class="memname">void libevdev_set_uniq </td> 1283 <td>(</td> 1284 <td class="paramtype">struct libevdev * </td> 1285 <td class="paramname"><em>dev</em>, </td> 1286 </tr> 1287 <tr> 1288 <td class="paramkey"></td> 1289 <td></td> 1290 <td class="paramtype">const char * </td> 1291 <td class="paramname"><em>uniq</em> </td> 1292 </tr> 1293 <tr> 1294 <td></td> 1295 <td>)</td> 1296 <td></td><td></td> 1297 </tr> 1298 </table> 1299</div><div class="memdoc"> 1300 1301<p>Change the device's unique identifier as returned by <a class="el" href="group__bits.html#ga6d9f7d44bff8828ead3d251177035ca4" title="Retrieve the device's unique identifier, either as set by the caller or as read from the kernel.">libevdev_get_uniq()</a>. </p> 1302<p>This function destroys the string previously returned by <a class="el" href="group__bits.html#ga6d9f7d44bff8828ead3d251177035ca4" title="Retrieve the device's unique identifier, either as set by the caller or as read from the kernel.">libevdev_get_uniq()</a>, a caller must take care that no references are kept.</p> 1303<dl class="params"><dt>Parameters</dt><dd> 1304 <table class="params"> 1305 <tr><td class="paramname">dev</td><td>The evdev device </td></tr> 1306 <tr><td class="paramname">uniq</td><td>The new uniq to assign to this device.</td></tr> 1307 </table> 1308 </dd> 1309</dl> 1310<dl class="section note"><dt>Note</dt><dd>This function may be called before <a class="el" href="group__init.html#ga6658ac490d68c307ff8b8d1536c12b44" title="Set the fd for this struct and initialize internal data.">libevdev_set_fd()</a>. A call to <a class="el" href="group__init.html#ga6658ac490d68c307ff8b8d1536c12b44" title="Set the fd for this struct and initialize internal data.">libevdev_set_fd()</a> will overwrite any previously set value. </dd></dl> 1311 1312</div> 1313</div> 1314</div><!-- contents --> 1315<!-- HTML footer for doxygen 1.8.8--> 1316<!-- start footer part --> 1317</div> 1318</div> 1319</div> 1320</div> 1321</div> 1322<hr class="footer"/><address class="footer"><small> 1323Generated by  <a href="http://www.doxygen.org/index.html"> 1324<img class="footer" src="doxygen.png" alt="doxygen"/> 1325</a> 1.9.1 1326</small></address> 1327</body> 1328</html> 1329
