Module: xenomai-3
Branch: master
Commit: d18a0816de1a90e00a4d1f28c585b7e30da7c29e
URL:    
http://git.xenomai.org/?p=xenomai-3.git;a=commit;h=d18a0816de1a90e00a4d1f28c585b7e30da7c29e

Author: Philippe Gerum <r...@xenomai.org>
Date:   Fri Mar 27 10:09:37 2015 +0100

doc/man1: update xeno-config manpage

---

 doc/asciidoc/man1/xeno-config.adoc |   17 ++++++++++++++++-
 1 file changed, 16 insertions(+), 1 deletion(-)

diff --git a/doc/asciidoc/man1/xeno-config.adoc 
b/doc/asciidoc/man1/xeno-config.adoc
index b10b97d..5aba121 100644
--- a/doc/asciidoc/man1/xeno-config.adoc
+++ b/doc/asciidoc/man1/xeno-config.adoc
@@ -78,7 +78,7 @@ current system, if cross-compiling.
 *--prefix*::
 Output the absolute path to the Xenomai installation directory.
 
-*--[skin=]{posix, alchemy, rtdm, psos, vxworks, smokey}*::
+*--[skin=]{posix, alchemy, rtdm, psos, vxworks, smokey, cobalt}*::
 Select the API/skin for which *xeno-config* should print the
 information required. The *skin=* prefix is optional and may be
 omitted, e.g. *--posix* is equivalent to *--skin=posix*, selecting the
@@ -87,6 +87,21 @@ POSIX API.
 [NOTE]
 *--native* and *--skin=native* are accepted for backward compatibility
 purpose. They are stricly equivalent as passing *--alchemy --compat*.
+Likewise, passing *--rtdm* or *--skin=rtdm* is stricly equivalent as
+passing *--posix*, enabling POSIX I/O routines to be wrapped to their
+respective Xenomai implementation.
+
+[CAUTION]
+Over Cobalt, only *xeno-config --posix --ldflags* (or *--rtdm* as an
+alias) returns the proper linker flags to cause POSIX routines invoked
+by the application to be wrapped to their respective Xenomai
+implementation. No other API will imply such wrapping. For this
+reason, *--cobalt --ldflags* should be used for linking exclusively
+against the Cobalt library (i.e. +libcobalt.so+) *without* symbol
+wrapping. Conversely, mentioning *--posix* along with other API
+switches with *--ldflags* will cause POSIX symbol wrapping to take
+place, e.g. use *--posix --alchemy --ldflags* for mixed API support
+with POSIX symbol wrapping.
 
 *--cflags*::
 Output the C compiler command-line options (_CFLAGS_) which are required


_______________________________________________
Xenomai-git mailing list
Xenomai-git@xenomai.org
http://www.xenomai.org/mailman/listinfo/xenomai-git

Reply via email to