ucontext implementation featuring glibc-compatible ABI

Go to file

Ariadne Conill 5f137a1fe4 Merge pull request #16 from gabrielivascu/master Makefile: i386, i686 -> x86		2020-03-27 03:09:32 -06:00
arch	ppc32/64: rewrite get/set/swapcontext in assembly	2019-04-05 14:44:54 -05:00
.gitignore	Makefile: Handle static library at clean/install	2019-04-12 10:48:24 +03:00
LICENSE	don't bother with glibc stuff afterall, kernel defines ABI to use	2018-01-29 21:50:49 +00:00
Makefile	Merge pull request #16 from gabrielivascu/master	2020-03-27 03:09:32 -06:00
README.md	ppc32/64: rewrite get/set/swapcontext in assembly	2019-04-05 14:44:54 -05:00
test_libucontext.c	test calls to getcontext without makecontext	2019-04-05 13:28:36 -05:00

README.md

`libucontext`

libucontext is a library which provides the ucontext.h C API. Unlike other implementations, it faithfully follows the kernel process ABI when doing context swaps.

Notably, when combined with gcompat, it provides a fully compatible implementation of the ucontext functions that are ABI compatible with glibc.

supported architectures

Adding support for new architectures is easy, but you need to know assembly language to do it.

Right now these archs are supported and should work on bare metal:

x86
x86_64
armv6+ (arm)
aarch64
s390x

These archs require kernel assistance and use a syscall:

ppc
ppc64 (ELFv2 ABI spec only, ELFv1 not supported)

building

libucontext uses a simple makefile build system. You should define ARCH= at build time, otherwise the build system will attempt to guess using uname -m.

$ make ARCH=x86_64
$ make ARCH=x86_64 check
$ make ARCH=x86_64 DESTDIR=out install

support

libucontext is offered as part of the gcompat project. Accordingly, please address all questions and bug reports to gcompat@lists.adelielinux.org.