GitLab

Signed-off-by: Gernot Hillier <gernot.hillier@siemens.com>

--enable-debug[=partial]

"symbols" enables debug symbols to be compiled in the libraries and
executables, still turning on the optimizer (-O2). This option has no
overhead, it is useful to get meaningful backtraces using gdb while
running the application at nominal speed.

"partial" includes "symbols", and also turns on internal consistency
checks within the Xenomai code (mostly present in the Copperplate
layer). The __XENO_DEBUG__ macro is defined, for both the Xenomai core
and the applications getting their C compilation flags from the
xeno-config script (i.e. xeno-config --cflags). The partial debug mode
implicitly turns on --enable-assert. A measurable overhead is
introduced by this level.  This is the default level when
--enable-debug is mentioned with no level specification.

"full" includes "partial" settings, but the optimizer is disabled
(-O0), and even more consistency checks may be performed.  In addition
to __XENO_DEBUG__, the macro __XENO_DEBUG_FULL__ is defined. This
level introduces the most overhead, which may triple the worst-case
latency, or even more.

1. libcobalt now controls dynamically whether auto-shadowing of the
current context is disabled by checking the new XENO_NOSHADOW
environment variable for existence. Otherwise, the current thread
becomes a Xenomai thread when the library constructor is executed.

This replaces the former static mechanism based on building with
--enable-dlopen-skins, aimed at dynamic loading of the POSIX interface
via dlopen(). Applications can run putenv("XENO_NOSHADOW=<non-empty>")
before dynamically loading libcobalt.so.

2. global memory locking is systematically performed from the library
constructor if auto-shadowing is enabled, and remains in effect
afterwards. Applications which do not want such locking to be in
effect during their initialization phase should call munlockall()
explicitly, then lock the process memory anew before creating any
Xenomai thread.

3. The new --enable-dlopen-libs build switch must be passed to allow
Xenomai libaries to be dynamically loaded via dlopen(). This replaces
the former --enable-dlopen-skins switch. Unlike the latter,
--enable-dlopen-libs does not implicitly disable TLS support.

3. The --with-__thread build switch has been renamed --enable-tls. TLS
is now available to dynamically loaded Xenomai libraries,
i.e. --enable-tls --enable-dlopen-libs is valid.