First Production version

The user-level tool now includes benchmarking options: actions on a group can be specified inside "config.ini". This file can be also used for fuzzing purpose (e.g. AFL)
Updated udev rule and code to put group's device file inside the "synch" subdirectory.
Improved Doxygen documentation (inside docs/)

Author: gr3yc4t

.gitignore

@@ -123,3 +123,11 @@ dkms.conf
 .vscode/
 
 tool/tool
+
+tool/perf.data.old
+
+*.perf
+
+*.data
+
+warns.txt

Doxyfile

@@ -829,7 +829,7 @@ WARN_LOGFILE           =
 # spaces. See also FILE_PATTERNS and EXTENSION_MAPPING
 # Note: If this tag is empty the current directory is searched.
 
-INPUT                  = src/ 
+INPUT                  = main_docs.dox src/ tool/ 
 
 # This tag can be used to specify the character encoding of the source files
 # that doxygen parses. Internally doxygen uses the UTF-8 encoding. Doxygen uses

docs/html/annotated.html

@@ -68,17 +68,20 @@
 <div class="contents">
 <div class="textblock">Here are the data structures with brief descriptions:</div><div class="directory">
 <table class="directory">
-<tr id="row_0_" class="even"><td class="entry"><span style="width:16px;display:inline-block;">&#160;</span><span class="icona"><span class="icon">C</span></span><a class="el" href="d2/d86/structgroup__data.html" target="_self">group_data</a></td><td class="desc">Group device data structure </td></tr>
-<tr id="row_1_"><td class="entry"><span style="width:16px;display:inline-block;">&#160;</span><span class="icona"><span class="icon">C</span></span><a class="el" href="d3/df9/structgroup__flags__t.html" target="_self">group_flags_t</a></td><td class="desc">Contains the various flags that represent the status of the module </td></tr>
-<tr id="row_2_" class="even"><td class="entry"><span style="width:16px;display:inline-block;">&#160;</span><span class="icona"><span class="icon">C</span></span><a class="el" href="d2/dc2/structgroup__t.html" target="_self">group_t</a></td><td class="desc">System-wide descriptor of a group </td></tr>
-<tr id="row_3_"><td class="entry"><span style="width:16px;display:inline-block;">&#160;</span><span class="icona"><span class="icon">C</span></span><a class="el" href="d3/d75/structt__message__manager.html" target="_self">msg_manager_t</a></td><td class="desc">Manage the message sub-system </td></tr>
-<tr id="row_4_" class="even"><td class="entry"><span style="width:16px;display:inline-block;">&#160;</span><span class="icona"><span class="icon">C</span></span><a class="el" href="de/d78/structt__message.html" target="_self">msg_t</a></td><td class="desc">Basic structure to represent a message </td></tr>
-<tr id="row_5_"><td class="entry"><span style="width:16px;display:inline-block;">&#160;</span><span class="icona"><span class="icon">C</span></span><a class="el" href="d0/de0/structt__garbage__collector.html" target="_self">t_garbage_collector</a></td><td class="desc">Garbage Collector structure </td></tr>
-<tr id="row_6_" class="even"><td class="entry"><span style="width:16px;display:inline-block;">&#160;</span><span class="icona"><span class="icon">C</span></span><a class="el" href="d4/d00/structt__group__members.html" target="_self">t_group_members</a></td><td class="desc">Threads that are members of the group device </td></tr>
-<tr id="row_7_"><td class="entry"><span style="width:16px;display:inline-block;">&#160;</span><span class="icona"><span class="icon">C</span></span><a class="el" href="db/d84/structt__group__sysfs.html" target="_self">t_group_sysfs</a></td><td class="desc">Contains all the 'sysfs' attrubutes and the group's kobject </td></tr>
-<tr id="row_8_" class="even"><td class="entry"><span style="width:16px;display:inline-block;">&#160;</span><span class="icona"><span class="icon">C</span></span><a class="el" href="db/dc1/structt__main__sync.html" target="_self">t_main_sync</a></td><td class="desc">Main device structure </td></tr>
-<tr id="row_9_"><td class="entry"><span style="width:16px;display:inline-block;">&#160;</span><span class="icona"><span class="icon">C</span></span><a class="el" href="d6/d20/structt__message__delayed__deliver.html" target="_self">t_message_delayed_deliver</a></td><td class="desc">Contains a 'msg_t' structure and the timer needed to delay the delivery </td></tr>
-<tr id="row_10_" class="even"><td class="entry"><span style="width:16px;display:inline-block;">&#160;</span><span class="icona"><span class="icon">C</span></span><a class="el" href="df/d34/structt__message__deliver.html" target="_self">t_message_deliver</a></td><td class="desc">Contains a 'msg_t' structure and the relative delivery info </td></tr>
+<tr id="row_0_" class="even"><td class="entry"><span style="width:16px;display:inline-block;">&#160;</span><span class="icona"><span class="icon">C</span></span><a class="el" href="d8/d3f/structconfiguration.html" target="_self">configuration</a></td><td class="desc"></td></tr>
+<tr id="row_1_"><td class="entry"><span style="width:16px;display:inline-block;">&#160;</span><span class="icona"><span class="icon">C</span></span><a class="el" href="d2/d86/structgroup__data.html" target="_self">group_data</a></td><td class="desc">Group device data structure </td></tr>
+<tr id="row_2_" class="even"><td class="entry"><span style="width:16px;display:inline-block;">&#160;</span><span class="icona"><span class="icon">C</span></span><a class="el" href="d3/df9/structgroup__flags__t.html" target="_self">group_flags_t</a></td><td class="desc">Contains the various flags that represent the status of the module </td></tr>
+<tr id="row_3_"><td class="entry"><span style="width:16px;display:inline-block;">&#160;</span><span class="icona"><span class="icon">C</span></span><a class="el" href="d2/dc2/structgroup__t.html" target="_self">group_t</a></td><td class="desc">System-wide descriptor of a group </td></tr>
+<tr id="row_4_" class="even"><td class="entry"><span style="width:16px;display:inline-block;">&#160;</span><span class="icona"><span class="icon">C</span></span><a class="el" href="d3/d75/structt__message__manager.html" target="_self">msg_manager_t</a></td><td class="desc">Manage the message sub-system </td></tr>
+<tr id="row_5_"><td class="entry"><span style="width:16px;display:inline-block;">&#160;</span><span class="icona"><span class="icon">C</span></span><a class="el" href="de/d78/structt__message.html" target="_self">msg_t</a></td><td class="desc">Basic structure to represent a message </td></tr>
+<tr id="row_6_" class="even"><td class="entry"><span style="width:16px;display:inline-block;">&#160;</span><span class="icona"><span class="icon">C</span></span><a class="el" href="d0/de0/structt__garbage__collector.html" target="_self">t_garbage_collector</a></td><td class="desc">Garbage Collector structure </td></tr>
+<tr id="row_7_"><td class="entry"><span style="width:16px;display:inline-block;">&#160;</span><span class="icona"><span class="icon">C</span></span><a class="el" href="d4/d00/structt__group__members.html" target="_self">t_group_members</a></td><td class="desc">Threads that are members of the group device </td></tr>
+<tr id="row_8_" class="even"><td class="entry"><span style="width:16px;display:inline-block;">&#160;</span><span class="icona"><span class="icon">C</span></span><a class="el" href="db/d84/structt__group__sysfs.html" target="_self">t_group_sysfs</a></td><td class="desc">Contains all the 'sysfs' attrubutes and the group's kobject </td></tr>
+<tr id="row_9_"><td class="entry"><span style="width:16px;display:inline-block;">&#160;</span><span class="icona"><span class="icon">C</span></span><a class="el" href="db/dc1/structt__main__sync.html" target="_self">t_main_sync</a></td><td class="desc">Main device structure </td></tr>
+<tr id="row_10_" class="even"><td class="entry"><span style="width:16px;display:inline-block;">&#160;</span><span class="icona"><span class="icon">C</span></span><a class="el" href="d6/d20/structt__message__delayed__deliver.html" target="_self">t_message_delayed_deliver</a></td><td class="desc">Contains a 'msg_t' structure and the timer needed to delay the delivery </td></tr>
+<tr id="row_11_"><td class="entry"><span style="width:16px;display:inline-block;">&#160;</span><span class="icona"><span class="icon">C</span></span><a class="el" href="df/d34/structt__message__deliver.html" target="_self">t_message_deliver</a></td><td class="desc">Contains a 'msg_t' structure and the relative delivery info </td></tr>
+<tr id="row_12_" class="even"><td class="entry"><span style="width:16px;display:inline-block;">&#160;</span><span class="icona"><span class="icon">C</span></span><a class="el" href="db/d82/structT__THREAD__GROUP.html" target="_self">T_THREAD_GROUP</a></td><td class="desc">User-level handler of a group </td></tr>
+<tr id="row_13_"><td class="entry"><span style="width:16px;display:inline-block;">&#160;</span><span class="icona"><span class="icon">C</span></span><a class="el" href="d9/dbf/structT__THREAD__SYNCH.html" target="_self">T_THREAD_SYNCH</a></td><td class="desc">User-level handler of the thread-synch main device </td></tr>
 </table>
 </div><!-- directory -->
 </div><!-- contents -->

