どこでも動く小さなファイル
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 | メモリーに置いた文字 |
| エクスポート | _start | WASI のプログラムが始まる所 |
学生が入力するセルは、このプレビューでは空白です。
.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 | セクション | サイズ | バイトの意味 |
|---|---|---|---|
| 1 | type | 7バイト | 関数の型1つ。i32 を2つ受け取り、1つ返す |
| 3 | function | 2バイト | 型0の関数が1つ |
| 7 | export | 7バイト | 関数0を add として公開 |
| 10 | code | 9バイト | 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 で書く
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 を足しましょう。何バイト要るでしょうか。