michael/wasi-sdk-nixos
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

chore: Update README.md

Browse source
This commit is contained in:
Michael Franzl 2025-07-19 20:57:49 +02:00
parent 13ca9e6301
commit 985aa2db8d
Signed by: michael
GPG key ID: F2FA572344C60B07
1 changed files with 15 additions and 5 deletions
Download patch file Download diff file Expand all files Collapse all files

20
README.md
View file

@ -1,25 +1,35 @@
# wasm-sdk # wasi-sdk-nixos
WASM LLVM toolchain and WASI sysroot.
Similar to [WebAssembly/wasi-sdk](https://github.com/WebAssembly/wasi-sdk), but re-implemented for NixOS.
A *Nix*-based SDK for C and C++ development targeting WebAssembly.
## Goals ## Goals
* Lean toolchain leveraging as much as possible from upstream sources. * Lean C/C++ toolchain leveraging as much as possible from upstream sources.
* Basic levels of WASI (no threading, no exceptions). * Basic levels of WASI (no threading, no exceptions).
## Versions ## Versioning
Provided are the upstream versions that WebAssembly/wasi-sdk used mid 2024:
* LLVM: 17 * LLVM: 17
* wasi-libc: 21 * wasi-libc: 21
Future releases may upgrade these upstream versions.
## Usage ## Usage
The package contains all required dependencies in the following build subdirectories: The default package contains all required dependencies in the following package subdirectories:
* `bin`: compilers (`clang`, `clang++`) and linker (`wasm-ld`) * `bin`: compilers (`clang`, `clang++`) and linker (`wasm-ld`)
* `include`: *libc* headers * `include`: *libc* headers
* `include/c++/v1`: *libcxx* headers * `include/c++/v1`: *libcxx* headers
* `lib`: all *libc* and *libcxx* static libraries * `lib`: all *libc* and *libcxx* static libraries
* `lib/wasi`: compiler-rt builtins static library * `lib/wasi`: compiler-rt builtins static library
* `share/wasi-sysroot`: the WASI sysroot
For concrete usage examples, see [michaelfranzl/clang-wasm-browser-starterpack](https://github.com/michaelfranzl/clang-wasm-browser-starterpack).