rlcamp
/
libucontext
forked from ariadne/libucontext
1
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity
ucontext implementation featuring glibc-compatible ABI
100 Commits
4 Branches
0 Tags
587 KiB
Assembly 51.3%
C 40.5%
Makefile 5.7%
Meson 2.5%
 
 
 
 
Go to file
Ariadne Conill 02470ccdd8 build: split CFLAGS/CPPFLAGS correctly 2020-12-03 18:24:08 -07:00
arch riscv64: add makecontext() and __start_context() trampoline 2020-05-18 03:19:22 +00:00
.gitignore remove pointless gitignore entries 2020-03-29 13:44:06 +00:00
.mailmap update copyright statements, add mailmap 2020-03-27 09:23:49 +00:00
LICENSE update copyright statements, add mailmap 2020-03-27 09:23:49 +00:00
Makefile build: split CFLAGS/CPPFLAGS correctly 2020-12-03 18:24:08 -07:00
NEWS NEWS: prepare for 0.11 release 2020-05-18 03:26:37 +00:00
README.md README: note riscv64 support 2020-05-18 03:28:21 +00:00
test_libucontext.c test: swaps to f1 not main 2020-03-29 15:10:17 +00: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
  • mips (O32 ABI only)
  • mips64 (N32/N64 ABI only, like Alpine, only N64 ABI has been tested)
  • riscv64

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