proxmox-mirrors/wasi-libc
1
0
Fork 0
mirror of https://git.proxmox.com/git/wasi-libc synced 2025-08-03 05:47:44 +00:00
Code Issues Actions Packages Projects Releases Wiki Activity
160 Commits 3 Branches 0 Tags 3 MiB
C 93.9%
Assembly 3.3%
Makefile 1.4%
Rust 0.8%
Awk 0.3%
Other 0.2%
d9066a87c0
Go to file
Dan Gohman d9066a87c0 Add support for __main_argc_argv. 
This adds support for the `__main_argc_argv` change, while preserving
compatibility with `__original_main`. This is needed by the LTO build
because the `__original_main` hack works in LLVM codegen, which is after
LTO. The `__main_argc_argv` change is implemented in clang, which makes
it properly visible to LTO.
2020-02-27 13:09:38 -08:00
.github/workflows fix macos filename, use https 2020-02-20 09:23:32 -08:00
basics Add support for __main_argc_argv. 2020-02-27 13:09:38 -08:00
dlmalloc Convert more wasi-libc code to //-style comments. (#153) 2020-01-16 16:00:37 -08:00
expected/wasm32-wasi Add support for __main_argc_argv. 2020-02-27 13:09:38 -08:00
libc-bottom-half Add support for __main_argc_argv. 2020-02-27 13:09:38 -08:00
libc-top-half Update to musl 1.2.0. 2020-02-26 10:23:05 -08:00
tools/wasi-headers point at WASI with tagged unions merged into master 2020-02-24 11:36:05 -08:00
.gitattributes Correct the version of #136 on master (#141) 2019-11-21 20:55:26 -08:00
.gitignore gitignore build 2019-04-19 11:16:25 -07:00
.gitmodules Correct the version of #136 on master (#141) 2019-11-21 20:55:26 -08:00
CODE_OF_CONDUCT.md Add a CODE_OF_CONDUCT.md file. (#101) 2019-10-03 14:15:49 +02:00
LICENSE WASI libc prototype implementation. 2019-03-27 07:59:55 -07:00
Makefile Move math source files. (#151) 2019-12-20 15:43:31 -08:00
README.md Update docs to say "libc" rather than "sysroot" where applicable. 2019-08-29 10:27:23 -07:00

README.md

WASI Libc

This is a work in progress. It's usable for many purposes, though the APIs aren't stable yet.

What is this?

It's several things.

First, it's a usable libc. It builds a "libc" which can be used by compilers, such as Clang 8.0, using the wasm32-wasi target. It's a work in progress, but it is already sufficient to run basic programs.

Second, it's a "reference" implementation, which means the interfaces defined here can be used by other tools and libraries, even if they don't use all the actual implementations here. For example, we don't expect everyone will want to use the exact malloc implementation provided here, but tools and libraries using an ABI-compatible malloc interface will be able to interoperate regardless of which actual implementation is used.

Third, it's an example showing the use of the WASI API. The libc functionality is implemented using calls to WASI functions.

Usage

The easiest way to get started with this is to use one of the prepackaged releases.

Building from source

To build a WASI sysroot from source, obtain a WebAssembly-supporting C compiler (currently this is only clang 8+, though we'd like to support other compilers as well), and then run:

make WASM_CC=/path/to/clang/with/wasm/support \
     WASM_AR=/path/to/llvm-ar \
     WASM_NM=/path/to/llvm-nm

This makes a directory called "sysroot", by default. See the top of the Makefile for customization options.

To use the sysroot, use the --sysroot= option:

/path/to/wasm/supporting/c/compiler --sysroot=/path/to/the/newly/built/sysroot ...

to run the compiler using the newly built sysroot.