docs/html/classes.html

@@ -66,32 +66,39 @@
 <div class="title">Data Structure Index</div>  </div>
 </div><!--header-->
 <div class="contents">
-<div class="qindex"><a class="qindex" href="#letter_g">g</a>&#160;|&#160;<a class="qindex" href="#letter_m">m</a>&#160;|&#160;<a class="qindex" href="#letter_t">t</a></div>
+<div class="qindex"><a class="qindex" href="#letter_c">c</a>&#160;|&#160;<a class="qindex" href="#letter_g">g</a>&#160;|&#160;<a class="qindex" href="#letter_m">m</a>&#160;|&#160;<a class="qindex" href="#letter_t">t</a></div>
 <table class="classindex">
-<tr><td rowspan="2" valign="bottom"><a name="letter_g"></a><table border="0" cellspacing="0" cellpadding="0"><tr><td><div class="ah">&#160;&#160;g&#160;&#160;</div></td></tr></table>
+<tr><td rowspan="2" valign="bottom"><a name="letter_c"></a><table border="0" cellspacing="0" cellpadding="0"><tr><td><div class="ah">&#160;&#160;c&#160;&#160;</div></td></tr></table>
 </td>
-<td valign="top"><a class="el" href="d2/dc2/structgroup__t.html">group_t</a>&#160;&#160;&#160;</td>
+<td valign="top"><a class="el" href="d3/df9/structgroup__flags__t.html">group_flags_t</a>&#160;&#160;&#160;</td>
 <td valign="top"><a class="el" href="de/d78/structt__message.html">t_message</a>&#160;&#160;&#160;</td>
