From mboxrd@z Thu Jan 1 00:00:00 1970 From: Philippe Gerum References: <08c2ad36-f2c4-952f-5372-bd95146943cf@xenomai.org> <16992f8a-acba-371e-bd48-b515d60978ff@xenomai.org> Message-ID: <4da13ab9-1518-f74c-4dea-9f67e392b204@xenomai.org> Date: Sun, 8 Apr 2018 17:43:05 +0200 MIME-Version: 1.0 In-Reply-To: <16992f8a-acba-371e-bd48-b515d60978ff@xenomai.org> Content-Type: text/plain; charset=utf-8 Content-Language: en-US Content-Transfer-Encoding: 7bit Subject: Re: [Xenomai] doc for xeno-config skins List-Id: Discussions about the Xenomai project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , To: Giulio Moro , "xenomai@xenomai.org" On 04/05/2018 03:25 PM, Philippe Gerum wrote: > On 04/05/2018 01:39 PM, Giulio Moro wrote: >> Thanks and sorry for overlooking that. I thought if there was some docs on xeno-config it would have been inlined in its source, so that is where I looked for it. I guess the man folder should have been a more obvious choice. >> >> Is it correct that calling `xeno-config --skin cobalt` expects you to call, POSIX functions prefixed with `__wrap_` ? Does this mean that the *actual* "Cobalt POSIX interface" consists of __wrap_fn() calls as opposed to fn() calls? > > __RT(fn()) and __COBALT(fn()) hide this ugly __wrap prefix inside an > ugly macro. __STD() keeps consistent with such ugliness for __real calls. > >> If yes, is this documented somewhere obvious? > I kind of figured this out over time by reading > http://xenomai.org/2014/08/porting-a-linux-application-to-xenomai-dual-kernel/ > and looking at the wrappers files and at the source code, but is it > stated clearly somewhere? > > Of course not. Proper documentation hinders fruitful imagination. > >> This is a place where I would have looked for that, for instance: http://www.xenomai.org/documentation/xenomai-3/html/xeno3prm/group__cobalt__api.html . >> > > Makes sense, added to my todo list. This is part of a larger > documentation work. > This commit is an attempt to clarify the matter of symbol wrapping: http://git.xenomai.org/xenomai-3.git/commit/?id=e28d2631154d26e00715a5ef0f952ceb5df7ef59 -- Philippe.