meson: support building docs

Toggleable with -Ddocs=(true|false), defaults to false.

Requires bumping minimum meson version to 0.59.0, or 0.61.0 to also
include symlinks.

.woodpecker.yml

@@ -0,0 +1,40 @@
+pipeline:
+  build-x86_64:
+    image: alpine
+    commands:
+      - apk add --no-cache build-base
+      - make check ARCH=x86_64
+    when:
+      platform: linux/amd64
+
+  build-s390x:
+    image: alpine
+    commands:
+      - apk add --no-cache build-base
+      - make check ARCH=s390x
+    when:
+      platform: linux/s390x
+
+  build-ppc64le:
+    image: alpine
+    commands:
+      - apk add --no-cache build-base
+      - make check ARCH=ppc64le
+    when:
+      platform: linux/ppc64le
+
+  build-armv7:
+    image: alpine
+    commands:
+      - apk add --no-cache build-base
+      - make check ARCH=arm
+    when:
+      platform: linux/arm
+
+  build-aarch64:
+    image: alpine
+    commands:
+      - apk add --no-cache build-base
+      - make check ARCH=aarch64
+    when:
+      platform: linux/arm64

LICENSE

@@ -1,4 +1,4 @@
-Copyright (c) 2018-2020 Ariadne Conill <ariadne@dereferenced.org>
+Copyright (c) 2018-2022 Ariadne Conill <ariadne@dereferenced.org>
 
 Permission to use, copy, modify, and/or distribute this software for any
 purpose with or without fee is hereby granted, provided that the above

Makefile

@@ -13,48 +13,88 @@ endif
 ifeq ($(ARCH),$(filter $(ARCH),armv7l))
 	override ARCH = arm
 endif
+ifeq ($(ARCH),$(filter $(ARCH),arm64))
+	override ARCH = aarch64
+endif
 
-LIBDIR := /lib
-INCLUDEDIR := /usr/include
-PKGCONFIGDIR := /usr/lib/pkgconfig
-CFLAGS := -ggdb3 -O2 -Wall
+prefix = /usr
+libdir = ${prefix}/lib
+shared_libdir = ${libdir}
+static_libdir = ${libdir}
+includedir = ${prefix}/include
+pkgconfigdir = ${prefix}/lib/pkgconfig
+
+CFLAGS ?= -ggdb3 -O2 -Wall
 CPPFLAGS := -Iinclude -Iarch/${ARCH} -Iarch/common
-EXPORT_UNPREFIXED := yes
+ifneq ($(shell uname),Darwin)
+	EXPORT_UNPREFIXED := yes
+else
+	# Darwin does not support aliases
+	EXPORT_UNPREFIXED := no
+endif
 FREESTANDING := no
 
 ifeq ($(FREESTANDING),yes)
-	CFLAGS += -DFREESTANDING
+	CPPFLAGS += -DFREESTANDING
 	EXPORT_UNPREFIXED = no
 endif
 
+FORCE_SOFT_FLOAT := no
+
+ifeq ($(FORCE_SOFT_FLOAT),yes)
+        CPPFLAGS += -DFORCE_SOFT_FLOAT
+endif
+
+FORCE_HARD_FLOAT := no
+
+ifeq ($(FORCE_HARD_FLOAT),yes)
+        CPPFLAGS += -DFORCE_HARD_FLOAT
+endif
+
 ifeq ($(EXPORT_UNPREFIXED),yes)