-<td valign="top"><a class="el" href="d4/d00/structt__group__members.html">t_group_members</a>&#160;&#160;&#160;</td>
-<td valign="top"><a class="el" href="df/d34/structt__message__deliver.html">t_message_deliver</a>&#160;&#160;&#160;</td>
+<td valign="top"><a class="el" href="db/d84/structt__group__sysfs.html">t_group_sysfs</a>&#160;&#160;&#160;</td>
+<td valign="top"><a class="el" href="d9/dbf/structT__THREAD__SYNCH.html">T_THREAD_SYNCH</a>&#160;&#160;&#160;</td>
 </tr>
-<tr><td rowspan="2" valign="bottom"><a name="letter_m"></a><table border="0" cellspacing="0" cellpadding="0"><tr><td><div class="ah">&#160;&#160;m&#160;&#160;</div></td></tr></table>
-</td>
+<tr><td valign="top"><a class="el" href="d2/dc2/structgroup__t.html">group_t</a>&#160;&#160;&#160;</td>
 <td rowspan="2" valign="bottom"><a name="letter_t"></a><table border="0" cellspacing="0" cellpadding="0"><tr><td><div class="ah">&#160;&#160;t&#160;&#160;</div></td></tr></table>
 </td>
-<td valign="top"><a class="el" href="db/d84/structt__group__sysfs.html">t_group_sysfs</a>&#160;&#160;&#160;</td>
-<td></td></tr>
-<tr><td valign="top"><a class="el" href="d2/d86/structgroup__data.html">group_data</a>&#160;&#160;&#160;</td>
 <td valign="top"><a class="el" href="db/dc1/structt__main__sync.html">t_main_sync</a>&#160;&#160;&#160;</td>
 <td></td></tr>
