search

xphung / plan9_webasm

WebAssembly port of Plan9 (fourth edition) libraries, device drivers, file systems and Inferno kernel
MIT License
18 stars 2 forks source link

Build Instructions #2

Open hex-4d5a9000 opened 5 days ago

hex-4d5a9000 commented 5 days ago

Hi @xphung,

I'd like to test out your Plan9 port myself. Would you like to share about how to build this project?

nglibc commented 4 days ago

Hi @hex-4d5a9000, There are build instructions in config.mak, which goes as follows:

# This requires wasm32 clang installed at ~/Downloads/llvm-build/bin/clang
#
#  To build, type:
#   make
#
#  To deploy, use webserver.py script to start mini-webserver with wasm mimetype configured
#  To run the server, type:
#   ./webserver.py
#
#  Then open http://localhost:8001/web/shell.html in Chrome browser

This probably wasn't a good place to put the build instructions, but anyone wanting to build it would need to edit config.mak anyway to suit their system.

In case you were wondering why there was the strange requirement to have clang installed in ~/Downloads/LLVM, this is because at the time (6 years ago), wasm compilers were limited outside of emscriptem, and so this project used the then (new) wasm backend for clang/LLVM (this had to be compiled from source with wasm enabled).

The toolchain for wasm has matured substantially since then, but I can't guarantee this will build with modern tooling. However, I should point you to the pull request from @acomagu last year who seems to have managed to get the project to work in 2023 and even updated the mini-webserver from python2 to python3.