[wasi-libc.git] / libc-bottom-half / README

"WASI" the WebAssembly System Interface.

WASI libc is conceptually the lower half of a traditional libc implementation.
It provides C interfaces to the low-level WASI syscalls.

This is largely based on [CloudABI], [cloudlibc], and [libpreopen], however we
use just the low-level syscall wrappers rather than all of cloudlibc and
libpreopen, and we have several customizations for use in a WebAssembly sysroot.

[CloudABI]: https://github.com/NuxiNL/cloudabi
[cloudlibc]: https://github.com/NuxiNL/cloudlibc
[libpreopen]: https://github.com/musec/libpreopen

The upstream repositories and versions used here are:

cloudlibc - https://github.com/NuxiNL/cloudlibc 92cb7670f864adc625c24eb214ff1c6d888adf6b
libpreopen - https://github.com/musec/libpreopen 8265fc50b9db3730c250597bdd084f1e728f3e48

Whole files which are unused are omitted. Changes to upstream code are wrapped
in preprocessor directives controlled by the macro `__wasilibc_unmodified_upstream`,
except that CloudABI names have also been renamed to WASI names without annotations.

WASI libc currently depends on the basics and dlmalloc components of reference-sysroot.
Commit	Line	Data
320054e8 DG	1	"WASI" the WebAssembly System Interface.
	2
	3	WASI libc is conceptually the lower half of a traditional libc implementation.
	4	It provides C interfaces to the low-level WASI syscalls.
	5
	6	This is largely based on [CloudABI], [cloudlibc], and [libpreopen], however we
	7	use just the low-level syscall wrappers rather than all of cloudlibc and
	8	libpreopen, and we have several customizations for use in a WebAssembly sysroot.
	9
	10	[CloudABI]: https://github.com/NuxiNL/cloudabi
	11	[cloudlibc]: https://github.com/NuxiNL/cloudlibc
	12	[libpreopen]: https://github.com/musec/libpreopen
	13
	14	The upstream repositories and versions used here are:
	15
	16	cloudlibc - https://github.com/NuxiNL/cloudlibc 92cb7670f864adc625c24eb214ff1c6d888adf6b
	17	libpreopen - https://github.com/musec/libpreopen 8265fc50b9db3730c250597bdd084f1e728f3e48
	18
	19	Whole files which are unused are omitted. Changes to upstream code are wrapped
	20	in preprocessor directives controlled by the macro `__wasilibc_unmodified_upstream`,
	21	except that CloudABI names have also been renamed to WASI names without annotations.
	22
	23	WASI libc currently depends on the basics and dlmalloc components of reference-sysroot.