-<tr><td valign="top"><a class="el" href="d3/df9/structgroup__flags__t.html">group_flags_t</a>&#160;&#160;&#160;</td>
-<td valign="top"><a class="el" href="d3/d75/structt__message__manager.html">t_message_manager</a>&#160;&#160;&#160;</td>
-<td valign="top"><a class="el" href="d0/de0/structt__garbage__collector.html">t_garbage_collector</a>&#160;&#160;&#160;</td>
+<tr><td valign="top"><a class="el" href="d8/d3f/structconfiguration.html">configuration</a>&#160;&#160;&#160;</td>
+<td rowspan="2" valign="bottom"><a name="letter_m"></a><table border="0" cellspacing="0" cellpadding="0"><tr><td><div class="ah">&#160;&#160;m&#160;&#160;</div></td></tr></table>
+</td>
 <td valign="top"><a class="el" href="d6/d20/structt__message__delayed__deliver.html">t_message_delayed_deliver</a>&#160;&#160;&#160;</td>
 <td></td></tr>
+<tr><td rowspan="2" valign="bottom"><a name="letter_g"></a><table border="0" cellspacing="0" cellpadding="0"><tr><td><div class="ah">&#160;&#160;g&#160;&#160;</div></td></tr></table>
+</td>
+<td valign="top"><a class="el" href="d0/de0/structt__garbage__collector.html">t_garbage_collector</a>&#160;&#160;&#160;</td>
+<td valign="top"><a class="el" href="df/d34/structt__message__deliver.html">t_message_deliver</a>&#160;&#160;&#160;</td>
+<td></td></tr>
+<tr><td valign="top"><a class="el" href="d3/d75/structt__message__manager.html">t_message_manager</a>&#160;&#160;&#160;</td>
+<td valign="top"><a class="el" href="d4/d00/structt__group__members.html">t_group_members</a>&#160;&#160;&#160;</td>
+<td valign="top"><a class="el" href="db/d82/structT__THREAD__GROUP.html">T_THREAD_GROUP</a>&#160;&#160;&#160;</td>
+<td></td></tr>
+<tr><td valign="top"><a class="el" href="d2/d86/structgroup__data.html">group_data</a>&#160;&#160;&#160;</td>
+<td></td><td></td><td></td><td></td></tr>
 <tr><td></td><td></td><td></td><td></td><td></td></tr>
 </table>
-<div class="qindex"><a class="qindex" href="#letter_g">g</a>&#160;|&#160;<a class="qindex" href="#letter_m">m</a>&#160;|&#160;<a class="qindex" href="#letter_t">t</a></div>
+<div class="qindex"><a class="qindex" href="#letter_c">c</a>&#160;|&#160;<a class="qindex" href="#letter_g">g</a>&#160;|&#160;<a class="qindex" href="#letter_m">m</a>&#160;|&#160;<a class="qindex" href="#letter_t">t</a></div>
 </div><!-- contents -->
 <!-- start footer part -->
 <hr class="footer"/><address class="footer"><small>