-	CFLAGS += -DEXPORT_UNPREFIXED
+	CPPFLAGS += -DEXPORT_UNPREFIXED
 endif
 
 LIBUCONTEXT_C_SRC = $(wildcard arch/${ARCH}/*.c)
 LIBUCONTEXT_S_SRC = $(wildcard arch/${ARCH}/*.S)
 
+ifeq ($(shell test -d arch/${ARCH}/include; echo $?),0)
+	CPPFLAGS += -Iarch/${ARCH}/include
+endif
+
 LIBUCONTEXT_VERSION := $(shell head -n 1 VERSION)
 LIBUCONTEXT_OBJ = ${LIBUCONTEXT_C_SRC:.c=.o} ${LIBUCONTEXT_S_SRC:.S=.o}
 LIBUCONTEXT_SOVERSION = 1
-LIBUCONTEXT_NAME = libucontext.so
+ifeq ($(shell uname),Darwin)
+	LIBUCONTEXT_NAME = libucontext.dylib
+	LIBUCONTEXT_SONAME = libucontext.${LIBUCONTEXT_SOVERSION}.dylib
+	LIBUCONTEXT_POSIX_NAME = libucontext_posix.dylib
+	LIBUCONTEXT_POSIX_SONAME = libucontext_posix.${LIBUCONTEXT_SOVERSION}.dylib
+	LIBUCONTEXT_LINKER_FLAGS = -Wl,-dynamiclib,-install_name,${LIBUCONTEXT_SONAME},-current_version,${LIBUCONTEXT_SOVERSION},-compatibility_version,${LIBUCONTEXT_SOVERSION}
+	LIBUCONTEXT_POSIX_LINKER_FLAGS = -Wl,-dynamiclib,-install_name,${LIBUCONTEXT_POSIX_SONAME},-current_version,${LIBUCONTEXT_SOVERSION},-compatibility_version,${LIBUCONTEXT_SOVERSION}
+else
+	LIBUCONTEXT_NAME = libucontext.so
+	LIBUCONTEXT_SONAME = libucontext.so.${LIBUCONTEXT_SOVERSION}
+	LIBUCONTEXT_POSIX_NAME = libucontext_posix.so
+	LIBUCONTEXT_POSIX_SONAME = libucontext_posix.so.${LIBUCONTEXT_SOVERSION}
+	LIBUCONTEXT_LINKER_FLAGS = -shared -Wl,-soname,${LIBUCONTEXT_SONAME} -Wl,-z,noexecstack
+	LIBUCONTEXT_POSIX_LINKER_FLAGS = -shared -Wl,-soname,${LIBUCONTEXT_POSIX_SONAME} -Wl,-z,noexecstack
+	ASFLAGS = -Wa,--noexecstack
+endif
 LIBUCONTEXT_STATIC_NAME = libucontext.a
 LIBUCONTEXT_PC = libucontext.pc
-LIBUCONTEXT_SONAME = libucontext.so.${LIBUCONTEXT_SOVERSION}
-LIBUCONTEXT_PATH = ${LIBDIR}/${LIBUCONTEXT_SONAME}
-LIBUCONTEXT_STATIC_PATH = ${LIBDIR}/${LIBUCONTEXT_STATIC_NAME}
+LIBUCONTEXT_PATH = ${shared_libdir}/${LIBUCONTEXT_SONAME}
+LIBUCONTEXT_STATIC_PATH = ${static_libdir}/${LIBUCONTEXT_STATIC_NAME}
 LIBUCONTEXT_HEADERS = \
 	include/libucontext/libucontext.h \
 	include/libucontext/bits.h
 LIBUCONTEXT_EXAMPLES = \
 	examples/cooperative_threading
-LIBUCONTEXT_POSIX_NAME = libucontext_posix.so
 LIBUCONTEXT_POSIX_STATIC_NAME = libucontext_posix.a
 LIBUCONTEXT_POSIX_C_SRC = libucontext_posix.c
 LIBUCONTEXT_POSIX_OBJ = ${LIBUCONTEXT_POSIX_C_SRC:.c=.o}
-LIBUCONTEXT_POSIX_SONAME = libucontext_posix.so.${LIBUCONTEXT_SOVERSION}
-LIBUCONTEXT_POSIX_PATH = ${LIBDIR}/${LIBUCONTEXT_POSIX_SONAME}
-LIBUCONTEXT_POSIX_STATIC_PATH = ${LIBDIR}/${LIBUCONTEXT_POSIX_STATIC_NAME}
+LIBUCONTEXT_POSIX_PATH = ${shared_libdir}/${LIBUCONTEXT_POSIX_SONAME}
+LIBUCONTEXT_POSIX_STATIC_PATH = ${static_libdir}/${LIBUCONTEXT_POSIX_STATIC_NAME}
 
 ifeq ($(FREESTANDING),yes)
 	LIBUCONTEXT_POSIX_NAME =
@@ -64,8 +104,7 @@ endif
 all: ${LIBUCONTEXT_SONAME} ${LIBUCONTEXT_STATIC_NAME} ${LIBUCONTEXT_POSIX_NAME} ${LIBUCONTEXT_POSIX_STATIC_NAME} ${LIBUCONTEXT_PC}
 
 ${LIBUCONTEXT_POSIX_NAME}: ${LIBUCONTEXT_NAME} ${LIBUCONTEXT_POSIX_OBJ}
-	$(CC) -fPIC -o ${LIBUCONTEXT_POSIX_NAME} -Wl,-soname,${LIBUCONTEXT_POSIX_SONAME} \
-		-shared ${LIBUCONTEXT_POSIX_OBJ} ${LDFLAGS}
+	$(CC) -fPIC -o ${LIBUCONTEXT_POSIX_NAME} ${LIBUCONTEXT_POSIX_LINKER_FLAGS} ${LIBUCONTEXT_POSIX_OBJ} -L. -lucontext ${LDFLAGS}
 
 ${LIBUCONTEXT_POSIX_STATIC_NAME}: ${LIBUCONTEXT_STATIC_NAME} ${LIBUCONTEXT_POSIX_OBJ}
 	$(AR) rcs ${LIBUCONTEXT_POSIX_STATIC_NAME} ${LIBUCONTEXT_POSIX_OBJ}
@@ -77,16 +116,16 @@ ${LIBUCONTEXT_STATIC_NAME}: ${LIBUCONTEXT_HEADERS} ${LIBUCONTEXT_OBJ}
 	$(AR) rcs ${LIBUCONTEXT_STATIC_NAME} ${LIBUCONTEXT_OBJ}
 
 ${LIBUCONTEXT_NAME}: ${LIBUCONTEXT_HEADERS} ${LIBUCONTEXT_OBJ}
-	$(CC) -fPIC -o ${LIBUCONTEXT_NAME} -Wl,-soname,${LIBUCONTEXT_SONAME} \
-		-shared ${LIBUCONTEXT_OBJ} ${LDFLAGS}
+	$(CC) -fPIC -o ${LIBUCONTEXT_NAME} ${LIBUCONTEXT_LINKER_FLAGS} ${LIBUCONTEXT_OBJ} ${LDFLAGS}
 
 ${LIBUCONTEXT_SONAME}: ${LIBUCONTEXT_NAME}
 	ln -sf ${LIBUCONTEXT_NAME} ${LIBUCONTEXT_SONAME}
 
 ${LIBUCONTEXT_PC}: libucontext.pc.in
 	sed -e s:@LIBUCONTEXT_VERSION@:${LIBUCONTEXT_VERSION}:g \
-	    -e s:@LIBUCONTEXT_LIBDIR@:${LIBDIR}:g \
-	    -e s:@LIBUCONTEXT_INCLUDEDIR@:${INCLUDEDIR}:g $< > $@
+	    -e s:@LIBUCONTEXT_SHARED_LIBDIR@:${shared_libdir}:g \
+	    -e s:@LIBUCONTEXT_STATIC_LIBDIR@:${static_libdir}:g \
+	    -e s:@LIBUCONTEXT_INCLUDEDIR@:${includedir}:g $< > $@
 
 MANPAGES_SYMLINKS_3 = \
 	libucontext_getcontext.3 \
@@ -108,7 +147,7 @@ docs: ${MANPAGES}
 	$(CC) -std=gnu99 -D_BSD_SOURCE -fPIC -DPIC ${CFLAGS} ${CPPFLAGS} -c -o $@ $<
 
 .S.o:
-	$(CC) -fPIC -DPIC ${CFLAGS} ${CPPFLAGS} -c -o $@ $<
+	$(CC) -fPIC -DPIC ${CFLAGS} ${CPPFLAGS} ${ASFLAGS} -c -o $@ $<
 
 ${LIBUCONTEXT_NAME}_clean:
 	rm -f ${LIBUCONTEXT_NAME}
@@ -131,6 +170,9 @@ bits_clean:
 ${LIBUCONTEXT_POSIX_NAME}_clean:
 	rm -f ${LIBUCONTEXT_POSIX_NAME}
 
+${LIBUCONTEXT_POSIX_SONAME}_clean:
+	rm -f ${LIBUCONTEXT_POSIX_SONAME}
+
 ${LIBUCONTEXT_POSIX_STATIC_NAME}_clean:
 	rm -f ${LIBUCONTEXT_POSIX_STATIC_NAME}
 
@@ -157,6 +199,7 @@ clean: ${LIBUCONTEXT_STATIC_NAME}_clean
 clean: ${LIBUCONTEXT_PC}_clean
 clean: bits_clean
 clean: ${LIBUCONTEXT_POSIX_NAME}_clean
+clean: ${LIBUCONTEXT_POSIX_SONAME}_clean
 clean: ${LIBUCONTEXT_POSIX_STATIC_NAME}_clean
 clean: libucontext_posix_obj_clean
 clean: libucontext_obj_clean
@@ -166,13 +209,13 @@ clean: docs_clean
 install: all
 	install -D -m755 ${LIBUCONTEXT_NAME} ${DESTDIR}${LIBUCONTEXT_PATH}
 	install -D -m664 ${LIBUCONTEXT_STATIC_NAME} ${DESTDIR}${LIBUCONTEXT_STATIC_PATH}
-	ln -sf ${LIBUCONTEXT_SONAME} ${DESTDIR}${LIBDIR}/${LIBUCONTEXT_NAME}
+	ln -sf ${LIBUCONTEXT_SONAME} ${DESTDIR}${shared_libdir}/${LIBUCONTEXT_NAME}
 	for i in ${LIBUCONTEXT_HEADERS}; do \
 		destfn=$$(echo $$i | sed s:include/::g); \
-		install -D -m644 $$i ${DESTDIR}${INCLUDEDIR}/$$destfn; \
+		install -D -m644 $$i ${DESTDIR}${includedir}/$$destfn; \
 	done
-	install -D -m644 ${LIBUCONTEXT_PC} ${DESTDIR}${PKGCONFIGDIR}/${LIBUCONTEXT_PC}
-	if [ -n ${LIBUCONTEXT_POSIX_NAME} ]; then \
+	install -D -m644 ${LIBUCONTEXT_PC} ${DESTDIR}${pkgconfigdir}/${LIBUCONTEXT_PC}
+	if [ -n "${LIBUCONTEXT_POSIX_NAME}" ]; then \
 		install -D -m755 ${LIBUCONTEXT_POSIX_NAME} ${DESTDIR}${LIBUCONTEXT_POSIX_PATH}; \
 		install -D -m644 ${LIBUCONTEXT_POSIX_STATIC_NAME} ${DESTDIR}${LIBUCONTEXT_POSIX_STATIC_PATH}; \
 	fi
@@ -186,7 +229,7 @@ install_docs: docs
 ifneq (${FREESTANDING},yes)
 check: check_libucontext_posix
 
-check_libucontext_posix: test_libucontext_posix ${LIBUCONTEXT_POSIX_SONAME}
+check_libucontext_posix: test_libucontext_posix ${LIBUCONTEXT_POSIX_SONAME} ${LIBUCONTEXT_SONAME}
 	env LD_LIBRARY_PATH=$(shell pwd) ./test_libucontext_posix
 
 test_libucontext_posix: test_libucontext_posix.c ${LIBUCONTEXT_POSIX_NAME}
@@ -203,9 +246,11 @@ test_libucontext_bare_posixabi: test_libucontext_posix.c ${LIBUCONTEXT_NAME}
 	$(CC) -std=gnu99 -D_BSD_SOURCE ${CFLAGS} ${CPPFLAGS} test_libucontext_posix.c -o $@ -L. -lucontext
 endif
 
-check: test_libucontext ${LIBUCONTEXT_SONAME}
+check_libucontext: test_libucontext ${LIBUCONTEXT_SONAME}
 	env LD_LIBRARY_PATH=$(shell pwd) ./test_libucontext
 
+check: check_libucontext
+
 test_libucontext: test_libucontext.c ${LIBUCONTEXT_NAME}
 	$(CC) -std=gnu99 -D_BSD_SOURCE ${CFLAGS} ${CPPFLAGS} $@.c -o $@ -L. -lucontext
 

NEWS

@@ -1,3 +1,20 @@
+Changes from 1.1 to 1.2
+-----------------------
+
+* Added Loongarch64 port.
+
+* Added OpenRISC (or1k) port.
+
+* Fixed various build system issues:
+  - libucontext_posix.so is no longer underlinked
+  - Executable stacks are now disabled when using GNU-like toolchains
+  - CPPFLAGS is used consistently
+  - Users may now build on Darwin without using Meson
+
+* aarch64 now implements the necessary SIMD register save/restore as
+  mandatory in AAPCS64.
+  Patches contributed by Richard Campbell.
+
 Changes from 1.0 to 1.1
 -----------------------
 

README.md

@@ -20,9 +20,11 @@ target to do it.
 |--------------|---------------|---------|-----------------------|-------------------|
 |    aarch64   | ✓             |         | ✓                     | ✓                 |
 |      arm     | ✓             |         | ✓                     | ✓                 |
+| loongarch64  | ✓             |         | ✓                     |                   |
 |     m68k     | ✓             |         | ✓                     | ✓                 |
 |     mips     | ✓             |         | ✓                     |                   |
 |    mips64    | ✓             |         | ✓                     |                   |
+|     or1k     | ✓             |         | ✓                     | ✓                 |
 |      ppc     | ✓             | ✓       |                       |                   |
 |     ppc64    | ✓             | ✓       |                       |                   |
 |    riscv32   | ✓             |         | ✓                     | ✓                 |
@@ -99,4 +101,5 @@ ucontext functions:
   save/restore FPU registers or vector registers may be added in a later release as a build-time
   setting -- for now, we assume a soft-float ABI with no optional processor features.  In practice, this
   does not really matter, code using these functions are unlikely to be impacted by this design
-  assumption.
+  assumption. This is a work in progress, as newer compilers will spill even non-floating-point state
+  through floating point registers when allowed to do so.

VERSION

@@ -1 +1 @@
-1.1
+1.2

arch/aarch64/defs.h

@@ -9,6 +9,7 @@
 #define SP_OFFSET	432
 #define PC_OFFSET	440
 #define PSTATE_OFFSET	448
+#define FPSIMD_CONTEXT_OFFSET 464
 
 #ifndef FPSIMD_MAGIC
 # define FPSIMD_MAGIC	0x46508001

arch/aarch64/getcontext.S

@@ -50,7 +50,11 @@ PROC_NAME(libucontext_getcontext):
 	/* save pstate */
 	str	xzr, [x0, #PSTATE_OFFSET]
 
-	/* TODO: SIMD / FPRs */
+	add x2, x0, #FPSIMD_CONTEXT_OFFSET
+	stp q8, q9,   [x2, #144]
+	stp q10, q11, [x2, #176]
+	stp q12, q13, [x2, #208]
+	stp q14, q15, [x2, #240]
 
 	mov	x0, #0
 	ret

arch/aarch64/setcontext.S

@@ -33,7 +33,11 @@ PROC_NAME(libucontext_setcontext):
 	ldr	x2, [x0, #SP_OFFSET]
 	mov	sp, x2
 
-	/* TODO: SIMD / FPRs */
+	add x2, x0, #FPSIMD_CONTEXT_OFFSET
+	ldp q8, q9,   [x2, #144]
+	ldp q10, q11, [x2, #176]
+	ldp q12, q13, [x2, #208]
+	ldp q14, q15, [x2, #240]
 
 	/* save current program counter in link register */
 	ldr	x16, [x0, #PC_OFFSET]

arch/aarch64/swapcontext.S

@@ -49,6 +49,12 @@ PROC_NAME(libucontext_swapcontext):
 	/* save pstate */
 	str	xzr, [x0, #PSTATE_OFFSET]
 
+	add x2, x0, #FPSIMD_CONTEXT_OFFSET
+	stp q8, q9,   [x2, #144]
+	stp q10, q11, [x2, #176]
+	stp q12, q13, [x2, #208]
+	stp q14, q15, [x2, #240]
+
 	/* context to swap to is in x1 so... we move to x0 and call setcontext */
 	/* store our link register in x28 */
 	mov	x28, x30

arch/arm/defs.h

@@ -2,8 +2,10 @@
 
 #define REG_SZ		(4)
 #define MCONTEXT_GREGS	(32)
+#define VFP_MAGIC_OFFSET (232)
+#define VFP_D8_OFFSET (304)
 
-#define TYPE(__proc)
+#define TYPE(__proc)	.type	__proc, %function;
 
 #define FETCH_LINKPTR(dest) \
 	asm("movs    %0, r4" : "=r" ((dest)))

arch/arm/getcontext.S

@@ -22,6 +22,27 @@ FUNC(libucontext_getcontext)
 	str	r13, [r0, #REG_OFFSET(13)]
 	str	r14, [r0, #REG_OFFSET(15)]
 
+#ifndef FORCE_SOFT_FLOAT
+#ifndef FORCE_HARD_FLOAT
+        /* test for vfp, set kernel-defined magic number in uc_regspace */
+        push    {r0-r1,fp,lr}
+        mov     r0, #16
+        bl      getauxval
+        tst     r0, #64
+        pop     {r0-r1,fp,lr}
+	moveq	r2, #0
+	ldrne	r2, =#0x56465001
+	str	r2, [r0, #VFP_MAGIC_OFFSET]
+        beq     1f
+#endif
+	/* if vfp detected, save d8-d15 */
+	.fpu	vfp
+	add	r1, r0, #VFP_D8_OFFSET
+	vstmia	r1, {d8-d15}
+	.fpu	softvfp
+1:
+#endif
+
 	/* return 0 */
 	mov	r0, #0
 	mov	pc, lr

arch/arm/include/libucontext/bits.h

@@ -23,6 +23,8 @@ typedef struct libucontext_ucontext {
 	struct libucontext_ucontext *uc_link;
 	libucontext_stack_t uc_stack;
 	libucontext_mcontext_t uc_mcontext;
+	unsigned long uc_sigmask[128 / sizeof(long)];
+	unsigned long long uc_regspace[64];
 } libucontext_ucontext_t;
 
 #endif

arch/arm/setcontext.S

@@ -16,6 +16,22 @@ ALIAS(setcontext, libucontext_setcontext)
 ALIAS(__setcontext, libucontext_setcontext)
 
 FUNC(libucontext_setcontext)
+#ifndef FORCE_SOFT_FLOAT
+#ifndef FORCE_HARD_FLOAT
+	/* test for vfp magic number set by getcontext */
+	ldr	r2, [r0, #VFP_MAGIC_OFFSET]
+	ldr	r3, =#0x56465001
+	cmp	r2, r3
+        bne     1f
+#endif
+	/* if vfp in use, restore d8-d15 from uc_regspace */
+	.fpu	vfp
+	add	r14, r0, #VFP_D8_OFFSET
+	vldmia	r14, {d8-d15}
+	.fpu 	softvfp
+1:
+#endif
+
 	/* copy all of the current registers into the ucontext structure */
 	add	r14, r0, #REG_OFFSET(0)
 	ldmia	r14, {r0-r12}

arch/arm/swapcontext.S

@@ -22,6 +22,26 @@ FUNC(libucontext_swapcontext)
 	str	r13, [r0,#REG_OFFSET(13)]
 	str	r14, [r0,#REG_OFFSET(15)]
 
+#ifndef FORCE_SOFT_FLOAT
+#ifndef FORCE_HARD_FLOAT
+	/* test for vfp magic number, copy to other ucontext */
+	ldr	r3, [r1, #VFP_MAGIC_OFFSET]
+	ldr	r4, =#0x56465001
+	str	r3, [r0, #VFP_MAGIC_OFFSET]
+	cmp	r3, r4
+	bne	1f
+#endif
+	/* if vfp in use, save and restore d8-d15 */
+	.fpu	vfp
+	add	r2, r0, #VFP_D8_OFFSET
+	vstmia	r2, {d8-d15}
+
+	add	r14, r1, #VFP_D8_OFFSET
+	vldmia	r14, {d8-d15}
+	.fpu	softvfp
+1:
+#endif
+
 	/* load new registers from the second ucontext structure */
 	add	r14, r1, #REG_OFFSET(0)
 	ldmia	r14, {r0-r12}

arch/common/common-trampoline.c

@@ -18,7 +18,7 @@ __attribute__ ((visibility ("hidden")))
 void
 libucontext_trampoline(void)
 {
-	register libucontext_ucontext_t *uc_link;
+	register libucontext_ucontext_t *uc_link = NULL;
 
 	FETCH_LINKPTR(uc_link);
 

arch/loongarch64/defs.h

@@ -0,0 +1,76 @@
+#ifndef __ARCH_LOONGARCH64_DEFS_H
+#define __ARCH_LOONGARCH64_DEFS_H
+
+#define REG_SZ		(8)
+
+#define REG_R0		(0)
+#define REG_R1		(1)
+#define REG_R2		(2)
+#define REG_R3		(3)
+#define REG_R4		(4)
+#define REG_R5		(5)
+#define REG_R6		(6)
+#define REG_R7		(7)
+#define REG_R8		(8)
+#define REG_R9		(9)
+#define REG_R10		(10)
+#define REG_R11		(11)
+#define REG_R12		(12)
+#define REG_R13		(13)
+#define REG_R14		(14)
+#define REG_R15		(15)
+#define REG_R16		(16)
+#define REG_R17		(17)
+#define REG_R18		(18)
+#define REG_R19		(19)
+#define REG_R20		(20)
+#define REG_R21		(21)
+#define REG_R22		(22)
+#define REG_R23		(23)
+#define REG_R24		(24)
+#define REG_R25		(25)
+#define REG_R26		(26)
+#define REG_R27		(27)
+#define REG_R28		(28)
+#define REG_R29		(29)
+#define REG_R30		(30)
+#define REG_R31		(31)
+
+/* $a0 is $4 , also $v0, same as $5, $a1 and $v1*/
+#define REG_A0		(4)
+
+/* stack pointer is actually $3 */
+#define REG_SP		(3)
+
+/* frame pointer is actually $22 */
+#define REG_FP		(22)
+
+/* offset to mc_gregs in ucontext_t */
+#define MCONTEXT_GREGS	(48)
+
+/* offset to PC in ucontext_t */
+#define MCONTEXT_PC	(40)
+
+/* offset to uc_link in ucontext_t */
+#define UCONTEXT_UC_LINK	(8)
+
+/* offset to uc_stack.ss_sp in ucontext_t */
+#define UCONTEXT_STACK_PTR	(16)
+
+/* offset to uc_stack.ss_size in ucontext_t */
+#define UCONTEXT_STACK_SIZE	(32)
+
+/* Stack alignment, from Kernel source */
+#define ALSZ		15
+#define ALMASK		~15
+#define FRAMESZ		(((LOCALSZ * REG_SZ) + ALSZ) & ALMASK)
+
+#define PUSH_FRAME(__proc)	\
+	addi.d		$sp, $sp, -FRAMESZ;
+
+#define POP_FRAME(__proc)	\
+	addi.d		$sp, $sp, FRAMESZ;
+
+#include <common-defs.h>
+
+#endif

arch/loongarch64/freestanding/bits.h

@@ -0,0 +1,43 @@
+#ifndef LIBUCONTEXT_BITS_H
+#define LIBUCONTEXT_BITS_H
+
+typedef unsigned long long libucontext_greg_t, libucontext_gregset_t[32];
+
+/* Container for all general registers.  */
+typedef __loongarch_mc_gp_state gregset_t;
+
+/* Container for floating-point state.  */
+typedef union __loongarch_mc_fp_state fpregset_t;
+
+union __loongarch_mc_fp_state {
+    unsigned int   __val32[256 / 32];
+    unsigned long long   __val64[256 / 64];
+};
+
+typedef struct mcontext_t {
+    unsigned long long   __pc;
+    unsigned long long   __gregs[32];
+    unsigned int   __flags;
+
+    unsigned int   __fcsr;
+    unsigned int   __vcsr;
+    unsigned long long   __fcc;
+    union __loongarch_mc_fp_state    __fpregs[32] __attribute__((__aligned__ (32)));
+
+    unsigned int   __reserved;
+} mcontext_t;
+
+typedef struct {
+	void *ss_sp;
+	int ss_flags;
+	size_t ss_size;
+} libucontext_stack_t;
+
+typedef struct libucontext_ucontext {
+	unsigned long uc_flags;
+	struct libucontext_ucontext *uc_link;
+	libucontext_stack_t uc_stack;
+	libucontext_mcontext_t uc_mcontext;
+} libucontext_ucontext_t;
+
+#endif

arch/loongarch64/getcontext.S

@@ -0,0 +1,46 @@
+/*
+ * Copyright (c) 2021 Peng Fan <fanpeng@loongson.cn>
+ *
+ * Permission to use, copy, modify, and/or distribute this software for any
+ * purpose with or without fee is hereby granted, provided that the above
+ * copyright notice and this permission notice appear in all copies.
+ *
+ * This software is provided 'as is' and without any warranty, express or
+ * implied.  In no event shall the authors be liable for any damages arising
+ * from the use of this software.
+ */
+
+#define LOCALSZ (1)
+
+#include "defs.h"
+
+ALIAS(getcontext, libucontext_getcontext)
+
+FUNC(libucontext_getcontext)
+	/* copy $sp, $fp to temporary registers so we don't clobber them */
+	move	$a2, $sp
+	move	$a3, $fp
+
+	PUSH_FRAME(libucontext_getcontext)
+
+	/* set registers */
+	st.d	$s0, $a0, REG_OFFSET(23)
+	st.d	$s1, $a0, REG_OFFSET(24)
+	st.d	$s2, $a0, REG_OFFSET(25)
+	st.d	$s3, $a0, REG_OFFSET(26)
+	st.d	$s4, $a0, REG_OFFSET(27)
+	st.d	$s5, $a0, REG_OFFSET(28)
+	st.d	$s6, $a0, REG_OFFSET(29)
+	st.d	$s7, $a0, REG_OFFSET(30)
+	st.d	$s8, $a0, REG_OFFSET(31)
+
+	st.d	$a2, $a0, REG_OFFSET(3)
+	st.d	$a3, $a0, REG_OFFSET(22)
+	st.d	$ra, $a0, REG_OFFSET(1)
+
+	st.d	$ra, $a0, (MCONTEXT_PC)
+
+	POP_FRAME(libucontext_getcontext)
+
+	jr	$ra
+END(libucontext_getcontext)

arch/loongarch64/makecontext.S

@@ -0,0 +1,108 @@
+/*
+ * Copyright (c) 2021 Peng Fan <fanpeng@loongson.cn>
+ *
+ * Permission to use, copy, modify, and/or distribute this software for any
+ * purpose with or without fee is hereby granted, provided that the above
+ * copyright notice and this permission notice appear in all copies.
+ *
+ * This software is provided 'as is' and without any warranty, express or
+ * implied.  In no event shall the authors be liable for any damages arising
+ * from the use of this software.
+ */
+
+#include "defs.h"
+
+#define LOCALSZ (6)
+
+#define A3_OFF (FRAMESZ - (5 * REG_SZ))
+#define A4_OFF (FRAMESZ - (4 * REG_SZ))
+#define A5_OFF (FRAMESZ - (3 * REG_SZ))
+#define A6_OFF (FRAMESZ - (2 * REG_SZ))
+#define A7_OFF (FRAMESZ - (1 * REG_SZ))
+
+ALIAS(makecontext, libucontext_makecontext)
+
+FUNC(libucontext_makecontext)
+	PUSH_FRAME(libucontext_makecontext)
+
+	move	$t5, $a0
+	move	$t4, $a1
+
+	/* store $a3 through $a7 to the stack frame. */
+	st.d	$a3, $sp, A3_OFF
+	st.d	$a4, $sp, A4_OFF
+	st.d	$a5, $sp, A5_OFF
+	st.d	$a6, $sp, A6_OFF
+	st.d	$a7, $sp, A7_OFF
+
+	/* set $zero in the mcontext to 1. */
+	addi.d	$v0, $zero, 1
+	st.d	$v0, $t5, REG_OFFSET(0)
+
+	/* ensure the stack is aligned on a quad-word boundary. */
+	ld.d	$t0, $t5, UCONTEXT_STACK_PTR
+	ld.d	$t2, $t5, UCONTEXT_STACK_SIZE
+	/* the third argument(from zero), that's the first argument of func() */
+	addi.d	$t1, $sp, A3_OFF
+	add.d	$t0, $t0, $t2
+
+	addi.d	$t7, $zero, ALMASK
+	and	$t0, $t0, $t7
+
+	/* number of args */
+	beq	$a2, $zero, no_more_arguments
+	bltu	$a2, $zero, no_more_arguments
+
+	/* store register arguments. */
+	addi.d	$t2, $t5, MCONTEXT_GREGS + (4 * REG_SZ)
+	move	$t3, $zero
+
+store_register_arg:
+	addi.d	$t3, $t3, 1
+	ld.d	$v1, $t1, 0
+	addi.d	$t1, $t1, REG_SZ
+	st.d	$v1, $t2, 0
+	addi.d	$t2, $t2, REG_SZ
+	addi.d	$t6, $zero, 8
+	bltu	$t3, $t6, store_register_arg
+	bgeu	$t3, $a2, no_more_arguments
+
+	/* make room for stack arguments. */
+	sub.d	$t2, $a2, $t3
+
+	addi.d	$t6, $zero, 3
+	sll.d	$t2, $t2, $t6
+
+	sub.d	$t0, $t0, $t2
+
+	addi.d	$t6, $zero, ALMASK
+	and	$t0, $t0, $t6
+
+	/* store stack arguments. */
+	move	$t2, $t0
+
+store_stack_arg:
+	addi.d	$t3, $t3, 1
+	ld.d	$v1, $t1, 0
+	addi.d	$t1, $t1, REG_SZ
+	st.d	$v1, $t2, 0
+	addi.d	$t2, $t2, REG_SZ
+	bltu	$t3, $a2, store_stack_arg
+
+no_more_arguments:
+	/* trampoline setup. */
+	la.got	$t8, libucontext_trampoline
+
+	ld.d	$v1, $t5, UCONTEXT_UC_LINK
+	st.d	$v1, $t5, REG_OFFSET(23)
+
+	st.d	$t0, $t5, REG_OFFSET(3)
+
+	st.d	$t8, $t5, REG_OFFSET(1)
+
+	st.d	$t4, $t5, MCONTEXT_PC
+
+	POP_FRAME(libucontext_makecontext)
+
+	jr	$ra
+END(libucontext_makecontext)

arch/loongarch64/setcontext.S

@@ -0,0 +1,55 @@
+/*
+ * Copyright (c) 2021 Peng Fan <fanpeng@loongson.cn>
+ *
+ * Permission to use, copy, modify, and/or distribute this software for any
+ * purpose with or without fee is hereby granted, provided that the above
+ * copyright notice and this permission notice appear in all copies.
+ *
+ * This software is provided 'as is' and without any warranty, express or
+ * implied.  In no event shall the authors be liable for any damages arising
+ * from the use of this software.
+ */
+
+#define LOCALSZ (1)
+
+#include "defs.h"
+
+ALIAS(setcontext, libucontext_setcontext)
+
+FUNC(libucontext_setcontext)
+	PUSH_FRAME(libucontext_setcontext)
+
+	/* move the context to $v0, in LA, $v0 = $a0 = $4 */
+	move	$t5, $a0
+
+	/* load the registers */
+	ld.d	$a0, $t5, REG_OFFSET(4)
+	ld.d	$a1, $t5, REG_OFFSET(5)
+	ld.d	$a2, $t5, REG_OFFSET(6)
+	ld.d	$a3, $t5, REG_OFFSET(7)
+	ld.d	$a4, $t5, REG_OFFSET(8)
+	ld.d	$a5, $t5, REG_OFFSET(9)
+	ld.d	$a6, $t5, REG_OFFSET(10)
+	ld.d	$a7, $t5, REG_OFFSET(11)
+
+	ld.d	$s0, $t5, REG_OFFSET(23)
+	ld.d	$s1, $t5, REG_OFFSET(24)
+	ld.d	$s2, $t5, REG_OFFSET(25)
+	ld.d	$s3, $t5, REG_OFFSET(26)
+	ld.d	$s4, $t5, REG_OFFSET(27)
+	ld.d	$s5, $t5, REG_OFFSET(28)
+	ld.d	$s6, $t5, REG_OFFSET(29)
+	ld.d	$s7, $t5, REG_OFFSET(30)
+	ld.d	$s8, $t5, REG_OFFSET(31)
+
+	ld.d	$sp, $t5, REG_OFFSET(3)
+	ld.d	$fp, $t5, REG_OFFSET(22)
+	ld.d	$ra, $t5, REG_OFFSET(1)
+
+	ld.d	$t8, $t5, (MCONTEXT_PC)
+
+	jr	$t8
+	move	$v0, $zero
+
+	POP_FRAME(libucontext_setcontext)
+END(libucontext_setcontext)

arch/loongarch64/startcontext.S

@@ -0,0 +1,33 @@
+/*
+ * Copyright (c) 2021 Peng Fan <fanpeng@loongson.cn>
+ *
+ * Permission to use, copy, modify, and/or distribute this software for any
+ * purpose with or without fee is hereby granted, provided that the above
+ * copyright notice and this permission notice appear in all copies.
+ *
+ * This software is provided 'as is' and without any warranty, express or
+ * implied.  In no event shall the authors be liable for any damages arising
+ * from the use of this software.
+ */
+
+#define LOCALSZ (4)
+
+#include "defs.h"
+
+FUNC(libucontext_trampoline)
+
+	/* call setcontext */
+	move	$a0, $s0
+	/* we receive our initial ucontext in $s0, so if $s0 is nil, bail */
+	beqz	$s0, no_linked_context
+
+	la.got	$t8, libucontext_setcontext
+
+	jr	$t8
+
+no_linked_context:
+	move	$a0, $zero
+	la.global	$t8, exit
+	jr	$t8
+
+END(libucontext_trampoline)

arch/loongarch64/swapcontext.S

@@ -0,0 +1,89 @@
+/*
+ * Copyright (c) 2021 Peng Fan <fanpeng@loongson.cn>
+ *
+ * Permission to use, copy, modify, and/or distribute this software for any
+ * purpose with or without fee is hereby granted, provided that the above
+ * copyright notice and this permission notice appear in all copies.
+ *
+ * This software is provided 'as is' and without any warranty, express or
+ * implied.  In no event shall the authors be liable for any damages arising
+ * from the use of this software.
+ */
+
+#define	LOCALSZ	(4)
+
+#include "defs.h"
+
+#define A1_OFFSET (FRAMESZ - (1 * REG_SZ))
+
+ALIAS(swapcontext, libucontext_swapcontext)
+
+FUNC(libucontext_swapcontext)
+	/* copy $sp, $fp to temporary registers so we don't clobber them */
+	move	$a3, $sp
+	move	$a4, $fp
+
+	move	$t5, $a0
+
+	PUSH_FRAME(libucontext_swapcontext)
+
+	/* set registers */
+	st.d	$s0, $t5, REG_OFFSET(23)
+	st.d	$s1, $t5, REG_OFFSET(24)
+	st.d	$s2, $t5, REG_OFFSET(25)
+	st.d	$s3, $t5, REG_OFFSET(26)
+	st.d	$s4, $t5, REG_OFFSET(27)
+	st.d	$s5, $t5, REG_OFFSET(28)
+	st.d	$s6, $t5, REG_OFFSET(29)
+	st.d	$s7, $t5, REG_OFFSET(30)
+	st.d	$s8, $t5, REG_OFFSET(31)
+
+	st.d	$a3, $t5, REG_OFFSET(3)
+	st.d	$a4, $t5, REG_OFFSET(22)
+	st.d	$ra, $t5, REG_OFFSET(1)
+
+	st.d	$ra, $t5, (MCONTEXT_PC)
+
+	/* copy new context address in $a1 to stack */
+	st.d	$a1, $sp, A1_OFFSET
+
+	/* load new context address into $v0 */
+	ld.d	$t4, $sp, A1_OFFSET
+
+	/* load the registers */
+	ld.d	$a0, $t4, REG_OFFSET(4)
+	ld.d	$a1, $t4, REG_OFFSET(5)
+	ld.d	$a2, $t4, REG_OFFSET(6)
+	ld.d	$a3, $t4, REG_OFFSET(7)
+	ld.d	$a4, $t4, REG_OFFSET(8)
+	ld.d	$a5, $t4, REG_OFFSET(9)
+	ld.d	$a6, $t4, REG_OFFSET(10)
+	ld.d	$a7, $t4, REG_OFFSET(11)
+
+	ld.d	$s0, $t4, REG_OFFSET(23)
+	ld.d	$s1, $t4, REG_OFFSET(24)
+	ld.d	$s2, $t4, REG_OFFSET(25)
+	ld.d	$s3, $t4, REG_OFFSET(26)
+	ld.d	$s4, $t4, REG_OFFSET(27)
+	ld.d	$s5, $t4, REG_OFFSET(28)
+	ld.d	$s6, $t4, REG_OFFSET(29)
+	ld.d	$s7, $t4, REG_OFFSET(30)
+	ld.d	$s8, $t4, REG_OFFSET(31)
+
+	ld.d	$sp, $t4, REG_OFFSET(3)
+	ld.d	$fp, $t4, REG_OFFSET(22)
+	ld.d	$ra, $t4, REG_OFFSET(1)
+
+	ld.d	$t8, $t4, (MCONTEXT_PC)
+
+	jr	$t8
+	move	$v0, $zero
+
+fail:
+	la.global	$t8, exit
+
+	POP_FRAME(libucontext_swapcontext)
+
+	jirl	$ra, $t8, 0
+	move	$v0, $zero
+END(libucontext_swapcontext)

arch/or1k/defs.h

@@ -0,0 +1,22 @@
+#ifndef __ARCH_OR1K_DEFS_H
+#define __ARCH_OR1K_DEFS_H
+
+#define REG_SZ		(4)
+#define MCONTEXT_GREGS	(20)
+
+#define REG_SP		(1)
+#define REG_FP		(2)
+#define REG_RA		(9)
+#define REG_SA		(11)
+#define REG_LR		(14)
+#define REG_PC		(33)
+#define REG_SR		(34)
+
+#define PC_OFFSET	REG_OFFSET(REG_PC)
+
+#define FETCH_LINKPTR(dest) \
+	asm("l.ori %0, r14, 0" :: "r" ((dest)))
+
+#include "common-defs.h"
+
+#endif

arch/or1k/getcontext.S

@@ -0,0 +1,39 @@
+/*
+ * Copyright (c) 2022 Ariadne Conill <ariadne@dereferenced.org>
+ *
+ * Permission to use, copy, modify, and/or distribute this software for any
+ * purpose with or without fee is hereby granted, provided that the above
+ * copyright notice and this permission notice appear in all copies.
+ *
+ * This software is provided 'as is' and without any warranty, express or
+ * implied.  In no event shall the authors be liable for any damages arising
+ * from the use of this software.
+ */
+
+#include "defs.h"
+
+ALIAS(getcontext, libucontext_getcontext)
+ALIAS(__getcontext, libucontext_getcontext)
+
+FUNC(libucontext_getcontext)
+	l.sw		REG_OFFSET(1)(r3), r1			/* store r1 and r2 */
+	l.sw		REG_OFFSET(2)(r3), r2
+
+	l.sw		REG_OFFSET(9)(r3), r9			/* store r9 to both r9 and r11 in the context */
+	l.sw		REG_OFFSET(11)(r3), r9
+
+	l.sw		REG_OFFSET(10)(r3), r10			/* store r10 for TLS */
+
+	l.sw		REG_OFFSET(14)(r3), r14			/* store r14 through r30 even */
+	l.sw		REG_OFFSET(16)(r3), r16
+	l.sw		REG_OFFSET(18)(r3), r18
+	l.sw		REG_OFFSET(20)(r3), r20
+	l.sw		REG_OFFSET(22)(r3), r22
+	l.sw		REG_OFFSET(24)(r3), r24
+	l.sw		REG_OFFSET(26)(r3), r26
+	l.sw		REG_OFFSET(28)(r3), r28
+	l.sw		REG_OFFSET(30)(r3), r30
+
+	l.jr		r9
+	l.ori		r11, r0, 0
+END(libucontext_getcontext)

arch/or1k/include/libucontext/bits.h

@@ -0,0 +1,28 @@
+#ifndef LIBUCONTEXT_BITS_H
+#define LIBUCONTEXT_BITS_H
+
+typedef struct sigaltstack {
+	void *ss_sp;
+	int ss_flags;
+	size_t ss_size;
+} libucontext_stack_t;
+
+typedef int libucontext_greg_t, libucontext_gregset_t[32];
+
+typedef struct {
+	struct {
+		libucontext_gregset_t gpr;
+		libucontext_greg_t pc;
+		libucontext_greg_t sr;
+	} regs;
+	unsigned long oldmask;
+} libucontext_mcontext_t;
+
+typedef struct libucontext_ucontext {
+	unsigned long uc_flags;
+	struct libucontext_ucontext *uc_link;
+	libucontext_stack_t uc_stack;
+	libucontext_mcontext_t uc_mcontext;
+} libucontext_ucontext_t;
+
+#endif

arch/or1k/makecontext.c

@@ -0,0 +1,61 @@
+/*
+ * Copyright (c) 2022 Ariadne Conill <ariadne@dereferenced.org>
+ *
+ * Permission to use, copy, modify, and/or distribute this software for any
+ * purpose with or without fee is hereby granted, provided that the above
+ * copyright notice and this permission notice appear in all copies.
+ *
+ * This software is provided 'as is' and without any warranty, express or
+ * implied.  In no event shall the authors be liable for any damages arising
+ * from the use of this software.
+ */
+
+#include <stddef.h>
+#include <stdarg.h>
+#include <string.h>
+#include <stdint.h>
+#include <stdio.h>
+#include "defs.h"
+#include <libucontext/libucontext.h>
+
+
+extern void libucontext_trampoline(void);
+
+
+void
+libucontext_makecontext(libucontext_ucontext_t *ucp, void (*func)(void), int argc, ...)
+{
+	libucontext_greg_t *sp;
+	va_list va;
+	int i;
+
+	/* set up and align the stack. */
+	sp = (libucontext_greg_t *) ((uintptr_t) ucp->uc_stack.ss_sp + ucp->uc_stack.ss_size);
+	sp -= argc < 6 ? 0 : (argc - 6);
+	sp = (libucontext_greg_t *) (((uintptr_t) sp & ~0x3));
+
+	/* set up the ucontext structure */
+	ucp->uc_mcontext.regs.gpr[REG_SP] = (libucontext_greg_t) sp;
+	ucp->uc_mcontext.regs.gpr[REG_RA] = (libucontext_greg_t) &libucontext_trampoline;
+	ucp->uc_mcontext.regs.gpr[REG_FP] = 0;
+	ucp->uc_mcontext.regs.gpr[REG_SA] = (libucontext_greg_t) func;
+	ucp->uc_mcontext.regs.gpr[REG_LR] = (libucontext_greg_t) ucp->uc_link;
+
+	va_start(va, argc);
+
+	/* args less than argv[6] have dedicated registers, else they overflow onto stack */
+	for (i = 0; i < argc; i++)
+	{
+		if (i < 6)
+			ucp->uc_mcontext.regs.gpr[i + 3] = va_arg (va, libucontext_greg_t);
+		else
+			sp[i - 6] = va_arg (va, libucontext_greg_t);
+	}
+
+	va_end(va);
+}
+
+#ifdef EXPORT_UNPREFIXED
+extern __typeof(libucontext_makecontext) makecontext __attribute__((weak, __alias__("libucontext_makecontext")));
+extern __typeof(libucontext_makecontext) __makecontext __attribute__((weak, __alias__("libucontext_makecontext")));
+#endif

arch/or1k/setcontext.S

@@ -0,0 +1,48 @@
+/*
+ * Copyright (c) 2022 Ariadne Conill <ariadne@dereferenced.org>
+ *
+ * Permission to use, copy, modify, and/or distribute this software for any
+ * purpose with or without fee is hereby granted, provided that the above
+ * copyright notice and this permission notice appear in all copies.
+ *
+ * This software is provided 'as is' and without any warranty, express or
+ * implied.  In no event shall the authors be liable for any damages arising
+ * from the use of this software.
+ */
+
+#include "defs.h"
+
+ALIAS(setcontext, libucontext_setcontext)
+ALIAS(__setcontext, libucontext_setcontext)
+
+FUNC(libucontext_setcontext)
+	l.ori		r30, r3, 0				/* avoid clobbering r3 by copying to r30 */
+
+	l.lwz		r3, REG_OFFSET(3)(r30)			/* restore r3-r8 (argument registers) */
+	l.lwz		r4, REG_OFFSET(4)(r30)
+	l.lwz		r5, REG_OFFSET(5)(r30)
+	l.lwz		r6, REG_OFFSET(6)(r30)
+	l.lwz		r7, REG_OFFSET(7)(r30)
+	l.lwz		r8, REG_OFFSET(8)(r30)
+
+	l.lwz		r1, REG_OFFSET(1)(r30)			/* restore stack/frame pointers */
+	l.lwz		r2, REG_OFFSET(2)(r30)
+
+	l.lwz		r9, REG_OFFSET(9)(r30)			/* restore link register and starting address register */
+	l.lwz		r11, REG_OFFSET(11)(r30)
+
+	l.lwz		r10, REG_OFFSET(10)(r30)		/* restore TLS register */
+
+	l.lwz		r14, REG_OFFSET(14)(r30)		/* restore r14-r30, even only */
+	l.lwz		r16, REG_OFFSET(16)(r30)
+	l.lwz		r18, REG_OFFSET(18)(r30)
+	l.lwz		r20, REG_OFFSET(20)(r30)
+	l.lwz		r22, REG_OFFSET(22)(r30)
+	l.lwz		r24, REG_OFFSET(24)(r30)
+	l.lwz		r26, REG_OFFSET(26)(r30)
+	l.lwz		r28, REG_OFFSET(28)(r30)
+	l.lwz		r30, REG_OFFSET(30)(r30)
+
+	l.jr		r11					/* jump to new starting address */
+	l.ori		r11, r0, 0
+END(libucontext_setcontext)

arch/or1k/swapcontext.S

@@ -0,0 +1,68 @@
+/*
+ * Copyright (c) 2022 Ariadne Conill <ariadne@dereferenced.org>
+ *
+ * Permission to use, copy, modify, and/or distribute this software for any
+ * purpose with or without fee is hereby granted, provided that the above
+ * copyright notice and this permission notice appear in all copies.
+ *
+ * This software is provided 'as is' and without any warranty, express or
+ * implied.  In no event shall the authors be liable for any damages arising
+ * from the use of this software.
+ */
+
+#include "defs.h"
+
+ALIAS(swapcontext, libucontext_swapcontext)
+ALIAS(__swapcontext, libucontext_swapcontext)
+
+FUNC(libucontext_swapcontext)
+	/* copy context into r3 like getcontext */
+	l.sw		REG_OFFSET(1)(r3), r1			/* store r1 and r2 */
+	l.sw		REG_OFFSET(2)(r3), r2
+
+	l.sw		REG_OFFSET(9)(r3), r9			/* store r9 to both r9 and r11 in the context */
+	l.sw		REG_OFFSET(11)(r3), r9
+
+	l.sw		REG_OFFSET(10)(r3), r10			/* store r10 for TLS */
+
+	l.sw		REG_OFFSET(14)(r3), r14			/* store r14 through r30 even */
+	l.sw		REG_OFFSET(16)(r3), r16
+	l.sw		REG_OFFSET(18)(r3), r18
+	l.sw		REG_OFFSET(20)(r3), r20
+	l.sw		REG_OFFSET(22)(r3), r22
+	l.sw		REG_OFFSET(24)(r3), r24
+	l.sw		REG_OFFSET(26)(r3), r26
+	l.sw		REG_OFFSET(28)(r3), r28
+	l.sw		REG_OFFSET(30)(r3), r30
+
+	/* set the new context from r4 */
+	l.ori		r30, r4, 0				/* copy r4 to r30 to avoid clobbering */
+
+	l.lwz		r3, REG_OFFSET(3)(r30)			/* restore r3-r8 (argument registers) */
+	l.lwz		r4, REG_OFFSET(4)(r30)
+	l.lwz		r5, REG_OFFSET(5)(r30)
+	l.lwz		r6, REG_OFFSET(6)(r30)
+	l.lwz		r7, REG_OFFSET(7)(r30)
+	l.lwz		r8, REG_OFFSET(8)(r30)
+
+	l.lwz		r1, REG_OFFSET(1)(r30)			/* restore stack/frame pointers */
+	l.lwz		r2, REG_OFFSET(2)(r30)
+
+	l.lwz		r9, REG_OFFSET(9)(r30)			/* restore link register and starting address register */
+	l.lwz		r11, REG_OFFSET(11)(r30)
+
+	l.lwz		r10, REG_OFFSET(10)(r30)		/* restore TLS register */
+
+	l.lwz		r14, REG_OFFSET(14)(r30)		/* restore r14-r30, even only */
+	l.lwz		r16, REG_OFFSET(16)(r30)
+	l.lwz		r18, REG_OFFSET(18)(r30)
+	l.lwz		r20, REG_OFFSET(20)(r30)
+	l.lwz		r22, REG_OFFSET(22)(r30)
+	l.lwz		r24, REG_OFFSET(24)(r30)
+	l.lwz		r26, REG_OFFSET(26)(r30)
+	l.lwz		r28, REG_OFFSET(28)(r30)
+	l.lwz		r30, REG_OFFSET(30)(r30)
+
+	l.jr		r11					/* jump to new starting address */
+	l.ori		r11, r0, 0
+END(libucontext_swapcontext)

arch/or1k/trampoline.c

@@ -0,0 +1,3 @@
+#include "defs.h"
+#include <libucontext/libucontext.h>
+#include "common-trampoline.c"

doc/meson.build

@@ -0,0 +1,21 @@
+scdoc = find_program('scdoc', required: true)
+
+custom_target(
+  'libucontext.3',
+  output: 'libucontext.3',
+  input: 'libucontext.scd',
+  command: [ scdoc ],
+  feed: true,
+  capture: true,
+  install: true,
+  install_dir: get_option('mandir') / 'man3'
+)
+
+if meson.version().version_compare('>=0.61.0')
+  foreach link : [ 'get', 'make', 'set', 'swap' ]
+    install_symlink('libucontext_' + link + 'context.3',
+      pointing_to: 'libucontext.3',
+      install_dir: get_option('mandir') / 'man3'
+    )
+  endforeach
+endif

include/libucontext/libucontext.h

@@ -4,9 +4,17 @@
 #include <stddef.h>
 #include <libucontext/bits.h>
 
+#ifdef __cplusplus
+extern "C" {
+#endif
+
 int  libucontext_getcontext(libucontext_ucontext_t *);
 void libucontext_makecontext(libucontext_ucontext_t *, void (*)(), int, ...);
 int  libucontext_setcontext(const libucontext_ucontext_t *);
 int  libucontext_swapcontext(libucontext_ucontext_t *, const libucontext_ucontext_t *);
 
+#ifdef __cplusplus
+}
+#endif
+
 #endif

libucontext.pc.in

@@ -1,8 +1,9 @@
-libdir=@LIBUCONTEXT_LIBDIR@
+libdir=@LIBUCONTEXT_SHARED_LIBDIR@
+static_libdir=@LIBUCONTEXT_STATIC_LIBDIR@
 includedir=@LIBUCONTEXT_INCLUDEDIR@
 
 Name: libucontext
 Version: @LIBUCONTEXT_VERSION@
 Description: ucontext library implementation (standalone)
-Libs: -L${libdir} -lucontext
+Libs: -L${libdir} -L${static_libdir} -lucontext
 Cflags: -I${includedir}

meson.build

@@ -1,12 +1,16 @@
 project(
   'libucontext',
   'c',
-  meson_version : '>=0.55.0',
+  meson_version : '>=0.59.0',
   default_options: ['c_std=gnu11', 'default_library=both'],
   version : run_command('head', files('VERSION')).stdout()
 )
 
-cpu = host_machine.cpu_family()
+cpu = get_option('cpu')
+if cpu == ''
+  cpu = host_machine.cpu_family()
+endif
+
 if cpu == 'sh4'
   cpu = 'sh'
 endif
@@ -140,9 +144,8 @@ endif
 # Docs
 # ====
 
-# TODO: meson.build for docs
-if not meson.is_subproject()
-  #subdir('docs')
+if not meson.is_subproject() and get_option('docs')
+  subdir('doc')
 endif
 
 # ==========

meson_options.txt

@@ -1,4 +1,8 @@
 option('freestanding', type : 'boolean', value : false,
        description: 'Do not use system headers')
 option('export_unprefixed', type : 'boolean', value : true,
-       description: 'Export POSIX 2004 ucontext names as alises')
+       description: 'Export POSIX 2004 ucontext names as alises')
+option('cpu', type : 'string', value : '',
+       description: 'Target CPU architecture for cross compile')
+option('docs', type : 'boolean', value : false,
+       description: 'Build and install man pages')