04db253a39
evl_get_current() contains implementation details which are definitely not part of the API and the way this works should not be exposed. Signed-off-by: Philippe Gerum <rpm@xenomai.org> |
||
|---|---|---|
| .. | ||
| Makefile | ||
| README.md | ||
| clock.c | ||
| event.c | ||
| flags.c | ||
| heap.c | ||
| init.c | ||
| internal.h | ||
| mutex.c | ||
| poll.c | ||
| proxy.c | ||
| sched.c | ||
| sem.c | ||
| thread.c | ||
| timer.c | ||
| version.c | ||
README.md
== PURPOSE of libeshi
The EVL shim library mimics the behavior of the original EVL API based on plain POSIX calls from the native *libc, which does not require the EVL core to be enabled in the host kernel. It is useful when the real-time guarantees delivered by the EVL core are not required for quick prototyping or debugging application code.
== USAGE
To build against the EVL shim library, you need to update a couple of settings from the Makefile building your application as follows (*):
CPPFLAGS/CFLAGS:
- Replace -I$(prefix)/include by -I$(prefix)/include/eshi
LDFLAGS:
- Replace -levl by -leshi
For instance:
(CC) -o app app.c -I(prefix)/include/eshi -L$(prefix)/lib -leshi -lpthread -lrt
(*) $(prefix) is the installation root of libevl (e.g. /usr/evl).
== LIMITATIONS
This API supports process-local services only. The resources/objects it creates cannot be shared between processes.
The following calls are not supported:
evl_peek_flags evl_peek_sem evl_new_xbuf evl_open_mutex evl_open_event evl_open_flags evl_open_sem The observable API.
== VARIATION(S)
evl_poll: POLLOUT is always set for evl_flags. Unlike with the native libevl API, this condition cannot be monitored for detecting event consumption by the receiver side, i.e. waiting for the value to be cleared upon a successful call to evl_wait*_flags.