docs/html/d0/d29/main_8c.html

@@ -87,38 +87,39 @@
 <div class="dyncontent">
 <div class="center"><img src="../../d4/d10/main_8c__incl.png" border="0" usemap="#src_2main_8c" alt=""/></div>
 <map name="src_2main_8c" id="src_2main_8c">
-<area shape="rect" title="Linux Kernel Module for Synchronization." alt="" coords="1146,5,1235,32"/>
-<area shape="rect" title=" " alt="" coords="213,304,331,331"/>
-<area shape="rect" title=" " alt="" coords="1451,229,1533,256"/>
-<area shape="rect" title=" " alt="" coords="703,379,803,405"/>
+<area shape="rect" title="Linux Kernel Module for Synchronization." alt="" coords="1103,5,1193,32"/>
+<area shape="rect" title=" " alt="" coords="170,304,289,331"/>
+<area shape="rect" title=" " alt="" coords="1573,229,1656,256"/>
+<area shape="rect" title=" " alt="" coords="715,379,815,405"/>
 <area shape="rect" title=" " alt="" coords="1262,229,1375,256"/>
-<area shape="rect" title=" " alt="" coords="91,304,189,331"/>
-<area shape="rect" title=" " alt="" coords="1253,304,1376,331"/>
-<area shape="rect" href="../../d2/dac/main__device_8h_source.html" title=" " alt="" coords="1132,80,1249,107"/>
-<area shape="rect" title=" " alt="" coords="1811,304,1922,331"/>
-<area shape="rect" title=" " alt="" coords="407,304,550,331"/>
-<area shape="rect" title=" " alt="" coords="296,229,395,256"/>
-<area shape="rect" title=" " alt="" coords="1099,229,1186,256"/>
-<area shape="rect" href="../../d4/dbe/group__manager_8h_source.html" title=" " alt="" coords="790,155,925,181"/>
-<area shape="rect" href="../../d4/dca/sysfs_8h.html" title="Setup the required sysfs interfaces for the module." alt="" coords="1686,155,1754,181"/>
-<area shape="rect" title=" " alt="" coords="739,229,845,256"/>
-<area shape="rect" title=" " alt="" coords="869,229,973,256"/>
-<area shape="rect" href="../../d2/d0d/message_8h_source.html" title=" " alt="" coords="621,229,715,256"/>
-<area shape="rect" title=" " alt="" coords="1139,304,1229,331"/>
-<area shape="rect" title=" " alt="" coords="575,304,692,331"/>
-<area shape="rect" title=" " alt="" coords="716,304,828,331"/>
-<area shape="rect" title=" " alt="" coords="851,304,975,331"/>
-<area shape="rect" title=" " alt="" coords="1000,304,1115,331"/>
-<area shape="rect" href="../../d9/d49/types_8h_source.html" title=" " alt="" coords="1471,304,1542,331"/>
-<area shape="rect" title=" " alt="" coords="1369,379,1476,405"/>
-<area shape="rect" title=" " alt="" coords="1500,379,1591,405"/>
-<area shape="rect" title=" " alt="" coords="1989,379,2104,405"/>
-<area shape="rect" title=" " alt="" coords="1615,379,1758,405"/>
-<area shape="rect" title=" " alt="" coords="1783,379,1887,405"/>
-<area shape="rect" title=" " alt="" coords="1113,379,1212,405"/>
-<area shape="rect" title=" " alt="" coords="1237,379,1345,405"/>
-<area shape="rect" title=" " alt="" coords="1709,229,1827,256"/>
-<area shape="rect" title=" " alt="" coords="1851,229,1978,256"/>
+<area shape="rect" title=" " alt="" coords="49,304,146,331"/>
+<area shape="rect" title=" " alt="" coords="1885,304,2008,331"/>
+<area shape="rect" href="../../d2/dac/main__device_8h_source.html" title=" " alt="" coords="1089,80,1207,107"/>
+<area shape="rect" title=" " alt="" coords="1210,304,1321,331"/>
+<area shape="rect" title=" " alt="" coords="1043,304,1186,331"/>
+<area shape="rect" title=" " alt="" coords="245,229,344,256"/>
+<area shape="rect" title=" " alt="" coords="998,229,1085,256"/>
+<area shape="rect" href="../../d4/dbe/group__manager_8h_source.html" title=" " alt="" coords="842,155,977,181"/>
+<area shape="rect" href="../../d4/dca/sysfs_8h.html" title="Setup the required sysfs interfaces for the module." alt="" coords="1710,155,1778,181"/>
+<area shape="rect" title=" " alt="" coords="637,229,744,256"/>
+<area shape="rect" title=" " alt="" coords="768,229,872,256"/>
+<area shape="rect" title=" " alt="" coords="1400,229,1499,256"/>
+<area shape="rect" href="../../d2/d0d/message_8h_source.html" title=" " alt="" coords="520,229,613,256"/>
+<area shape="rect" title=" " alt="" coords="928,304,1019,331"/>
+<area shape="rect" title=" " alt="" coords="364,304,481,331"/>
+<area shape="rect" title=" " alt="" coords="505,304,617,331"/>
+<area shape="rect" title=" " alt="" coords="641,304,765,331"/>
+<area shape="rect" title=" " alt="" coords="789,304,904,331"/>
+<area shape="rect" href="../../d9/d49/types_8h_source.html" title=" " alt="" coords="1438,304,1509,331"/>
+<area shape="rect" title=" " alt="" coords="1359,379,1465,405"/>
+<area shape="rect" title=" " alt="" coords="1489,379,1580,405"/>
+<area shape="rect" title=" " alt="" coords="2041,379,2156,405"/>
+<area shape="rect" title=" " alt="" coords="1605,379,1747,405"/>
+<area shape="rect" title=" " alt="" coords="1772,379,1876,405"/>
+<area shape="rect" title=" " alt="" coords="1103,379,1201,405"/>
+<area shape="rect" title=" " alt="" coords="1226,379,1334,405"/>
+<area shape="rect" title=" " alt="" coords="1984,229,2101,256"/>
+<area shape="rect" title=" " alt="" coords="1782,229,1909,256"/>
 </map>
 </div>
 </div><table class="memberdecls">

