[wasi-libc.git] / libc-top-half / README.md

# WASI libc "top half".

The WASI libc "top half" is conceptually the upper half of a traditional libc
implementation, consisting of C standard library and other relatively
higher-level functionality.

Code in the musl directory is based on musl revision
040c1d16b468c50c04fc94edff521f1637708328, which is v1.2.0, from
git://git.musl-libc.org/musl.

Whole files which are unused are omitted. Changes to upstream code are wrapped
in preprocessor directives controlled by the macro `__wasilibc_unmodified_upstream`.

Some major known missing areas include:
 - threads
 - aio
 - setjmp
 - signals
 - ipc
 - termios
 - nss
 - timezones
 - non-builtin locales
 - TIOCGWINSZ (because cloudabi lacks it; affects isatty, line buffering for stdout)
 - O\_CLOEXEC, O\_NOCTTY (because cloudabi lacks them)
Commit	Line	Data
84c0778b DG	1	# WASI libc "top half".
	2
	3	The WASI libc "top half" is conceptually the upper half of a traditional libc
	4	implementation, consisting of C standard library and other relatively
	5	higher-level functionality.
	6
f41256b6	7	Code in the musl directory is based on musl revision
2408ea94	8	040c1d16b468c50c04fc94edff521f1637708328, which is v1.2.0, from
f41256b6	9	git://git.musl-libc.org/musl.
320054e8 DG	10
	11	Whole files which are unused are omitted. Changes to upstream code are wrapped
	12	in preprocessor directives controlled by the macro `__wasilibc_unmodified_upstream`.
	13
	14	Some major known missing areas include:
	15	- threads
	16	- aio
	17	- setjmp
	18	- signals
	19	- ipc
	20	- termios
	21	- nss
320054e8 DG	22	- timezones
	23	- non-builtin locales
	24	- TIOCGWINSZ (because cloudabi lacks it; affects isatty, line buffering for stdout)
	25	- O\_CLOEXEC, O\_NOCTTY (because cloudabi lacks them)