クリーム色の背景、色付き表示、高コントラスト、大きな文字のほうが読みやすいですか?配色と文字を選ぶと、すべてのページに一度で反映されます。

無料レッスン

ブラウザーの外の WebAssembly

このレッスンのあとで: バイトを読んで、WebAssembly のモジュールに何が入っているかを説明できる。

60分のレッスンコマンド4件WebAssembly ラボ:Wasmtime、WASI のケイパビリティ、WIT コンポーネント、プラグインの上限

どこでも動く小さなファイル

WebAssembly (Wasm) は、プログラムを入れる小さなバイナリ形式です。ランタイムが、届いた先のコンピューターの機械語に変えて動かします。ブラウザーの外では、プラグイン、サーバーレスの関数、コマンドラインの道具をサンドボックスの中で動かします。

今日は Wasmtime でモジュールを動かし、そのバイトを1つずつ読みます。

このレッスンのゴール

メモ

バイトを読んで、WebAssembly のモジュールに何が入っているかを説明できる。

キーワード

ことばいみれい
WebAssemblyどの機械でも動く、プログラムのバイナリ形式
モジュールコンパイルされた WebAssembly のプログラム1つadd.wasm
ランタイムモジュールを読み込んで動かすプログラムwasmtime
サンドボックスプログラムが外に手を出せない囲い
インポートホストがモジュールに渡す関数
セクション.wasm ファイルの、ラベルのついた一部分

学生が入力するセルは、このプレビューでは空白です。

ブラウザーの外で使う理由

ふつうのプログラムは、1種類のプロセッサーと1つの OS 向けに作られます。WebAssembly のモジュールは一度作るだけです。あとはランタイムが、目の前の機械に合わせてコンパイルします。Arm でも Intel でも、Linux でも Windows でも同じです。

しかも小さく、数ミリ秒で起動します。だから、何度も起動するプラグインや関数に向いています。ラボのランタイムは、Bytecode Alliance の Wasmtime です。

Wasmtime のバージョンを見る

コマンド
docker exec wasm wasmtime --version

ここでは表示のみで、実行されません。「ラボを開始」を押すと、自分のラボのターミナルに入力できます。

最初の WASI プログラムを動かす

コマンド
docker exec wasm wasmtime run hello.wat

ここでは表示のみで、実行されません。「ラボを開始」を押すと、自分のラボのターミナルに入力できます。

届くのはインポートしたものだけ

モジュールが持っているのは、自分のメモリーだけです。ファイルを開くことも、時計を読むことも、1バイト送ることもできません。ホストがそのための関数を渡したときだけ、できるようになります。その関数がインポートです。

WASI は WebAssembly System Interface の略です。hello.wat は、WASI から fd_write という関数を1つだけインポートします。これで文字を書けますが、それ以外は何もできません。

例: hello.wat が求めるもの

部分hello.wat では意味
インポートwasi_snapshot_preview1 の fd_writeストリームに書いてよい
メモリー64 KiB のページが1つ自分だけのメモリー
データHello from WebAssemblyメモリーに置いた文字
エクスポート_startWASI のプログラムが始まる所

学生が入力するセルは、このプレビューでは空白です。

.wasm ファイルの中身

.wasm ファイルは、4バイトのマジック 00 61 73 6d で始まります。0 と asm を表す文字です。そのあとに4バイトのバージョンが続きます。

その後ろはセクションの並びです。どれも、id のバイト、サイズ、本体の順です。サイズは LEB128 で書きます。1バイトに7ビットずつ入れ、まだ続くあいだは上のビットを立てます。ラボは wasmbin.py で add.wasm を1バイトずつ組み立てました。

add.wasm をセクションごとに読む

コマンド
docker exec tools python3 steps/sections.py add.wasm

ここでは表示のみで、実行されません。「ラボを開始」を押すと、自分のラボのターミナルに入力できます。

例: add.wasm のセクション

idセクションサイズバイトの意味
1type7バイト関数の型1つ。i32 を2つ受け取り、1つ返す
3function2バイト型0の関数が1つ
7export7バイト関数0を add として公開
10code9バイトlocal.get 0、local.get 1、i32.add、end

学生が入力するセルは、このプレビューでは空白です。

よくある間違い

注意

「WebAssembly のモジュールは小さなコンテナーだ」と考える人がいます。コンテナーは OS のファイルを持ち、カーネルを直接呼びます。モジュールは OS を持たず、インポート以外は何も呼べません。できることはすべてホストが決めます。

手作りの add.wasm を動かす

コマンド
docker exec wasm wasmtime run --invoke add add.wasm 2 3

ここでは表示のみで、実行されません。「ラボを開始」を押すと、自分のラボのターミナルに入力できます。

試そう: 数を LEB128 で書く

コード: python
def uleb(n):
    # 1バイトに7ビットずつ。いちばん上のビットは「まだ続く」の印です。
    out = []
    while True:
        low = n % 128
        n = n // 128
        if n > 0:
            out.append(low + 128)
        else:
            out.append(low)
            return out

for number in [5, 127, 128, 300]:
    text = ""
    for byte in uleb(number):
        text = text + format(byte, "02x") + " "
    print(number, "の LEB128:", text)
# リストに 1000 を足しましょう。何バイト要るでしょうか。

このラボとソースについて: WebAssembly ラボ:Wasmtime、WASI のケイパビリティ、WIT コンポーネント、プラグインの上限

授業で使いますか?このモジュールを学生に割り当てると、教員用ガイド、自動採点つきの課題、学生ごとのラボを使えます。