docs/html/d0/d63/sysfs_8h__incl.md5

@@ -1 +1 @@
-2b0c03f6668d58a180249f79b91f1b50
+190289bff03ec83653afe1f8ab527da6

docs/html/d0/d63/sysfs_8h__incl.png

@@ -250,7 +250,7 @@ <h2 class="memtitle"><span class="permalink"><a href="#aaa0bbdede7f7c74403859a3e
   </table>
   </dd>
 </dl>
-<dl class="todo"><dt><b><a class="el" href="../../dd/da0/todo.html#_todo000005">Todo:</a></b></dt><dd>Check thread-safety of the function </dd></dl>
+<dl class="todo"><dt><b><a class="el" href="../../dd/da0/todo.html#_todo000006">Todo:</a></b></dt><dd>Check thread-safety of the function </dd></dl>
 <dl class="section note"><dt>Note</dt><dd>The kmsg structure must be allocated </dd></dl>
 
 </div>
@@ -302,7 +302,7 @@ <h2 class="memtitle"><span class="permalink"><a href="#a02620253a55902a0dc6e7931
   </table>
   </dd>
 </dl>
-<dl class="todo"><dt><b><a class="el" href="../../dd/da0/todo.html#_todo000004">Todo:</a></b></dt><dd>Check thread-safety of the function </dd></dl>
+<dl class="todo"><dt><b><a class="el" href="../../dd/da0/todo.html#_todo000005">Todo:</a></b></dt><dd>Check thread-safety of the function </dd></dl>
 <dl class="section note"><dt>Note</dt><dd>The umsg structure must be allocated </dd></dl>
 
 </div>