DataDescriptor API
+<!-- ##### SECTION ./tmpl/Dynamic_arrays.sgml:Long_Description ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### SECTION ./tmpl/Dynamic_arrays.sgml:See_Also ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### SECTION ./tmpl/Dynamic_arrays.sgml:Short_Description ##### -->
+
+
+
+<!-- ##### SECTION ./tmpl/Dynamic_arrays.sgml:Title ##### -->
+Dynamic arrays
+
+
<!-- ##### SECTION ./tmpl/ErrLog.sgml:Long_Description ##### -->
<para>
Sockets API
+<!-- ##### SECTION ./tmpl/comm_callbacks.sgml:Long_Description ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### SECTION ./tmpl/comm_callbacks.sgml:See_Also ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### SECTION ./tmpl/comm_callbacks.sgml:Short_Description ##### -->
+
+
+
+<!-- ##### SECTION ./tmpl/comm_callbacks.sgml:Title ##### -->
+comm_callbacks
+
+
+<!-- ##### SECTION ./tmpl/comm_cb.sgml:Long_Description ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### SECTION ./tmpl/comm_cb.sgml:See_Also ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### SECTION ./tmpl/comm_cb.sgml:Short_Description ##### -->
+
+
+
+<!-- ##### SECTION ./tmpl/comm_cb.sgml:Title ##### -->
+comm_cb
+
+
+<!-- ##### SECTION ./tmpl/comm_datadesc_expert.sgml:Long_Description ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### SECTION ./tmpl/comm_datadesc_expert.sgml:See_Also ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### SECTION ./tmpl/comm_datadesc_expert.sgml:Short_Description ##### -->
+Advanced ways to describe data (for experts)
+
+
+<!-- ##### SECTION ./tmpl/comm_datadesc_expert.sgml:Title ##### -->
+Advanced Data description
+
+
<!-- ##### SECTION ./tmpl/comm_dd_cbps.sgml:Long_Description ##### -->
<para>
Data description callbacks persistant state
+<!-- ##### SECTION ./tmpl/dd_internal.sgml:Long_Description ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### SECTION ./tmpl/dd_internal.sgml:See_Also ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### SECTION ./tmpl/dd_internal.sgml:Short_Description ##### -->
+
+
+
+<!-- ##### SECTION ./tmpl/dd_internal.sgml:Title ##### -->
+Implementation of data description
+
+
<!-- ##### SECTION ./tmpl/dico.sgml:Long_Description ##### -->
<para>
Overview
-<!-- ##### SECTION ./tmpl/gras.sgml:Long_Description ##### -->
+<!-- ##### SECTION ./tmpl/gras-sections.txt.sgml.sgml.sgml.sgml.sgml.sgml.sgml.sgml.sgml.sgml.sgml.sgml.sgml.sgml:Long_Description ##### -->
<para>
</para>
-<!-- ##### SECTION ./tmpl/gras.sgml:See_Also ##### -->
+<!-- ##### SECTION ./tmpl/gras-sections.txt.sgml.sgml.sgml.sgml.sgml.sgml.sgml.sgml.sgml.sgml.sgml.sgml.sgml.sgml:See_Also ##### -->
<para>
</para>
-<!-- ##### SECTION ./tmpl/gras.sgml:Short_Description ##### -->
+<!-- ##### SECTION ./tmpl/gras-sections.txt.sgml.sgml.sgml.sgml.sgml.sgml.sgml.sgml.sgml.sgml.sgml.sgml.sgml.sgml:Short_Description ##### -->
-<!-- ##### SECTION ./tmpl/gras.sgml:Title ##### -->
-gras
+<!-- ##### SECTION ./tmpl/gras-sections.txt.sgml.sgml.sgml.sgml.sgml.sgml.sgml.sgml.sgml.sgml.sgml.sgml.sgml.sgml:Title ##### -->
+./gras-sections.txt.sgml.sgml.sgml.sgml.sgml.sgml.sgml.sgml.sgml.sgml.sgml.sgml.sgml
-<!-- ##### SECTION ./tmpl/nws_comm.sgml:Long_Description ##### -->
+<!-- ##### SECTION ./tmpl/gras-sections.txt.sgml.sgml.sgml.sgml.sgml.sgml.sgml.sgml.sgml.sgml.sgml.sgml.sgml:Long_Description ##### -->
<para>
</para>
-<!-- ##### SECTION ./tmpl/nws_comm.sgml:See_Also ##### -->
+<!-- ##### SECTION ./tmpl/gras-sections.txt.sgml.sgml.sgml.sgml.sgml.sgml.sgml.sgml.sgml.sgml.sgml.sgml.sgml:See_Also ##### -->
<para>
</para>
-<!-- ##### SECTION ./tmpl/nws_comm.sgml:Short_Description ##### -->
+<!-- ##### SECTION ./tmpl/gras-sections.txt.sgml.sgml.sgml.sgml.sgml.sgml.sgml.sgml.sgml.sgml.sgml.sgml.sgml:Short_Description ##### -->
-<!-- ##### SECTION ./tmpl/nws_comm.sgml:Title ##### -->
-nws_comm
+<!-- ##### SECTION ./tmpl/gras-sections.txt.sgml.sgml.sgml.sgml.sgml.sgml.sgml.sgml.sgml.sgml.sgml.sgml.sgml:Title ##### -->
+./gras-sections.txt.sgml.sgml.sgml.sgml.sgml.sgml.sgml.sgml.sgml.sgml.sgml.sgml
-<!-- ##### SECTION ./tmpl/trp_socks.sgml:Long_Description ##### -->
+<!-- ##### SECTION ./tmpl/gras-sections.txt.sgml.sgml.sgml.sgml.sgml.sgml.sgml.sgml.sgml.sgml.sgml.sgml:Long_Description ##### -->
<para>
</para>
-<!-- ##### SECTION ./tmpl/trp_socks.sgml:See_Also ##### -->
+<!-- ##### SECTION ./tmpl/gras-sections.txt.sgml.sgml.sgml.sgml.sgml.sgml.sgml.sgml.sgml.sgml.sgml.sgml:See_Also ##### -->
<para>
</para>
-<!-- ##### SECTION ./tmpl/trp_socks.sgml:Short_Description ##### -->
+<!-- ##### SECTION ./tmpl/gras-sections.txt.sgml.sgml.sgml.sgml.sgml.sgml.sgml.sgml.sgml.sgml.sgml.sgml:Short_Description ##### -->
-<!-- ##### SECTION ./tmpl/trp_socks.sgml:Title ##### -->
-Sockets
+<!-- ##### SECTION ./tmpl/gras-sections.txt.sgml.sgml.sgml.sgml.sgml.sgml.sgml.sgml.sgml.sgml.sgml.sgml:Title ##### -->
+./gras-sections.txt.sgml.sgml.sgml.sgml.sgml.sgml.sgml.sgml.sgml.sgml.sgml
-<!-- ##### MACRO BEGIN_DECL ##### -->
+<!-- ##### SECTION ./tmpl/gras-sections.txt.sgml.sgml.sgml.sgml.sgml.sgml.sgml.sgml.sgml.sgml.sgml:Long_Description ##### -->
<para>
</para>
-<!-- ##### MACRO CCRITICAL0 ##### -->
+<!-- ##### SECTION ./tmpl/gras-sections.txt.sgml.sgml.sgml.sgml.sgml.sgml.sgml.sgml.sgml.sgml.sgml:See_Also ##### -->
<para>
</para>
-@c:
-@f:
-<!-- ##### MACRO CCRITICAL1 ##### -->
-<para>
+<!-- ##### SECTION ./tmpl/gras-sections.txt.sgml.sgml.sgml.sgml.sgml.sgml.sgml.sgml.sgml.sgml.sgml:Short_Description ##### -->
-</para>
-@c:
-@f:
-@a1:
-<!-- ##### MACRO CCRITICAL2 ##### -->
+<!-- ##### SECTION ./tmpl/gras-sections.txt.sgml.sgml.sgml.sgml.sgml.sgml.sgml.sgml.sgml.sgml.sgml:Title ##### -->
+./gras-sections.txt.sgml.sgml.sgml.sgml.sgml.sgml.sgml.sgml.sgml.sgml
+
+
+<!-- ##### SECTION ./tmpl/gras-sections.txt.sgml.sgml.sgml.sgml.sgml.sgml.sgml.sgml.sgml.sgml:Long_Description ##### -->
<para>
</para>
-@c:
-@f:
-@a1:
-@a2:
-<!-- ##### MACRO CCRITICAL3 ##### -->
+<!-- ##### SECTION ./tmpl/gras-sections.txt.sgml.sgml.sgml.sgml.sgml.sgml.sgml.sgml.sgml.sgml:See_Also ##### -->
<para>
</para>
-@c:
-@f:
-@a1:
-@a2:
-@a3:
-<!-- ##### MACRO CCRITICAL4 ##### -->
-<para>
+<!-- ##### SECTION ./tmpl/gras-sections.txt.sgml.sgml.sgml.sgml.sgml.sgml.sgml.sgml.sgml.sgml:Short_Description ##### -->
-</para>
-@c:
-@f:
-@a1:
-@a2:
-@a3:
-@a4:
-<!-- ##### MACRO CCRITICAL5 ##### -->
+<!-- ##### SECTION ./tmpl/gras-sections.txt.sgml.sgml.sgml.sgml.sgml.sgml.sgml.sgml.sgml.sgml:Title ##### -->
+./gras-sections.txt.sgml.sgml.sgml.sgml.sgml.sgml.sgml.sgml.sgml
+
+
+<!-- ##### SECTION ./tmpl/gras-sections.txt.sgml.sgml.sgml.sgml.sgml.sgml.sgml.sgml.sgml:Long_Description ##### -->
<para>
</para>
-@c:
-@f:
-@a1:
-@a2:
-@a3:
-@a4:
-@a5:
-<!-- ##### MACRO CDEBUG0 ##### -->
+<!-- ##### SECTION ./tmpl/gras-sections.txt.sgml.sgml.sgml.sgml.sgml.sgml.sgml.sgml.sgml:See_Also ##### -->
<para>
</para>
-@c:
-@f:
-<!-- ##### MACRO CDEBUG1 ##### -->
+<!-- ##### SECTION ./tmpl/gras-sections.txt.sgml.sgml.sgml.sgml.sgml.sgml.sgml.sgml.sgml:Short_Description ##### -->
+
+
+
+<!-- ##### SECTION ./tmpl/gras-sections.txt.sgml.sgml.sgml.sgml.sgml.sgml.sgml.sgml.sgml:Title ##### -->
+./gras-sections.txt.sgml.sgml.sgml.sgml.sgml.sgml.sgml.sgml
+
+
+<!-- ##### SECTION ./tmpl/gras-sections.txt.sgml.sgml.sgml.sgml.sgml.sgml.sgml.sgml:Long_Description ##### -->
<para>
</para>
-@c:
-@f:
-@a1:
-<!-- ##### MACRO CDEBUG2 ##### -->
+<!-- ##### SECTION ./tmpl/gras-sections.txt.sgml.sgml.sgml.sgml.sgml.sgml.sgml.sgml:See_Also ##### -->
<para>
</para>
-@c:
-@f:
-@a1:
-@a2:
-<!-- ##### MACRO CDEBUG3 ##### -->
+<!-- ##### SECTION ./tmpl/gras-sections.txt.sgml.sgml.sgml.sgml.sgml.sgml.sgml.sgml:Short_Description ##### -->
+
+
+
+<!-- ##### SECTION ./tmpl/gras-sections.txt.sgml.sgml.sgml.sgml.sgml.sgml.sgml.sgml:Title ##### -->
+./gras-sections.txt.sgml.sgml.sgml.sgml.sgml.sgml.sgml
+
+
+<!-- ##### SECTION ./tmpl/gras-sections.txt.sgml.sgml.sgml.sgml.sgml.sgml.sgml:Long_Description ##### -->
<para>
</para>
-@c:
-@f:
-@a1:
-@a2:
-@a3:
-<!-- ##### MACRO CDEBUG4 ##### -->
+<!-- ##### SECTION ./tmpl/gras-sections.txt.sgml.sgml.sgml.sgml.sgml.sgml.sgml:See_Also ##### -->
<para>
</para>
-@c:
-@f:
-@a1:
-@a2:
-@a3:
-@a4:
-<!-- ##### MACRO CDEBUG5 ##### -->
+<!-- ##### SECTION ./tmpl/gras-sections.txt.sgml.sgml.sgml.sgml.sgml.sgml.sgml:Short_Description ##### -->
+
+
+
+<!-- ##### SECTION ./tmpl/gras-sections.txt.sgml.sgml.sgml.sgml.sgml.sgml.sgml:Title ##### -->
+./gras-sections.txt.sgml.sgml.sgml.sgml.sgml.sgml
+
+
+<!-- ##### SECTION ./tmpl/gras-sections.txt.sgml.sgml.sgml.sgml.sgml.sgml:Long_Description ##### -->
<para>
</para>
-@c:
-@f:
-@a1:
-@a2:
-@a3:
-@a4:
-@a5:
-<!-- ##### MACRO CERROR0 ##### -->
+<!-- ##### SECTION ./tmpl/gras-sections.txt.sgml.sgml.sgml.sgml.sgml.sgml:See_Also ##### -->
<para>
</para>
-@c:
-@f:
-<!-- ##### MACRO CERROR1 ##### -->
+<!-- ##### SECTION ./tmpl/gras-sections.txt.sgml.sgml.sgml.sgml.sgml.sgml:Short_Description ##### -->
+
+
+
+<!-- ##### SECTION ./tmpl/gras-sections.txt.sgml.sgml.sgml.sgml.sgml.sgml:Title ##### -->
+./gras-sections.txt.sgml.sgml.sgml.sgml.sgml
+
+
+<!-- ##### SECTION ./tmpl/gras-sections.txt.sgml.sgml.sgml.sgml.sgml:Long_Description ##### -->
<para>
</para>
-@c:
-@f:
-@a1:
-<!-- ##### MACRO CERROR2 ##### -->
+<!-- ##### SECTION ./tmpl/gras-sections.txt.sgml.sgml.sgml.sgml.sgml:See_Also ##### -->
<para>
</para>
-@c:
-@f:
-@a1:
-@a2:
-<!-- ##### MACRO CERROR3 ##### -->
+<!-- ##### SECTION ./tmpl/gras-sections.txt.sgml.sgml.sgml.sgml.sgml:Short_Description ##### -->
+
+
+
+<!-- ##### SECTION ./tmpl/gras-sections.txt.sgml.sgml.sgml.sgml.sgml:Title ##### -->
+./gras-sections.txt.sgml.sgml.sgml.sgml
+
+
+<!-- ##### SECTION ./tmpl/gras-sections.txt.sgml.sgml.sgml.sgml:Long_Description ##### -->
<para>
</para>
-@c:
-@f:
-@a1:
-@a2:
-@a3:
-<!-- ##### MACRO CERROR4 ##### -->
+<!-- ##### SECTION ./tmpl/gras-sections.txt.sgml.sgml.sgml.sgml:See_Also ##### -->
<para>
</para>
-@c:
-@f:
-@a1:
-@a2:
-@a3:
-@a4:
-<!-- ##### MACRO CERROR5 ##### -->
+<!-- ##### SECTION ./tmpl/gras-sections.txt.sgml.sgml.sgml.sgml:Short_Description ##### -->
+
+
+
+<!-- ##### SECTION ./tmpl/gras-sections.txt.sgml.sgml.sgml.sgml:Title ##### -->
+./gras-sections.txt.sgml.sgml.sgml
+
+
+<!-- ##### SECTION ./tmpl/gras-sections.txt.sgml.sgml.sgml:Long_Description ##### -->
<para>
</para>
-@c:
-@f:
-@a1:
-@a2:
-@a3:
-@a4:
-@a5:
-<!-- ##### MACRO CINFO0 ##### -->
+<!-- ##### SECTION ./tmpl/gras-sections.txt.sgml.sgml.sgml:See_Also ##### -->
<para>
</para>
-@c:
-@f:
-<!-- ##### MACRO CINFO1 ##### -->
+<!-- ##### SECTION ./tmpl/gras-sections.txt.sgml.sgml.sgml:Short_Description ##### -->
+
+
+
+<!-- ##### SECTION ./tmpl/gras-sections.txt.sgml.sgml.sgml:Title ##### -->
+./gras-sections.txt.sgml.sgml
+
+
+<!-- ##### SECTION ./tmpl/gras-sections.txt.sgml.sgml:Long_Description ##### -->
<para>
</para>
-@c:
-@f:
-@a1:
-<!-- ##### MACRO CINFO2 ##### -->
+<!-- ##### SECTION ./tmpl/gras-sections.txt.sgml.sgml:See_Also ##### -->
<para>
</para>
-@c:
-@f:
-@a1:
-@a2:
-<!-- ##### MACRO CINFO3 ##### -->
+<!-- ##### SECTION ./tmpl/gras-sections.txt.sgml.sgml:Short_Description ##### -->
+
+
+
+<!-- ##### SECTION ./tmpl/gras-sections.txt.sgml.sgml:Title ##### -->
+./gras-sections.txt.sgml
+
+
+<!-- ##### SECTION ./tmpl/gras-sections.txt.sgml:Long_Description ##### -->
<para>
</para>
-@c:
-@f:
-@a1:
-@a2:
-@a3:
-<!-- ##### MACRO CINFO4 ##### -->
+<!-- ##### SECTION ./tmpl/gras-sections.txt.sgml:See_Also ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### SECTION ./tmpl/gras-sections.txt.sgml:Short_Description ##### -->
+
+
+
+<!-- ##### SECTION ./tmpl/gras-sections.txt.sgml:Title ##### -->
+./gras-sections.txt
+
+
+<!-- ##### SECTION ./tmpl/gras.sgml:Long_Description ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### SECTION ./tmpl/gras.sgml:See_Also ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### SECTION ./tmpl/gras.sgml:Short_Description ##### -->
+
+
+
+<!-- ##### SECTION ./tmpl/gras.sgml:Title ##### -->
+gras
+
+
+<!-- ##### SECTION ./tmpl/gras_private.sgml:Long_Description ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### SECTION ./tmpl/gras_private.sgml:See_Also ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### SECTION ./tmpl/gras_private.sgml:Short_Description ##### -->
+
+
+
+<!-- ##### SECTION ./tmpl/gras_private.sgml:Title ##### -->
+gras_private
+
+
+<!-- ##### SECTION ./tmpl/gras_rl.sgml:Long_Description ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### SECTION ./tmpl/gras_rl.sgml:See_Also ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### SECTION ./tmpl/gras_rl.sgml:Short_Description ##### -->
+Implementation of GRAS suited for real life.
+
+
+<!-- ##### SECTION ./tmpl/gras_rl.sgml:Title ##### -->
+RL
+
+
+<!-- ##### SECTION ./tmpl/gras_sg.sgml:Long_Description ##### -->
+<para>
+ SimGrid was designed to ease the comparison of algorithms and
+ heuristics. That way, a lot of complicated notion from the system layer
+ were volontary left off. For example, migrating a process from an host to
+ another is as easy as: MSG_process_change_host(process, new_host).
+</para>
+
+<para>
+ No need to tell that performing this operation on real platform is really
+ harder. This simplification is a very good thing when you want to rapidly
+ prototype code, but makes things somehow more complicated in GRAS since
+ we want to have a realistic API, since it have to be implemented in
+ reality also.
+</para>
+
+<para>
+ The best example of complexity in GRAS_SG induced by simplicity in
+ SimGrid is the sockets handling. There is no "socket" in SG, but only
+ m_channel_t. In contrary to sockets from RL, no special treatment is
+ needed for a process before writing or reading on/from a channel. So, a
+ given channel can be pooled by more than one process. Likewise, you can
+ send data to a channel that nobody is actually listening to.
+</para>
+
+<para>
+ The SG implementation of GRAS repport as an error the fact that nobody is
+ listening to the socket when trying to open a socket, or send stuff using
+ a previously openned socket. That way, the SG version can be used to
+ debug all syncronization issues. For that, we store mainly the PID of
+ both the sender and the receiver in the socket structure, and then
+ resolve PID->process at the lastest moment. This search is a bit
+ expensive, but as long as there is no real garbage collection in SG, with
+ the information "dead process" within the structure, it's the only
+ solution to make sure that we won't dereference pointers to an old freed
+ structure when the process on the other side of the structure did finish
+ since the creation of the socket.
+</para>
+
+<para>
+ As said in the overview, the processes can declare to hear on several
+ sockets, but all incoming messages are handled by the same loop. So, we
+ can use only one channel per process, and use a table on each host to
+ determine to which process a message should be delivered depending on the
+ socket number provided by the sender.
+</para>
+
+
+<!-- ##### SECTION ./tmpl/gras_sg.sgml:See_Also ##### -->
+<para>
+RL, the implementation suited for real life.
+</para>
+
+<!--
+Local variables:
+sgml-parent-document:\.\./gras-docs\.sgml
+sgml-omittag:t
+sgml-shorttag:t
+sgml-namecase-general:t
+sgml-general-insert-case:lower
+sgml-minimize-attributes:nil
+sgml-always-quote-attributes:t
+sgml-indent-step:2
+sgml-indent-data:nil
+sgml-exposed-tags:nil
+sgml-local-catalogs:nil
+sgml-local-ecat-files:nil
+End:
+-->
+
+
+<!-- ##### SECTION ./tmpl/gras_sg.sgml:Short_Description ##### -->
+Implementation of GRAS on top of the simulator.
+
+
+<!-- ##### SECTION ./tmpl/gras_sg.sgml:Title ##### -->
+SG
+
+
+<!-- ##### SECTION ./tmpl/nws_comm.sgml:Long_Description ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### SECTION ./tmpl/nws_comm.sgml:See_Also ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### SECTION ./tmpl/nws_comm.sgml:Short_Description ##### -->
+
+
+
+<!-- ##### SECTION ./tmpl/nws_comm.sgml:Title ##### -->
+nws_comm
+
+
+<!-- ##### SECTION ./tmpl/tbx_cfg.sgml:Long_Description ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### SECTION ./tmpl/tbx_cfg.sgml:See_Also ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### SECTION ./tmpl/tbx_cfg.sgml:Short_Description ##### -->
+Configuration facilities.
+
+
+<!-- ##### SECTION ./tmpl/tbx_cfg.sgml:Title ##### -->
+Config
+
+
+<!-- ##### SECTION ./tmpl/tbx_dico.sgml:Long_Description ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### SECTION ./tmpl/tbx_dico.sgml:See_Also ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### SECTION ./tmpl/tbx_dico.sgml:Short_Description ##### -->
+Data container associating data to a string key.
+
+
+<!-- ##### SECTION ./tmpl/tbx_dico.sgml:Title ##### -->
+Dictionnary
+
+
+<!-- ##### SECTION ./tmpl/tbx_dynar.sgml:Long_Description ##### -->
+<para>
+This module provide the quite usual dynamic array facility.
+</para>
+
+
+<!-- ##### SECTION ./tmpl/tbx_dynar.sgml:See_Also ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### SECTION ./tmpl/tbx_dynar.sgml:Short_Description ##### -->
+Use arrays, forget about malloc
+
+
+<!-- ##### SECTION ./tmpl/tbx_dynar.sgml:Title ##### -->
+Dynamic array
+
+
+<!-- ##### SECTION ./tmpl/tbx_err.sgml:Long_Description ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### SECTION ./tmpl/tbx_err.sgml:See_Also ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### SECTION ./tmpl/tbx_err.sgml:Short_Description ##### -->
+Error reporting
+
+
+<!-- ##### SECTION ./tmpl/tbx_err.sgml:Title ##### -->
+Errors handling
+
+
+<!-- ##### SECTION ./tmpl/tbx_log.sgml:Long_Description ##### -->
+<para>
+ This is an adaptation of the log4c project, which is dead upstream, and which
+ I was given the permission to fork under the LGPL licence by the authors. log4c
+ itself was loosely based on the Apache project's Log4J, Log4CC,
+ etc. project. Because C is not object oriented, a lot had to change.
+</para>
+
+<refsect2>
+ <title>Overview</title>
+
+ <para>
+ There is 3 main concepts: category, priority and appender. These three
+ concepts work together to enable developers to log messages according to
+ message type and priority, and to control at runtime how these messages are
+ formatted and where they are reported.
+ </para>
+</refsect2>
+
+<refsect2>
+ <title>Category hierarchy</title>
+
+ <para>
+ The first and foremost advantage of any logging API over plain printf()
+ resides in its ability to disable certain log statements while allowing
+ others to print unhindered. This capability assumes that the logging space,
+ that is, the space of all possible logging statements, is categorized
+ according to some developer-chosen criteria.
+ </para>
+
+ <para>
+ This observation led to choosing category as the central concept of the
+ system. Every category is declared by providing a name and an optional
+ parent. If no parent is explicitly named, the root category, LOG_ROOT_CAT
+ is the category's parent.
+ </para>
+
+ <para>
+ A category is created by a macro call at the top level of a file. A
+ category can be created with any one of the following macros:
+ </para>
+
+ <itemizedlist>
+ <listitem>
+ <para>@GRAS_LOG_NEW_CATEGORY(MyCat);</para>
+ <para>create a new root</para>
+ </listitem>
+
+ <listitem>
+ <para>@GRAS_LOG_NEW_SUBCATEGORY(MyCat, ParentCat);</para>
+ <para>Create a new category being child of the category ParentCat</para>
+ </listitem>
+
+ <listitem>
+ <para>@GRAS_LOG_NEW_DEFAULT_CATEGORY(MyCat);</para>
+ <para>Like GRAS_LOG_NEW_CATEGORY, but the new category is the default one
+ in this file</para>
+ </listitem>
+
+ <listitem>
+ <para>@GRAS_LOG_NEW_DEFAULT_SUBCATEGORY(MyCat, ParentCat);</para>
+ <para>Like GRAS_LOG_NEW_SUBCATEGORY, but the new category is the default one
+ in this file</para>
+ </listitem>
+ </itemizedlist>
+
+ <para>
+ The parent cat can be defined in the same file or in another file, but each
+ category may have only one definition.
+ </para>
+
+ <para>
+ Typically, there will be a Category for each module and sub-module, so you
+ can independently control logging for each module.
+ </para>
+</refsect2>
+
+<refsect2>
+ <title>Priority</title>
+
+ <para>
+ A category may be assigned a threshold priorty. The set of priorites are
+ defined by the @gras_log_priority_t enum. Their values are DEBUG, VERBOSE,
+ INFO, WARNING, ERROR and CRITICAL.
+ </para>
+
+ <para>
+ If a given category is not assigned a threshold priority, then it inherits
+ one from its closest ancestor with an assigned threshold.
+ </para>
+
+ <para>
+ To ensure that all categories can eventually inherit a threshold, the root
+ category always has an assigned threshold priority.
+ </para>
+
+ <para>
+ Logging requests are made by invoking a logging macro on a category. All
+ of the macros have a printf-style format string followed by arguments.
+ Because most C compilers do not support vararg macros, there is a version
+ of the macro for any number of arguments from 0 to 6. The macro name ends
+ with the total number of arguments.
+ </para>
+
+ <para>
+ Here is an example of the most basic type of macro:
+ </para>
+
+ <programlisting>CLOG5(MyCat, gras_log_priority_warning, "Values are: %d and '%s'", 5, "oops");</programlisting>
+
+ <para>This is a logging request with priority WARN.</para>
+
+ <para>
+ A logging request is said to be enabled if its priority is higher than or
+ equal to the threshold priority of its category. Otherwise, the request is
+ said to be disabled. A category without an assigned priority will inherit
+ one from the hierarchy.
+ </para>
+
+ <para>
+ It is possible to use any non-negative integer as a priority. If, as in the
+ example, one of the standard priorites is used, then there is a convenience
+ macro that is typically used instead. For example, the above example is
+ equivalent to the shorter:
+ </para>
+
+ <programlisting>CWARN4(MyCat, "Values are: %d and '%s'", 5, "oops");</programlisting>
+</refsect2>
+
+<refsect2>
+ <title>Default category</title>
+
+ <para>
+ If @GRAS_LOG_NEW_DEFAULT_SUBCATEGORY(MyCat, Parent) or
+ @GRAS_LOG_NEW_DEFAULT_CATEGORY(MyCat) is used to create the category, then
+ the even shorter form can be used:
+ </para>
+
+ <programlisting>WARN3("Values are: %d and '%s'", 5, "oops");</programlisting>
+
+ <para>
+ Only one default category can be created per file, though multiple
+ non-defaults can be created and used.
+ </para>
+</refsect2>
+
+<refsect2>
+ <title>Example</title>
+
+ <para>Here is a more complete example:</para>
+
+ <programlisting>
+ #include "gras.h"
+
+ /* create a category and a default subcategory */
+ GRAS_LOG_NEW_CATEGORY(VSS);
+ GRAS_LOG_NEW_DEFAULT_SUBCATEGORY(SA, VSS);
+
+ main() {
+ /* Now set the parent's priority.
+ (the string would typcially be a runtime option) */
+ gras_log_control_set("SA.thresh=3");
+
+ /* This request is enabled, because WARNING >= INFO. */
+ CWARN2(VSS, "Low fuel level.");
+
+ /* This request is disabled, because DEBUG < INFO. */
+ CDEBUG2(VSS, "Starting search for nearest gas station.");
+
+ /* The default category SA inherits its priority from VSS. Thus,
+ the following request is enabled because INFO >= INFO. */
+ INFO1("Located nearest gas station.");
+
+ /* This request is disabled, because DEBUG < INFO. */
+ DEBUG1("Exiting gas station search");
+ }</programlisting>
+</refsect2>
+
+<refsect2>
+ <title>Configuration</title>
+
+ <para>
+ Configuration is typically done during program initialization by invoking
+ the gras_log_control_set() method. The control string passed to it
+ typically comes from the command line. Look at the doucmentation for that
+ function for the format of the control string.
+ </para>
+</refsect2>
+
+<refsect2>
+ <title>Performance</title>
+
+ <para>
+ Clever design insures efficiency. Except for the first invocation, a
+ disabled logging request requires an a single comparison of a static
+ variable to a constant.
+ </para>
+
+ <para>
+ There is also compile time constant, @GRAS_LOG_STATIC_THRESHOLD, which
+ causes all logging requests with a lower priority to be optimized to 0 cost
+ by the compiler. By setting it to gras_log_priority_infinite, all logging
+ requests are statically disabled and cost nothing. Released executables
+ might typically be compiled with
+ "-DGRAS_LOG_STATIC_THRESHOLD=gras_log_priority_infinite".
+ </para>
+</refsect2>
+
+<refsect2>
+ <title>Appenders</title>
+
+ <para>
+ Each category has an optional appender. An appender is a pointer to a
+ structure whcih starts with a pointer to a doAppend() function. DoAppend()
+ prints a message to a log.
+ </para>
+
+ <para>
+ WHen a category is passed a message by one of the logging macros, the
+ category performs the following actions:
+ </para>
+
+ <itemizedlist>
+ <listitem>
+ <para>
+ if the category has an appender, the message is passed to the
+ appender's doAppend() function,
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>
+ if 'willLogToParent' is true for the category, the message is passed
+ to the category's parent.
+ </para>
+
+ <para>
+ By default, all categories except root have no appender and
+ 'willLogToParent' is true. This situation causes all messages to be
+ logged by the root category's appender.
+ </para>
+
+ <para>
+ Typically, you would only change the root category's appender when you
+ wanted, say, a different output format. Copying defaultLogAppender.c
+ would be a good start.
+ </para>
+
+ <para>
+ The default appender function currently prints to stderr, but more
+ would be needed, like the one able to send the logs to a remote
+ dedicated server.
+ </para>
+ </listitem>
+ </itemizedlist>
+</refsect2>
+
+<refsect2>
+ <title>Misc and Caveats</title>
+
+ <para>
+ Do not use any of the macros that start with '_'.
+ </para>
+
+ <para>
+ The current set of macros force each file to use categories declared in
+ that file. This is intentional. Make the category a child of the file's
+ module category.
+ </para>
+
+ <para>
+ Log4J has a 'rolling file appender' which you can select with a run-time
+ option and specify the max file size. This would be a nice default for
+ non-kernel applications.
+ </para>
+
+ <para>
+ Careful, category names are global variables.
+ </para>
+</refsect2>
+
+
+<!-- ##### SECTION ./tmpl/tbx_log.sgml:See_Also ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### SECTION ./tmpl/tbx_log.sgml:Short_Description ##### -->
+An easy-to-use, fast and flexible message logging architecture.
+
+
+<!-- ##### SECTION ./tmpl/tbx_log.sgml:Title ##### -->
+Logging facilities
+
+
+<!-- ##### SECTION ./tmpl/tbx_set.sgml:Long_Description ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### SECTION ./tmpl/tbx_set.sgml:See_Also ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### SECTION ./tmpl/tbx_set.sgml:Short_Description ##### -->
+Data storage for very quick retrieve
+
+
+<!-- ##### SECTION ./tmpl/tbx_set.sgml:Title ##### -->
+Data set
+
+
+<!-- ##### SECTION ./tmpl/trp_socks.sgml:Long_Description ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### SECTION ./tmpl/trp_socks.sgml:See_Also ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### SECTION ./tmpl/trp_socks.sgml:Short_Description ##### -->
+
+
+
+<!-- ##### SECTION ./tmpl/trp_socks.sgml:Title ##### -->
+Sockets
+
+
+<!-- ##### SECTION ./tmpl/xbt_cfg.sgml:Long_Description ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### SECTION ./tmpl/xbt_cfg.sgml:See_Also ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### SECTION ./tmpl/xbt_cfg.sgml:Short_Description ##### -->
+
+
+
+<!-- ##### SECTION ./tmpl/xbt_cfg.sgml:Title ##### -->
+xbt_cfg
+
+
+<!-- ##### SECTION ./tmpl/xbt_dico.sgml:Long_Description ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### SECTION ./tmpl/xbt_dico.sgml:See_Also ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### SECTION ./tmpl/xbt_dico.sgml:Short_Description ##### -->
+
+
+
+<!-- ##### SECTION ./tmpl/xbt_dico.sgml:Title ##### -->
+xbt_dico
+
+
+<!-- ##### SECTION ./tmpl/xbt_err.sgml:Long_Description ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### SECTION ./tmpl/xbt_err.sgml:See_Also ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### SECTION ./tmpl/xbt_err.sgml:Short_Description ##### -->
+
+
+
+<!-- ##### SECTION ./tmpl/xbt_err.sgml:Title ##### -->
+Errors
+
+
+<!-- ##### SECTION ./tmpl/xbt_swag.sgml.sgml.sgml.sgml.sgml.sgml.sgml.sgml.sgml:Long_Description ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### SECTION ./tmpl/xbt_swag.sgml.sgml.sgml.sgml.sgml.sgml.sgml.sgml.sgml:See_Also ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### SECTION ./tmpl/xbt_swag.sgml.sgml.sgml.sgml.sgml.sgml.sgml.sgml.sgml:Short_Description ##### -->
+
+
+
+<!-- ##### SECTION ./tmpl/xbt_swag.sgml.sgml.sgml.sgml.sgml.sgml.sgml.sgml.sgml:Title ##### -->
+xbt_swag.sgml.sgml.sgml.sgml.sgml.sgml.sgml.sgml
+
+
+<!-- ##### SECTION ./tmpl/xbt_swag.sgml.sgml.sgml.sgml.sgml.sgml.sgml.sgml:Long_Description ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### SECTION ./tmpl/xbt_swag.sgml.sgml.sgml.sgml.sgml.sgml.sgml.sgml:See_Also ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### SECTION ./tmpl/xbt_swag.sgml.sgml.sgml.sgml.sgml.sgml.sgml.sgml:Short_Description ##### -->
+
+
+
+<!-- ##### SECTION ./tmpl/xbt_swag.sgml.sgml.sgml.sgml.sgml.sgml.sgml.sgml:Title ##### -->
+xbt_swag.sgml.sgml.sgml.sgml.sgml.sgml.sgml
+
+
+<!-- ##### SECTION ./tmpl/xbt_swag.sgml.sgml.sgml.sgml.sgml.sgml.sgml:Long_Description ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### SECTION ./tmpl/xbt_swag.sgml.sgml.sgml.sgml.sgml.sgml.sgml:See_Also ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### SECTION ./tmpl/xbt_swag.sgml.sgml.sgml.sgml.sgml.sgml.sgml:Short_Description ##### -->
+
+
+
+<!-- ##### SECTION ./tmpl/xbt_swag.sgml.sgml.sgml.sgml.sgml.sgml.sgml:Title ##### -->
+xbt_swag.sgml.sgml.sgml.sgml.sgml.sgml
+
+
+<!-- ##### SECTION ./tmpl/xbt_swag.sgml.sgml.sgml.sgml.sgml.sgml:Long_Description ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### SECTION ./tmpl/xbt_swag.sgml.sgml.sgml.sgml.sgml.sgml:See_Also ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### SECTION ./tmpl/xbt_swag.sgml.sgml.sgml.sgml.sgml.sgml:Short_Description ##### -->
+
+
+
+<!-- ##### SECTION ./tmpl/xbt_swag.sgml.sgml.sgml.sgml.sgml.sgml:Title ##### -->
+xbt_swag.sgml.sgml.sgml.sgml.sgml
+
+
+<!-- ##### SECTION ./tmpl/xbt_swag.sgml.sgml.sgml.sgml.sgml:Long_Description ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### SECTION ./tmpl/xbt_swag.sgml.sgml.sgml.sgml.sgml:See_Also ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### SECTION ./tmpl/xbt_swag.sgml.sgml.sgml.sgml.sgml:Short_Description ##### -->
+
+
+
+<!-- ##### SECTION ./tmpl/xbt_swag.sgml.sgml.sgml.sgml.sgml:Title ##### -->
+xbt_swag.sgml.sgml.sgml.sgml
+
+
+<!-- ##### SECTION ./tmpl/xbt_swag.sgml.sgml.sgml.sgml:Long_Description ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### SECTION ./tmpl/xbt_swag.sgml.sgml.sgml.sgml:See_Also ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### SECTION ./tmpl/xbt_swag.sgml.sgml.sgml.sgml:Short_Description ##### -->
+
+
+
+<!-- ##### SECTION ./tmpl/xbt_swag.sgml.sgml.sgml.sgml:Title ##### -->
+xbt_swag.sgml.sgml.sgml
+
+
+<!-- ##### SECTION ./tmpl/xbt_swag.sgml.sgml.sgml:Long_Description ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### SECTION ./tmpl/xbt_swag.sgml.sgml.sgml:See_Also ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### SECTION ./tmpl/xbt_swag.sgml.sgml.sgml:Short_Description ##### -->
+
+
+
+<!-- ##### SECTION ./tmpl/xbt_swag.sgml.sgml.sgml:Title ##### -->
+xbt_swag.sgml.sgml
+
+
+<!-- ##### SECTION ./tmpl/xbt_swag.sgml.sgml:Long_Description ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### SECTION ./tmpl/xbt_swag.sgml.sgml:See_Also ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### SECTION ./tmpl/xbt_swag.sgml.sgml:Short_Description ##### -->
+
+
+
+<!-- ##### SECTION ./tmpl/xbt_swag.sgml.sgml:Title ##### -->
+xbt_swag.sgml
+
+
+<!-- ##### MACRO BEGIN_DECL ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### MACRO CCRITICAL0 ##### -->
+<para>
+
+</para>
+
+@c:
+@f:
+
+<!-- ##### MACRO CCRITICAL1 ##### -->
+<para>
+
+</para>
+
+@c:
+@f:
+@a1:
+
+<!-- ##### MACRO CCRITICAL2 ##### -->
+<para>
+
+</para>
+
+@c:
+@f:
+@a1:
+@a2:
+
+<!-- ##### MACRO CCRITICAL3 ##### -->
+<para>
+
+</para>
+
+@c:
+@f:
+@a1:
+@a2:
+@a3:
+
+<!-- ##### MACRO CCRITICAL4 ##### -->
+<para>
+
+</para>
+
+@c:
+@f:
+@a1:
+@a2:
+@a3:
+@a4:
+
+<!-- ##### MACRO CCRITICAL5 ##### -->
+<para>
+
+</para>
+
+@c:
+@f:
+@a1:
+@a2:
+@a3:
+@a4:
+@a5:
+
+<!-- ##### MACRO CDEBUG0 ##### -->
+<para>
+
+</para>
+
+@c:
+@f:
+
+<!-- ##### MACRO CDEBUG1 ##### -->
+<para>
+
+</para>
+
+@c:
+@f:
+@a1:
+
+<!-- ##### MACRO CDEBUG2 ##### -->
+<para>
+
+</para>
+
+@c:
+@f:
+@a1:
+@a2:
+
+<!-- ##### MACRO CDEBUG3 ##### -->
+<para>
+
+</para>
+
+@c:
+@f:
+@a1:
+@a2:
+@a3:
+
+<!-- ##### MACRO CDEBUG4 ##### -->
+<para>
+
+</para>
+
+@c:
+@f:
+@a1:
+@a2:
+@a3:
+@a4:
+
+<!-- ##### MACRO CDEBUG5 ##### -->
+<para>
+
+</para>
+
+@c:
+@f:
+@a1:
+@a2:
+@a3:
+@a4:
+@a5:
+
+<!-- ##### MACRO CERROR0 ##### -->
+<para>
+
+</para>
+
+@c:
+@f:
+
+<!-- ##### MACRO CERROR1 ##### -->
+<para>
+
+</para>
+
+@c:
+@f:
+@a1:
+
+<!-- ##### MACRO CERROR2 ##### -->
+<para>
+
+</para>
+
+@c:
+@f:
+@a1:
+@a2:
+
+<!-- ##### MACRO CERROR3 ##### -->
+<para>
+
+</para>
+
+@c:
+@f:
+@a1:
+@a2:
+@a3:
+
+<!-- ##### MACRO CERROR4 ##### -->
+<para>
+
+</para>
+
+@c:
+@f:
+@a1:
+@a2:
+@a3:
+@a4:
+
+<!-- ##### MACRO CERROR5 ##### -->
+<para>
+
+</para>
+
+@c:
+@f:
+@a1:
+@a2:
+@a3:
+@a4:
+@a5:
+
+<!-- ##### MACRO CINFO0 ##### -->
+<para>
+
+</para>
+
+@c:
+@f:
+
+<!-- ##### MACRO CINFO1 ##### -->
+<para>
+
+</para>
+
+@c:
+@f:
+@a1:
+
+<!-- ##### MACRO CINFO2 ##### -->
+<para>
+
+</para>
+
+@c:
+@f:
+@a1:
+@a2:
+
+<!-- ##### MACRO CINFO3 ##### -->
+<para>
+
+</para>
+
+@c:
+@f:
+@a1:
+@a2:
+@a3:
+
+<!-- ##### MACRO CINFO4 ##### -->
+<para>
+
+</para>
+
+@c:
+@f:
+@a1:
+@a2:
+@a3:
+@a4:
+
+<!-- ##### MACRO CINFO5 ##### -->
+<para>
+
+</para>
+
+@c:
+@f:
+@a1:
+@a2:
+@a3:
+@a4:
+@a5:
+
+<!-- ##### MACRO CLOG0 ##### -->
+<para>
+
+</para>
+
+@c:
+@p:
+@f:
+
+<!-- ##### MACRO CLOG1 ##### -->
+<para>
+
+</para>
+
+@c:
+@p:
+@f:
+@a1:
+
+<!-- ##### MACRO CLOG2 ##### -->
+<para>
+
+</para>
+
+@c:
+@p:
+@f:
+@a1:
+@a2:
+
+<!-- ##### MACRO CLOG3 ##### -->
+<para>
+
+</para>
+
+@c:
+@p:
+@f:
+@a1:
+@a2:
+@a3:
+
+<!-- ##### MACRO CLOG4 ##### -->
+<para>
+
+</para>
+
+@c:
+@p:
+@f:
+@a1:
+@a2:
+@a3:
+@a4:
+
+<!-- ##### MACRO CLOG5 ##### -->
+<para>
+
+</para>
+
+@c:
+@p:
+@f:
+@a1:
+@a2:
+@a3:
+@a4:
+@a5:
+
+<!-- ##### MACRO CLOG6 ##### -->
+<para>
+
+</para>
+
+@c:
+@p:
+@f:
+@a1:
+@a2:
+@a3:
+@a4:
+@a5:
+@a6:
+
+<!-- ##### MACRO CRITICAL0 ##### -->
+<para>
+
+</para>
+
+@f:
+
+<!-- ##### MACRO CRITICAL1 ##### -->
+<para>
+
+</para>
+
+@f:
+@a1:
+
+<!-- ##### MACRO CRITICAL2 ##### -->
+<para>
+
+</para>
+
+@f:
+@a1:
+@a2:
+
+<!-- ##### MACRO CRITICAL3 ##### -->
+<para>
+
+</para>
+
+@f:
+@a1:
+@a2:
+@a3:
+
+<!-- ##### MACRO CRITICAL4 ##### -->
+<para>
+
+</para>
+
+@f:
+@a1:
+@a2:
+@a3:
+@a4:
+
+<!-- ##### MACRO CRITICAL5 ##### -->
+<para>
+
+</para>
+
+@f:
+@a1:
+@a2:
+@a3:
+@a4:
+@a5:
+
+<!-- ##### MACRO CWARNING6 ##### -->
<para>
</para>
@a2:
@a3:
@a4:
+@a5:
+@a6:
+
+<!-- ##### FUNCTION CallAddr ##### -->
+<para>
+
+</para>
+
+@addr:
+@Param2:
+@sock:
+@timeOut:
+@Returns:
+
+<!-- ##### FUNCTION CloseSocket ##### -->
+<para>
+
+</para>
+
+@sock:
+@waitForPeer:
+@Returns:
+
+<!-- ##### FUNCTION ConvertData ##### -->
+<para>
+
+</para>
+
+@destination:
+@source:
+@description:
+@length:
+@sourceFormat:
+
+<!-- ##### FUNCTION CreateLocalChild ##### -->
+<para>
+
+</para>
+
+@pid:
+@parentToChild:
+@childToParent:
+@Returns:
+
+<!-- ##### FUNCTION DROP_SOCKET ##### -->
+<para>
+
+</para>
+
+@sock:
+@Returns:
+
+<!-- ##### FUNCTION DataSize ##### -->
+<para>
+
+</para>
+
+@description:
+@length:
+@format:
+@Returns:
+
+<!-- ##### ENUM DataTypes ##### -->
+<para>
+
+</para>
+
+@CHAR_TYPE:
+@DOUBLE_TYPE:
+@FLOAT_TYPE:
+@INT_TYPE:
+@LONG_TYPE:
+@SHORT_TYPE:
+@UNSIGNED_INT_TYPE:
+@UNSIGNED_LONG_TYPE:
+@UNSIGNED_SHORT_TYPE:
+@STRUCT_TYPE:
+@LAST_TYPE:
+
+<!-- ##### FUNCTION DifferentFormat ##### -->
+<para>
+
+</para>
+
+@whatType:
+@Returns:
+
+<!-- ##### FUNCTION DifferentOrder ##### -->
+<para>
+
+</para>
+
+@Returns:
+
+<!-- ##### FUNCTION DifferentSize ##### -->
+<para>
+
+</para>
+
+@whatType:
+@Returns:
+
+<!-- ##### MACRO END_DECL ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### MACRO EODD ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### FUNCTION EstablishAnEar ##### -->
+<para>
+
+</para>
+
+@Param1:
+@Param2:
+@ear:
+@earPort:
+@Returns:
+
+<!-- ##### ENUM FormatTypes ##### -->
+<para>
+
+</para>
+
+@HOST_FORMAT:
+@NETWORK_FORMAT:
+
+<!-- ##### MACRO GRAS_LOG_DEFAULT_CATEGORY ##### -->
+<para>
+
+</para>
+
+@cname:
+
+<!-- ##### MACRO GRAS_LOG_EXTERNAL_CATEGORY ##### -->
+<para>
+
+</para>
+
+@cname:
+
+<!-- ##### MACRO GRAS_LOG_ISENABLED ##### -->
+<para>
+
+</para>
+
+@catName:
+@priority:
+
+<!-- ##### MACRO GRAS_LOG_MAYDAY ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### MACRO GRAS_LOG_NEW_CATEGORY ##### -->
+<para>
+
+</para>
+
+@catName:
+@desc:
+
+<!-- ##### MACRO GRAS_LOG_NEW_DEFAULT_CATEGORY ##### -->
+<para>
+
+</para>
+
+@cname:
+@desc:
+
+<!-- ##### MACRO GRAS_LOG_NEW_DEFAULT_SUBCATEGORY ##### -->
+<para>
+
+</para>
+
+@cname:
+@parent:
+@desc:
+
+<!-- ##### MACRO GRAS_LOG_NEW_SUBCATEGORY ##### -->
+<para>
+
+</para>
+
+@catName:
+@parent:
+@desc:
+
+<!-- ##### MACRO GRAS_LOG_ROOT_CAT ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### MACRO GRAS_LOG_STATIC_THRESHOLD ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### MACRO HAVE_DLFCN_H ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### MACRO HAVE_INTTYPES_H ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### MACRO HAVE_LIBPTHREAD ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### MACRO HAVE_MEMORY_H ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### MACRO HAVE_STDINT_H ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### MACRO HAVE_STDLIB_H ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### MACRO HAVE_STRINGS_H ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### MACRO HAVE_STRING_H ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### MACRO HAVE_SYS_STAT_H ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### MACRO HAVE_SYS_TYPES_H ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### MACRO HAVE_UNISTD_H ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### FUNCTION HomogenousConvertData ##### -->
+<para>
+
+</para>
+
+@destination:
+@source:
+@whatType:
+@repetitions:
+@sourceFormat:
+
+<!-- ##### FUNCTION HomogenousDataSize ##### -->
+<para>
+
+</para>
+
+@whatType:
+@repetitions:
+@format:
+@Returns:
+
+<!-- ##### TYPEDEF IPAddress ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### FUNCTION IPAddressImage ##### -->
+<para>
+
+</para>
+
+@addr:
+@Returns:
+
+<!-- ##### FUNCTION IPAddressImage_r ##### -->
+<para>
+
+</para>
+
+@addr:
+@Returns:
+
+<!-- ##### FUNCTION IPAddressMachine ##### -->
+<para>
+
+</para>
+
+@addr:
+@Returns:
+
+<!-- ##### FUNCTION IPAddressMachine_r ##### -->
+<para>
+
+</para>
+
+@addr:
+@Returns:
+
+<!-- ##### MACRO IPAddressValue ##### -->
+<para>
+
+</para>
+
+@machineOrAddress:
+@address:
+
+<!-- ##### FUNCTION IPAddressValues ##### -->
+<para>
+
+</para>
+
+@machineOrAddress:
+@addressList:
+@atMost:
+@Returns:
+
+<!-- ##### FUNCTION IncomingRequest ##### -->
+<para>
+
+</para>
+
+@timeOut:
+@sd:
+@ldap:
+@Returns:
+
+<!-- ##### FUNCTION IsOkay ##### -->
+<para>
+
+</para>
+
+@sd:
+@Returns:
+
+<!-- ##### FUNCTION IsPipe ##### -->
+<para>
+
+</para>
+
+@sd:
+@Returns:
+
+<!-- ##### MACRO IsValidIP ##### -->
+<para>
+
+</para>
+
+@machineOrAddress:
+
+<!-- ##### MACRO LOG6 ##### -->
+<para>
+
+</para>
+
+@p:
+@f:
+@a1:
+@a2:
+@a3:
+@a4:
+@a5:
+@a6:
+
+<!-- ##### FUNCTION MyMachineName ##### -->
+<para>
+
+</para>
+
+@Returns:
+
+<!-- ##### MACRO NO_SOCKET ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### FUNCTION NotifyOnDisconnection ##### -->
+<para>
+
+</para>
+
+@notifyFn:
+
+<!-- ##### FUNCTION OpenClientSocket ##### -->
+<para>
+
+</para>
+
+@addr:
+@Param2:
+@sock:
+@Returns:
+
+<!-- ##### FUNCTION OpenServerSocket ##### -->
+<para>
+
+</para>
+
+@Param1:
+@Param2:
+@ear:
+@earPort:
+@Returns:
+
+<!-- ##### MACRO PACKAGE ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### MACRO PACKAGE_BUGREPORT ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### MACRO PACKAGE_NAME ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### MACRO PACKAGE_STRING ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### MACRO PACKAGE_TARNAME ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### MACRO PACKAGE_VERSION ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### MACRO PAD_BYTES ##### -->
+<para>
+
+</para>
+
+@structType:
+@lastMember:
+@memberType:
+@repetitions:
+
+<!-- ##### FUNCTION PassSocket ##### -->
+<para>
+
+</para>
+
+@sock:
+@child:
+@Returns:
+
+<!-- ##### FUNCTION Peer ##### -->
+<para>
+
+</para>
+
+@sd:
+@Returns:
+
+<!-- ##### FUNCTION PeerName ##### -->
+<para>
+
+</para>
+
+@sd:
+@Returns:
+
+<!-- ##### FUNCTION PeerName_r ##### -->
+<para>
+
+</para>
+
+@sd:
+@Returns:
+
+<!-- ##### FUNCTION ReverseData ##### -->
+<para>
+
+</para>
+
+@destination:
+@source:
+@whatType:
+@repetitions:
+@format:
+
+<!-- ##### MACRO SIMPLE_DATA ##### -->
+<para>
+
+</para>
+
+@type:
+@repetitions:
+
+<!-- ##### MACRO SIMPLE_MEMBER ##### -->
+<para>
+
+</para>
+
+@type:
+@repetitions:
+@offset:
+
+<!-- ##### MACRO SIMPLE_TYPE_COUNT ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### MACRO STDC_HEADERS ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### TYPEDEF Socket ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### FUNCTION SocketFailure ##### -->
+<para>
+
+</para>
+
+@sig:
+
+<!-- ##### USER_FUNCTION SocketFunction ##### -->
+<para>
+
+</para>
+
+@Param1:
+
+<!-- ##### FUNCTION SocketInUse ##### -->
+<para>
+
+</para>
+
+@sd:
+@Returns:
+
+<!-- ##### FUNCTION SocketIsAvailable ##### -->
+<para>
+
+</para>
+
+@sd:
+@Returns:
+
+<!-- ##### MACRO VERSION ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### MACRO WARNING6 ##### -->
+<para>
+
+</para>
+
+@f:
+@a1:
+@a2:
+@a3:
+@a4:
+@a5:
+@a6:
+
+<!-- ##### USER_FUNCTION grasCallbackFunction ##### -->
+<para>
+
+</para>
+
+@sd:
+@msgType:
+@vdata:
+
+<!-- ##### FUNCTION grasCloseSocket ##### -->
+<para>
+
+</para>
+
+@sock:
+@Returns:
+
+<!-- ##### FUNCTION grasDataDescCmp ##### -->
+<para>
+
+</para>
+
+@dd1:
+@c1:
+@dd2:
+@c2:
+@Returns:
+@description:
+
+<!-- ##### FUNCTION grasDataDescCount ##### -->
+<para>
+
+</para>
+
+@description:
+@Returns:
+
+<!-- ##### FUNCTION grasDataRecv ##### -->
+<para>
+
+</para>
+
+@sd:
+@data:
+@description:
+@description_length:
+@repetition:
+@Returns:
+
+<!-- ##### FUNCTION grasDataSend ##### -->
+<para>
+
+</para>
+
+@sd:
+@data:
+@description:
+@description_length:
+@repetition:
+@Returns:
+
+<!-- ##### FUNCTION grasDataSize ##### -->
+<para>
+
+</para>
+
+@description:
+@ft:
+@Returns:
+
+<!-- ##### ENUM grasError_t ##### -->
+<para>
+
+</para>
+
+@no_error:
+@malloc_error:
+@mismatch_error:
+@sanity_error:
+@system_error:
+@network_error:
+@timeout_error:
+@thread_error:
+@unknown_error:
+
+<!-- ##### FUNCTION grasLock ##### -->
+<para>
+
+</para>
+
+@Returns:
+
+<!-- ##### TYPEDEF grasMessageType_t ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### FUNCTION grasMsgDiscard ##### -->
+<para>
+
+</para>
+
+@sd:
+@size:
+
+<!-- ##### FUNCTION grasMsgEntryGet ##### -->
+<para>
+
+</para>
+
+@id:
+@Returns:
+
+<!-- ##### TYPEDEF grasMsgEntry_t ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### FUNCTION grasMsgFree ##### -->
+<para>
+
+</para>
+
+@msg:
+
+<!-- ##### FUNCTION grasMsgHandle ##### -->
+<para>
+
+</para>
+
+@timeOut:
+
+<!-- ##### FUNCTION grasMsgHeaderNew ##### -->
+<para>
+
+</para>
+
+@msgId:
+@dataSize:
+@seqCount:
+@Returns:
+
+<!-- ##### FUNCTION grasMsgNew ##### -->
+<para>
+
+</para>
+
+@msgId:
+@free_data_on_free:
+@seqCount:
+@Varargs:
+@Returns:
+
+<!-- ##### FUNCTION grasMsgRecv ##### -->
+<para>
+
+</para>
+
+@msg:
+@timeout:
+@Returns:
+@sd:
+
+<!-- ##### FUNCTION grasMsgRegister ##### -->
+<para>
+
+</para>
+
+@message:
+@name:
+@sequence_count:
+@Varargs:
+@Returns:
+
+<!-- ##### FUNCTION grasMsgSend ##### -->
+<para>
+
+</para>
+
+@sd:
+@message:
+@sequence_count:
+@Varargs:
+@Returns:
+
+<!-- ##### FUNCTION grasMsgWait ##### -->
+<para>
+
+</para>
+
+@sd:
+@timeout:
+@message:
+@sequence_count:
+@Varargs:
+@Returns:
+
+<!-- ##### FUNCTION grasMyMachineName ##### -->
+<para>
+
+</para>
+
+@Returns:
+
+<!-- ##### FUNCTION grasOpenClientSocket ##### -->
+<para>
+
+</para>
+
+@host:
+@Param2:
+@sock:
+@Returns:
+
+<!-- ##### FUNCTION grasOpenServerSocket ##### -->
+<para>
+
+</para>
+
+@Param1:
+@Param2:
+@sock:
+@Returns:
+
+<!-- ##### MACRO grasPROTOCOL ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### FUNCTION grasPeerGetAddress ##### -->
+<para>
+
+</para>
+
+@sd:
+@Returns:
+
+<!-- ##### FUNCTION grasPeerGetName ##### -->
+<para>
+
+</para>
+
+@sd:
+@Returns:
+
+<!-- ##### FUNCTION grasRecvData ##### -->
+<para>
+
+</para>
+
+@sd:
+@data:
+@description:
+@Returns:
+
+<!-- ##### FUNCTION grasRegisterCallback ##### -->
+<para>
+
+</para>
+
+@message:
+@TTL:
+@cb:
+
+<!-- ##### FUNCTION grasSendData ##### -->
+<para>
-<!-- ##### MACRO CINFO5 ##### -->
+</para>
+
+@sd:
+@data:
+@description:
+@Returns:
+
+<!-- ##### FUNCTION grasUnlock ##### -->
<para>
</para>
-@c:
-@f:
-@a1:
-@a2:
-@a3:
-@a4:
-@a5:
+@Returns:
-<!-- ##### MACRO CLOG0 ##### -->
+<!-- ##### FUNCTION grasUserdataGet ##### -->
<para>
</para>
-@c:
-@p:
-@f:
-<!-- ##### MACRO CLOG1 ##### -->
+<!-- ##### MACRO grasUserdataNew ##### -->
<para>
</para>
-@c:
-@p:
-@f:
-@a1:
+@type:
-<!-- ##### MACRO CLOG2 ##### -->
+<!-- ##### FUNCTION grasUserdataSet ##### -->
<para>
</para>
-@c:
-@p:
-@f:
-@a1:
-@a2:
+@ud:
-<!-- ##### MACRO CLOG3 ##### -->
+<!-- ##### FUNCTION gras_cfg_check ##### -->
+<para>
+
+</para>
+
+@cfg:
+@Returns:
+
+<!-- ##### FUNCTION gras_cfg_cpy ##### -->
+<para>
+
+</para>
+
+@tocopy:
+@whereto:
+@Returns:
+
+<!-- ##### FUNCTION gras_cfg_dump ##### -->
+<para>
+
+</para>
+
+@name:
+@indent:
+@cfg:
+
+<!-- ##### FUNCTION gras_cfg_empty ##### -->
+<para>
+
+</para>
+
+@cfg:
+@name:
+@Returns:
+
+<!-- ##### FUNCTION gras_cfg_free ##### -->
+<para>
+
+</para>
+
+@cfg:
+
+<!-- ##### FUNCTION gras_cfg_get_double ##### -->
+<para>
+
+</para>
+
+@cfg:
+@name:
+@val:
+@Returns:
+
+<!-- ##### FUNCTION gras_cfg_get_dynar ##### -->
+<para>
+
+</para>
+
+@cfg:
+@name:
+@dynar:
+@Returns:
+
+<!-- ##### FUNCTION gras_cfg_get_host ##### -->
+<para>
+
+</para>
+
+@cfg:
+@name:
+@host:
+@port:
+@Returns:
+
+<!-- ##### FUNCTION gras_cfg_get_int ##### -->
+<para>
+
+</para>
+
+@cfg:
+@name:
+@val:
+@Returns:
+
+<!-- ##### FUNCTION gras_cfg_get_string ##### -->
+<para>
+
+</para>
+
+@cfg:
+@name:
+@val:
+@Returns:
+
+<!-- ##### FUNCTION gras_cfg_new ##### -->
+<para>
+
+</para>
+
+@Returns:
+@whereto:
+
+<!-- ##### FUNCTION gras_cfg_register ##### -->
+<para>
+
+</para>
+
+@cfg:
+@name:
+@type:
+@min:
+@max:
+@Returns:
+
+<!-- ##### FUNCTION gras_cfg_register_str ##### -->
+<para>
+
+</para>
+
+@cfg:
+@entry:
+@Returns:
+
+<!-- ##### FUNCTION gras_cfg_rm_double ##### -->
+<para>
+
+</para>
+
+@cfg:
+@name:
+@val:
+@Returns:
+
+<!-- ##### FUNCTION gras_cfg_rm_host ##### -->
+<para>
+
+</para>
+
+@cfg:
+@name:
+@host:
+@port:
+@Returns:
+
+<!-- ##### FUNCTION gras_cfg_rm_int ##### -->
+<para>
+
+</para>
+
+@cfg:
+@name:
+@val:
+@Returns:
+
+<!-- ##### FUNCTION gras_cfg_rm_string ##### -->
+<para>
+
+</para>
+
+@cfg:
+@name:
+@val:
+@Returns:
+
+<!-- ##### FUNCTION gras_cfg_set ##### -->
+<para>
+
+</para>
+
+@cfg:
+@Varargs:
+@Returns:
+
+<!-- ##### FUNCTION gras_cfg_set_double ##### -->
+<para>
+
+</para>
+
+@cfg:
+@name:
+@val:
+@Returns:
+
+<!-- ##### FUNCTION gras_cfg_set_host ##### -->
+<para>
+
+</para>
+
+@cfg:
+@name:
+@host:
+@port:
+@Returns:
+
+<!-- ##### FUNCTION gras_cfg_set_int ##### -->
+<para>
+
+</para>
+
+@cfg:
+@name:
+@val:
+@Returns:
+
+<!-- ##### FUNCTION gras_cfg_set_parse ##### -->
+<para>
+
+</para>
+
+@cfg:
+@options:
+@Returns:
+
+<!-- ##### FUNCTION gras_cfg_set_string ##### -->
+<para>
+
+</para>
+
+@cfg:
+@name:
+@val:
+@Returns:
+
+<!-- ##### FUNCTION gras_cfg_set_vargs ##### -->
+<para>
+
+</para>
+
+@cfg:
+@pa:
+@Returns:
+
+<!-- ##### FUNCTION gras_datadesc_cb_set_post ##### -->
+<para>
+
+</para>
+
+@type:
+@post:
+
+<!-- ##### FUNCTION gras_datadesc_cb_set_pre ##### -->
+<para>
+
+</para>
+
+@type:
+@pre:
+
+<!-- ##### FUNCTION gras_datadesc_cmp ##### -->
+<para>
+
+</para>
+
+@d1:
+@d2:
+@Returns:
+@dd1:
+@c1:
+@dd2:
+@c2:
+
+<!-- ##### FUNCTION gras_datadesc_copy_data ##### -->
<para>
</para>
+@dd:
@c:
-@p:
-@f:
-@a1:
-@a2:
-@a3:
+@data:
+
+<!-- ##### MACRO gras_datadesc_declare_array ##### -->
+<para>
+
+</para>
+
+@name:
+@elm_type:
+@size:
+@code:
+
+<!-- ##### FUNCTION gras_datadesc_declare_array_cb ##### -->
+<para>
+
+</para>
+
+@name:
+@element_type:
+@fixed_size:
+@dynamic_size:
+@post:
+@code:
+@Returns:
+
+<!-- ##### FUNCTION gras_datadesc_declare_array_dyn ##### -->
+<para>
+
+</para>
+
+@name:
+@element_type:
+@dynamic_size:
+@dst:
+@Returns:
+@elm_type:
+@code:
-<!-- ##### MACRO CLOG4 ##### -->
+<!-- ##### FUNCTION gras_datadesc_declare_array_fixed ##### -->
<para>
</para>
-@c:
-@p:
-@f:
-@a1:
-@a2:
-@a3:
-@a4:
+@name:
+@element_type:
+@fixed_size:
+@dst:
+@Returns:
-<!-- ##### MACRO CLOG5 ##### -->
+<!-- ##### FUNCTION gras_datadesc_declare_ref ##### -->
<para>
</para>
-@c:
-@p:
-@f:
-@a1:
-@a2:
-@a3:
-@a4:
-@a5:
+@name:
+@referenced_type:
+@dst:
+@Returns:
+@ref_type:
+@code:
-<!-- ##### MACRO CLOG6 ##### -->
+<!-- ##### FUNCTION gras_datadesc_declare_ref_cb ##### -->
<para>
</para>
-@c:
-@p:
-@f:
-@a1:
-@a2:
-@a3:
-@a4:
-@a5:
-@a6:
+@name:
+@referenced_type:
+@discriminant:
+@post:
+@code:
+@Returns:
-<!-- ##### MACRO CRITICAL0 ##### -->
+<!-- ##### MACRO gras_datadesc_declare_ref_disc ##### -->
<para>
</para>
-@f:
+@name:
+@discriminant:
+@code:
-<!-- ##### MACRO CRITICAL1 ##### -->
+<!-- ##### FUNCTION gras_datadesc_declare_ref_generic ##### -->
<para>
</para>
-@f:
-@a1:
+@name:
+@discriminant:
+@dst:
+@Returns:
-<!-- ##### MACRO CRITICAL2 ##### -->
+<!-- ##### FUNCTION gras_datadesc_declare_struct ##### -->
<para>
</para>
-@f:
-@a1:
-@a2:
+@name:
+@dst:
+@Returns:
+@code:
-<!-- ##### MACRO CRITICAL3 ##### -->
+<!-- ##### MACRO gras_datadesc_declare_struct_add_code ##### -->
<para>
</para>
-@f:
-@a1:
-@a2:
-@a3:
+@struct_code:
+@field_name:
+@field_type_code:
-<!-- ##### MACRO CRITICAL4 ##### -->
+<!-- ##### FUNCTION gras_datadesc_declare_struct_add_code_cb ##### -->
<para>
</para>
-@f:
-@a1:
-@a2:
-@a3:
-@a4:
+@struct_code:
+@field_name:
+@field_code:
+@pre_cb:
+@post_cb:
+@Returns:
-<!-- ##### MACRO CRITICAL5 ##### -->
+<!-- ##### MACRO gras_datadesc_declare_struct_add_name ##### -->
<para>
</para>
-@f:
-@a1:
-@a2:
-@a3:
-@a4:
-@a5:
+@struct_code:
+@field_name:
+@field_type_name:
-<!-- ##### FUNCTION CallAddr ##### -->
+<!-- ##### FUNCTION gras_datadesc_declare_struct_add_name_cb ##### -->
<para>
</para>
-@addr:
-@Param2:
-@sock:
-@timeOut:
+@struct_code:
+@field_name:
+@field_type_name:
+@pre_cb:
+@post_cb:
@Returns:
-<!-- ##### FUNCTION CloseSocket ##### -->
+<!-- ##### FUNCTION gras_datadesc_declare_struct_append ##### -->
<para>
</para>
-@sock:
-@waitForPeer:
+@struct_type:
+@name:
+@field_type:
@Returns:
-<!-- ##### FUNCTION CreateLocalChild ##### -->
+<!-- ##### FUNCTION gras_datadesc_declare_struct_append_name ##### -->
<para>
</para>
-@pid:
-@parentToChild:
-@childToParent:
+@struct_type:
+@name:
+@field_type_name:
@Returns:
-<!-- ##### FUNCTION DROP_SOCKET ##### -->
+<!-- ##### FUNCTION gras_datadesc_declare_struct_cb ##### -->
<para>
</para>
-@sock:
+@name:
+@pre_cb:
+@post_cb:
+@code:
@Returns:
-<!-- ##### FUNCTION DataSize ##### -->
+<!-- ##### FUNCTION gras_datadesc_declare_struct_close ##### -->
<para>
</para>
-@description:
-@length:
-@format:
-@Returns:
+@struct_type:
-<!-- ##### ENUM DataTypes ##### -->
+<!-- ##### FUNCTION gras_datadesc_declare_union ##### -->
<para>
</para>
-@CHAR_TYPE:
-@DOUBLE_TYPE:
-@FLOAT_TYPE:
-@INT_TYPE:
-@LONG_TYPE:
-@SHORT_TYPE:
-@UNSIGNED_INT_TYPE:
-@UNSIGNED_LONG_TYPE:
-@UNSIGNED_SHORT_TYPE:
-@STRUCT_TYPE:
-@LAST_TYPE:
+@name:
+@selector:
+@dst:
+@Returns:
+@code:
-<!-- ##### MACRO END_DECL ##### -->
+<!-- ##### MACRO gras_datadesc_declare_union_add_code ##### -->
<para>
</para>
+@union_code:
+@field_name:
+@field_type_code:
-<!-- ##### MACRO EODD ##### -->
+<!-- ##### FUNCTION gras_datadesc_declare_union_add_code_cb ##### -->
<para>
</para>
+@union_code:
+@field_name:
+@field_code:
+@pre_cb:
+@post_cb:
+@Returns:
-<!-- ##### FUNCTION EstablishAnEar ##### -->
+<!-- ##### MACRO gras_datadesc_declare_union_add_name ##### -->
<para>
</para>
-@Param1:
-@Param2:
-@ear:
-@earPort:
-@Returns:
+@union_code:
+@field_name:
+@field_type_name:
-<!-- ##### ENUM FormatTypes ##### -->
+<!-- ##### FUNCTION gras_datadesc_declare_union_add_name_cb ##### -->
<para>
</para>
-@HOST_FORMAT:
-@NETWORK_FORMAT:
+@union_code:
+@field_name:
+@field_type_name:
+@pre_cb:
+@post_cb:
+@Returns:
-<!-- ##### MACRO GRAS_LOG_MAYDAY ##### -->
+<!-- ##### FUNCTION gras_datadesc_declare_union_append ##### -->
<para>
</para>
+@union_type:
+@name:
+@field_type:
+@Returns:
-<!-- ##### MACRO GRAS_LOG_ROOT_CAT ##### -->
+<!-- ##### FUNCTION gras_datadesc_declare_union_append_name ##### -->
<para>
</para>
+@union_type:
+@name:
+@field_type_name:
+@Returns:
-<!-- ##### MACRO HAVE_DLFCN_H ##### -->
+<!-- ##### FUNCTION gras_datadesc_declare_union_cb ##### -->
<para>
</para>
+@name:
+@field_count:
+@post:
+@code:
+@Returns:
-<!-- ##### MACRO HAVE_INTTYPES_H ##### -->
+<!-- ##### FUNCTION gras_datadesc_declare_union_close ##### -->
<para>
</para>
+@union_type:
-<!-- ##### MACRO HAVE_LIBPTHREAD ##### -->
+<!-- ##### FUNCTION gras_datadesc_from_nws ##### -->
<para>
</para>
+@name:
+@desc:
+@howmany:
+@code:
+@Returns:
+@dst:
-<!-- ##### MACRO HAVE_MEMORY_H ##### -->
+<!-- ##### FUNCTION gras_datadesc_import_nws ##### -->
<para>
</para>
+@name:
+@desc:
+@howmany:
+@dst:
+@Returns:
-<!-- ##### MACRO HAVE_STDINT_H ##### -->
+<!-- ##### FUNCTION gras_datadesc_parse ##### -->
<para>
</para>
+@name:
+@Cdefinition:
+@dst:
+@Returns:
+@code:
+@def:
-<!-- ##### MACRO HAVE_STDLIB_H ##### -->
+<!-- ##### FUNCTION gras_dd_cbps_block_begin ##### -->
<para>
</para>
+@ps:
-<!-- ##### MACRO HAVE_STRINGS_H ##### -->
+<!-- ##### FUNCTION gras_dd_cbps_block_end ##### -->
<para>
</para>
+@ps:
-<!-- ##### MACRO HAVE_STRING_H ##### -->
+<!-- ##### FUNCTION gras_dd_cbps_get ##### -->
<para>
</para>
+@ps:
+@name:
+@ddt:
-<!-- ##### MACRO HAVE_SYS_STAT_H ##### -->
+<!-- ##### FUNCTION gras_dd_cbps_pop ##### -->
<para>
</para>
+@ps:
+@name:
+@ddt:
-<!-- ##### MACRO HAVE_SYS_TYPES_H ##### -->
+<!-- ##### FUNCTION gras_dd_cbps_push ##### -->
<para>
</para>
+@ps:
+@name:
+@data:
+@ddt:
-<!-- ##### MACRO HAVE_UNISTD_H ##### -->
+<!-- ##### FUNCTION gras_dd_cbps_set ##### -->
<para>
</para>
+@ps:
+@name:
+@data:
+@ddt:
-<!-- ##### TYPEDEF IPAddress ##### -->
+<!-- ##### FUNCTION gras_ddt_free ##### -->
<para>
</para>
+@type:
-<!-- ##### FUNCTION IPAddressImage ##### -->
+<!-- ##### FUNCTION gras_ddt_get_by_code ##### -->
<para>
</para>
-@addr:
+@code:
+@type:
@Returns:
-<!-- ##### FUNCTION IPAddressImage_r ##### -->
+<!-- ##### FUNCTION gras_ddt_get_by_name ##### -->
<para>
</para>
-@addr:
+@name:
+@type:
@Returns:
-<!-- ##### FUNCTION IPAddressMachine ##### -->
+<!-- ##### FUNCTION gras_ddt_new_array ##### -->
<para>
</para>
-@addr:
+@name:
+@element_type:
+@fixed_size:
+@dynamic_size:
+@post:
+@dst:
@Returns:
-<!-- ##### FUNCTION IPAddressMachine_r ##### -->
+<!-- ##### FUNCTION gras_ddt_new_from_nws ##### -->
<para>
</para>
-@addr:
+@name:
+@desc:
+@howmany:
+@dst:
@Returns:
-<!-- ##### MACRO IPAddressValue ##### -->
+<!-- ##### FUNCTION gras_ddt_new_ignored ##### -->
<para>
</para>
-@machineOrAddress:
-@address:
+@name:
+@default_value:
+@free_func:
+@size:
+@alignment:
+@post:
+@dst:
+@Returns:
-<!-- ##### FUNCTION IPAddressValues ##### -->
+<!-- ##### FUNCTION gras_ddt_new_parse ##### -->
<para>
</para>
-@machineOrAddress:
-@addressList:
-@atMost:
+@name:
+@C_definition:
+@dst:
@Returns:
-<!-- ##### FUNCTION IncomingRequest ##### -->
+<!-- ##### FUNCTION gras_ddt_new_ref ##### -->
<para>
</para>
-@timeOut:
-@sd:
-@ldap:
+@name:
+@referenced_type:
+@discriminant:
+@post:
+@dst:
@Returns:
-<!-- ##### FUNCTION IsOkay ##### -->
+<!-- ##### FUNCTION gras_ddt_new_scalar ##### -->
<para>
</para>
-@sd:
+@name:
+@type:
@Returns:
-<!-- ##### FUNCTION IsPipe ##### -->
+<!-- ##### FUNCTION gras_ddt_new_struct ##### -->
<para>
</para>
-@sd:
+@name:
+@pre:
+@post:
+@dst:
@Returns:
-<!-- ##### MACRO IsValidIP ##### -->
+<!-- ##### FUNCTION gras_ddt_new_struct_append ##### -->
<para>
</para>
-@machineOrAddress:
+@struct_type:
+@name:
+@field_type:
+@pre:
+@post:
+@Returns:
-<!-- ##### MACRO LOG6 ##### -->
+<!-- ##### FUNCTION gras_ddt_new_union ##### -->
<para>
</para>
-@p:
-@f:
-@a1:
-@a2:
-@a3:
-@a4:
-@a5:
-@a6:
+@name:
+@field_count:
+@post:
+@dst:
+@Returns:
-<!-- ##### FUNCTION MyMachineName ##### -->
+<!-- ##### FUNCTION gras_ddt_new_union_append ##### -->
<para>
</para>
+@union_type:
+@name:
+@field_type:
+@pre:
+@post:
@Returns:
-<!-- ##### MACRO NO_SOCKET ##### -->
+<!-- ##### FUNCTION gras_ddt_register ##### -->
<para>
</para>
+@type:
+@Returns:
-<!-- ##### FUNCTION NotifyOnDisconnection ##### -->
+<!-- ##### FUNCTION gras_dict_cursor_free ##### -->
<para>
</para>
-@notifyFn:
+@cursor:
+@Returns:
-<!-- ##### FUNCTION OpenClientSocket ##### -->
+<!-- ##### FUNCTION gras_dict_cursor_get_data ##### -->
<para>
</para>
-@addr:
-@Param2:
-@sock:
+@cursor:
+@data:
@Returns:
-<!-- ##### FUNCTION OpenServerSocket ##### -->
+<!-- ##### FUNCTION gras_dict_cursor_get_key ##### -->
<para>
</para>
-@Param1:
-@Param2:
-@ear:
-@earPort:
+@cursor:
+@key:
@Returns:
-<!-- ##### MACRO PACKAGE ##### -->
+<!-- ##### FUNCTION gras_dict_cursor_new ##### -->
<para>
</para>
+@head:
+@Returns:
+@cursor:
-<!-- ##### MACRO PACKAGE_BUGREPORT ##### -->
+<!-- ##### FUNCTION gras_dict_cursor_next ##### -->
<para>
</para>
+@cursor:
+@Returns:
-<!-- ##### MACRO PACKAGE_NAME ##### -->
+<!-- ##### FUNCTION gras_dict_cursor_rewind ##### -->
<para>
</para>
+@cursor:
+@Returns:
-<!-- ##### MACRO PACKAGE_STRING ##### -->
+<!-- ##### FUNCTION gras_dict_dump ##### -->
<para>
</para>
+@head:
+@output:
+@Returns:
-<!-- ##### MACRO PACKAGE_TARNAME ##### -->
+<!-- ##### MACRO gras_dict_foreach ##### -->
<para>
</para>
+@dict:
+@cursor:
+@key:
+@data:
-<!-- ##### MACRO PACKAGE_VERSION ##### -->
+<!-- ##### FUNCTION gras_dict_free ##### -->
<para>
</para>
+@dict:
+@Returns:
-<!-- ##### MACRO PAD_BYTES ##### -->
+<!-- ##### FUNCTION gras_dict_get ##### -->
<para>
</para>
-@structType:
-@lastMember:
-@memberType:
-@repetitions:
+@head:
+@key:
+@data:
+@Returns:
-<!-- ##### FUNCTION PassSocket ##### -->
+<!-- ##### FUNCTION gras_dict_get_ext ##### -->
<para>
</para>
-@sock:
-@child:
+@head:
+@key:
+@key_len:
+@data:
@Returns:
-<!-- ##### FUNCTION Peer ##### -->
+<!-- ##### FUNCTION gras_dict_insert ##### -->
<para>
</para>
-@sd:
+@head:
+@key:
+@data:
+@free_ctn:
@Returns:
-<!-- ##### FUNCTION PeerName ##### -->
+<!-- ##### FUNCTION gras_dict_insert_ext ##### -->
<para>
</para>
-@sd:
+@head:
+@key:
+@key_len:
+@data:
+@free_ctn:
@Returns:
-<!-- ##### FUNCTION PeerName_r ##### -->
+<!-- ##### FUNCTION gras_dict_new ##### -->
<para>
</para>
-@sd:
@Returns:
+@dict:
-<!-- ##### MACRO SIMPLE_DATA ##### -->
+<!-- ##### FUNCTION gras_dict_print ##### -->
<para>
</para>
-@type:
-@repetitions:
+@data:
-<!-- ##### MACRO SIMPLE_MEMBER ##### -->
+<!-- ##### FUNCTION gras_dict_prints ##### -->
<para>
</para>
-@type:
-@repetitions:
-@offset:
+@data:
-<!-- ##### MACRO STDC_HEADERS ##### -->
+<!-- ##### FUNCTION gras_dict_remove ##### -->
<para>
</para>
+@head:
+@key:
+@Returns:
-<!-- ##### TYPEDEF Socket ##### -->
+<!-- ##### FUNCTION gras_dict_remove_ext ##### -->
<para>
</para>
+@head:
+@key:
+@key_len:
+@Returns:
-<!-- ##### FUNCTION SocketFailure ##### -->
+<!-- ##### FUNCTION gras_dict_retrieve ##### -->
<para>
</para>
-@sig:
+@head:
+@key:
+@data:
+@Returns:
-<!-- ##### USER_FUNCTION SocketFunction ##### -->
+<!-- ##### FUNCTION gras_dict_retrieve_ext ##### -->
<para>
</para>
-@Param1:
+@head:
+@key:
+@key_len:
+@data:
+@Returns:
-<!-- ##### FUNCTION SocketInUse ##### -->
+<!-- ##### FUNCTION gras_dict_set ##### -->
<para>
</para>
-@sd:
+@head:
+@key:
+@data:
+@free_ctn:
@Returns:
-<!-- ##### FUNCTION SocketIsAvailable ##### -->
+<!-- ##### FUNCTION gras_dict_set_ext ##### -->
<para>
</para>
-@sd:
+@head:
+@key:
+@key_len:
+@data:
+@free_ctn:
@Returns:
-<!-- ##### MACRO VERSION ##### -->
+<!-- ##### FUNCTION gras_dynar_cursor_first ##### -->
<para>
</para>
+@dynar:
+@cursor:
-<!-- ##### USER_FUNCTION grasCallbackFunction ##### -->
+<!-- ##### FUNCTION gras_dynar_cursor_get ##### -->
<para>
</para>
-@sd:
-@msgType:
-@vdata:
+@dynar:
+@cursor:
+@whereto:
+@Returns:
-<!-- ##### FUNCTION grasCloseSocket ##### -->
+<!-- ##### FUNCTION gras_dynar_cursor_rm ##### -->
<para>
</para>
-@sock:
-@Returns:
+@dynar:
+@cursor:
-<!-- ##### FUNCTION grasDataDescCmp ##### -->
+<!-- ##### FUNCTION gras_dynar_cursor_step ##### -->
<para>
</para>
-@dd1:
-@c1:
-@dd2:
-@c2:
-@Returns:
-@description:
+@dynar:
+@cursor:
-<!-- ##### FUNCTION grasDataDescCount ##### -->
+<!-- ##### FUNCTION gras_dynar_first ##### -->
<para>
</para>
-@description:
+@dynar:
+@cursor:
@Returns:
-<!-- ##### FUNCTION grasDataRecv ##### -->
+<!-- ##### MACRO gras_dynar_foreach ##### -->
<para>
</para>
-@sd:
-@data:
-@description:
-@description_length:
-@repetition:
-@Returns:
+@_dynar:
+@_cursor:
+@_data:
+@_whereto:
-<!-- ##### FUNCTION grasDataSend ##### -->
+<!-- ##### FUNCTION gras_dynar_free ##### -->
<para>
</para>
-@sd:
-@data:
-@description:
-@description_length:
-@repetition:
+@dynar:
@Returns:
-<!-- ##### FUNCTION grasDataSize ##### -->
+<!-- ##### FUNCTION gras_dynar_free_container ##### -->
<para>
</para>
-@description:
-@ft:
+@dynar:
@Returns:
-<!-- ##### ENUM grasError_t ##### -->
+<!-- ##### FUNCTION gras_dynar_get ##### -->
<para>
</para>
-@no_error:
-@malloc_error:
-@mismatch_error:
-@sanity_error:
-@system_error:
-@network_error:
-@timeout_error:
-@thread_error:
-@unknown_error:
+@dynar:
+@idx:
+@dst:
+@whereto:
+@Returns:
-<!-- ##### FUNCTION grasLock ##### -->
+<!-- ##### FUNCTION gras_dynar_insert_at ##### -->
<para>
</para>
+@dynar:
+@idx:
+@src:
@Returns:
+@object:
-<!-- ##### TYPEDEF grasMessageType_t ##### -->
+<!-- ##### FUNCTION gras_dynar_length ##### -->
<para>
</para>
+@dynar:
+@Returns:
-<!-- ##### FUNCTION grasMsgDiscard ##### -->
+<!-- ##### FUNCTION gras_dynar_map ##### -->
<para>
</para>
-@sd:
-@size:
+@dynar:
+@operator:
+@Returns:
-<!-- ##### FUNCTION grasMsgEntryGet ##### -->
+<!-- ##### FUNCTION gras_dynar_new ##### -->
<para>
</para>
-@id:
+@Param1:
+@free_func:
@Returns:
+@whereto:
+@elm_size:
-<!-- ##### TYPEDEF grasMsgEntry_t ##### -->
+<!-- ##### FUNCTION gras_dynar_next ##### -->
<para>
</para>
+@dynar:
+@cursor:
+@whereto:
+@Returns:
-<!-- ##### FUNCTION grasMsgFree ##### -->
+<!-- ##### FUNCTION gras_dynar_pop ##### -->
<para>
</para>
-@msg:
+@dynar:
+@dst:
+@whereto:
-<!-- ##### FUNCTION grasMsgHandle ##### -->
+<!-- ##### FUNCTION gras_dynar_push ##### -->
<para>
</para>
-@timeOut:
+@dynar:
+@src:
+@Returns:
+@object:
-<!-- ##### FUNCTION grasMsgHeaderNew ##### -->
+<!-- ##### FUNCTION gras_dynar_remove_at ##### -->
<para>
</para>
-@msgId:
-@dataSize:
-@seqCount:
+@dynar:
+@idx:
+@object:
@Returns:
-<!-- ##### FUNCTION grasMsgNew ##### -->
+<!-- ##### FUNCTION gras_dynar_remplace ##### -->
<para>
</para>
-@msgId:
-@free_data_on_free:
-@seqCount:
-@Varargs:
+@dynar:
+@idx:
+@object:
@Returns:
-<!-- ##### FUNCTION grasMsgRegister ##### -->
+<!-- ##### FUNCTION gras_dynar_reset ##### -->
<para>
</para>
-@message:
-@name:
-@sequence_count:
-@Varargs:
+@dynar:
@Returns:
-<!-- ##### FUNCTION grasMsgSend ##### -->
+<!-- ##### FUNCTION gras_dynar_set ##### -->
<para>
</para>
-@sd:
-@message:
-@sequence_count:
-@Varargs:
+@dynar:
+@idx:
+@src:
@Returns:
+@object:
-<!-- ##### FUNCTION grasMsgWait ##### -->
+<!-- ##### FUNCTION gras_dynar_shift ##### -->
<para>
</para>
-@sd:
-@timeout:
-@message:
-@sequence_count:
-@Varargs:
+@dynar:
+@dst:
+@whereto:
@Returns:
-<!-- ##### FUNCTION grasMyMachineName ##### -->
+<!-- ##### FUNCTION gras_dynar_unshift ##### -->
<para>
</para>
+@dynar:
+@src:
@Returns:
+@object:
-<!-- ##### FUNCTION grasOpenClientSocket ##### -->
+<!-- ##### ENUM gras_error_t ##### -->
<para>
</para>
-@host:
-@Param2:
-@sock:
-@Returns:
+@no_error: no error
+@mismatch_error: Not found
+@system_error: a syscall did fail
+@network_error: error while sending/receiving data
+@timeout_error: not quick enough, dude
+@thread_error: error while [un]locking
+@unknown_error: no idea
-<!-- ##### FUNCTION grasOpenServerSocket ##### -->
+<!-- ##### FUNCTION gras_lock ##### -->
<para>
</para>
-@Param1:
-@Param2:
-@sock:
@Returns:
-<!-- ##### MACRO grasPROTOCOL ##### -->
+<!-- ##### FUNCTION gras_log_appender_set ##### -->
<para>
</para>
+@cat:
+@app:
-<!-- ##### FUNCTION grasPeerGetAddress ##### -->
+<!-- ##### FUNCTION gras_log_control_set ##### -->
<para>
</para>
-@sd:
+@cs:
@Returns:
-<!-- ##### FUNCTION grasPeerGetName ##### -->
+<!-- ##### VARIABLE gras_log_default_appender ##### -->
<para>
</para>
-@sd:
-@Returns:
-<!-- ##### FUNCTION grasRecvData ##### -->
+<!-- ##### FUNCTION gras_log_parent_set ##### -->
<para>
</para>
-@sd:
-@data:
-@description:
-@Returns:
+@cat:
+@parent:
-<!-- ##### FUNCTION grasRegisterCallback ##### -->
+<!-- ##### ENUM gras_log_priority_t ##### -->
<para>
</para>
-@message:
-@TTL:
-@cb:
+@gras_log_priority_none:
+@gras_log_priority_trace:
+@gras_log_priority_debug:
+@gras_log_priority_verbose:
+@gras_log_priority_info:
+@gras_log_priority_warning:
+@gras_log_priority_error:
+@gras_log_priority_critical:
+@gras_log_priority_infinite:
+@gras_log_priority_uninitialized:
-<!-- ##### FUNCTION grasSendData ##### -->
+<!-- ##### FUNCTION gras_log_threshold_set ##### -->
<para>
</para>
-@sd:
-@data:
-@description:
-@Returns:
+@cat:
+@thresholdPriority:
-<!-- ##### FUNCTION grasUnlock ##### -->
+<!-- ##### FUNCTION gras_msg_discard ##### -->
<para>
</para>
-@Returns:
+@sd:
+@size:
-<!-- ##### FUNCTION grasUserdataGet ##### -->
+<!-- ##### FUNCTION gras_msg_free ##### -->
<para>
</para>
+@msg:
-<!-- ##### MACRO grasUserdataNew ##### -->
+<!-- ##### FUNCTION gras_msg_new ##### -->
<para>
</para>
-@type:
+@msgId:
+@free_data_on_free:
+@seqCount:
+@Varargs:
+@Returns:
-<!-- ##### FUNCTION grasUserdataSet ##### -->
+<!-- ##### FUNCTION gras_msgtype_register ##### -->
<para>
</para>
-@ud:
+@msgId:
+@name:
+@sequence_count:
+@Varargs:
+@Returns:
-<!-- ##### FUNCTION gras_datadesc_copy_data ##### -->
+<!-- ##### FUNCTION gras_set_add ##### -->
<para>
</para>
-@dd:
-@c:
-@data:
+@set:
+@elm:
+@free_func:
+@Returns:
-<!-- ##### FUNCTION gras_dict_cursor_next ##### -->
+<!-- ##### MACRO gras_set_foreach ##### -->
<para>
</para>
+@set:
@cursor:
-@Returns:
+@elm:
-<!-- ##### FUNCTION gras_dynar_first ##### -->
+<!-- ##### FUNCTION gras_set_free ##### -->
<para>
</para>
-@dynar:
-@cursor:
+@set:
+
+<!-- ##### FUNCTION gras_set_get_by_id ##### -->
+<para>
+
+</para>
+
+@set:
+@id:
+@dst:
@Returns:
-<!-- ##### FUNCTION gras_dynar_next ##### -->
+<!-- ##### FUNCTION gras_set_get_by_name ##### -->
<para>
</para>
-@dynar:
-@cursor:
-@whereto:
+@set:
+@key:
+@dst:
@Returns:
-<!-- ##### FUNCTION gras_lock ##### -->
+<!-- ##### FUNCTION gras_set_get_by_name_ext ##### -->
<para>
</para>
+@set:
+@name:
+@name_len:
+@dst:
@Returns:
-<!-- ##### FUNCTION gras_log_parent_set ##### -->
+<!-- ##### FUNCTION gras_set_new ##### -->
<para>
</para>
-@cat:
-@parent:
+@Returns:
+@dst:
-<!-- ##### FUNCTION gras_log_threshold_set ##### -->
+<!-- ##### FUNCTION gras_sleep ##### -->
<para>
</para>
-@cat:
-@thresholdPriority:
+@Param1:
+@Param2:
<!-- ##### FUNCTION gras_sock_client_open ##### -->
<para>
@sock:
@Returns:
+<!-- ##### FUNCTION gras_time ##### -->
+<para>
+
+</para>
+
+@Returns:
+
<!-- ##### FUNCTION gras_unlock ##### -->
<para>
@Returns:
+<!-- ##### ENUM xbt_error_t ##### -->
+<para>
+
+</para>
+
+@no_error:
+@mismatch_error:
+@system_error:
+@network_error:
+@timeout_error:
+@thread_error:
+@unknown_error:
+@remote_mismatch_error:
+@remote_system_error:
+@remote_network_error:
+@remote_timeout_error:
+@remote_thread_error:
+@remote_unknown_error:
+
