Eine kleine Datei, die überall läuft
WebAssembly, kurz Wasm, ist ein kompaktes Binärformat für Programme. Eine Laufzeitumgebung übersetzt es auf jedem Rechner in Maschinencode, egal wo die Datei landet. Außerhalb des Browsers laufen damit Plugins, Serverless-Funktionen und Kommandozeilenwerkzeuge in einer Sandbox.
Heute starten Sie ein Modul mit Wasmtime und lesen seine Bytes einzeln.
Am Ende dieser Lektion
Notiz
Ich kann an den Bytes eines WebAssembly-Moduls erklären, was es enthält.
Schlüsselwörter
| Begriff | Was er bedeutet | Beispiel |
|---|---|---|
| WebAssembly | ein portables Binärformat für Programme | |
| Modul | ein übersetztes WebAssembly-Programm | add.wasm |
| Laufzeitumgebung | das Programm, das ein Modul lädt und ausführt | wasmtime |
| Sandbox | ein Zaun, über den das Programm nicht hinausreicht | |
| Import | eine Funktion, die der Host dem Modul geben muss | |
| Abschnitt | ein beschrifteter Teil einer .wasm-Datei |
Die Zellen, die Lernende ausfüllen, bleiben in dieser Vorschau leer.
Warum WebAssembly ohne Browser?
Ein natives Programm wird für einen Prozessor und ein Betriebssystem gebaut. Ein WebAssembly-Modul wird einmal gebaut. Die Laufzeitumgebung übersetzt es dann für den Rechner, auf dem es gerade liegt, ob Arm oder Intel, Linux oder Windows.
Außerdem ist es klein und startet in Millisekunden. Darum passt es zu Plugins und Funktionen, die oft starten. In Ihrem Lab läuft Wasmtime von der Bytecode Alliance.
Wasmtime nach der Version fragen
docker exec wasm wasmtime --versionHier angezeigt, nicht ausgeführt. Mit „Lab starten“ geben Sie ihn im Terminal Ihres eigenen Labs ein.
Ein erstes WASI-Programm starten
docker exec wasm wasmtime run hello.watHier angezeigt, nicht ausgeführt. Mit „Lab starten“ geben Sie ihn im Terminal Ihres eigenen Labs ein.
Ein Modul erreicht nur, was es importiert
Ein Modul hat einen eigenen Speicherblock und sonst nichts. Es kann keine Datei öffnen, keine Uhr lesen und kein Byte senden, solange der Host ihm keine Funktion dafür gibt. Diese Funktionen sind seine Importe.
hello.wat importiert genau eine Funktion, fd_write, aus WASI, dem WebAssembly System Interface. Damit kann es Text schreiben, mehr nicht.
Beispiel: was hello.wat verlangt
| Teil | In hello.wat | Bedeutung |
|---|---|---|
| Import | fd_write aus wasi_snapshot_preview1 | Der Host erlaubt das Schreiben in einen Stream |
| Speicher | eine Seite mit 64 KiB | Sein eigener Speicher, sonst niemandes |
| Daten | Hello from WebAssembly | Der Text, abgelegt in diesem Speicher |
| Export | _start | Dort beginnt ein WASI-Programm |
Die Zellen, die Lernende ausfüllen, bleiben in dieser Vorschau leer.
Was steht in einer .wasm-Datei?
Eine .wasm-Datei beginnt mit vier Magic Bytes, 00 61 73 6d. Sie stehen für eine Null und die Buchstaben asm. Danach folgen vier Bytes Version.
Dann kommen Abschnitte. Jeder besteht aus einem Id-Byte, seiner Größe und seinem Inhalt. Größen stehen als LEB128 da: sieben Bits je Byte, und das oberste Bit ist gesetzt, solange weitere Bytes folgen. Das Lab hat add.wasm mit wasmbin.py Byte für Byte gebaut.
add.wasm Abschnitt für Abschnitt lesen
docker exec tools python3 steps/sections.py add.wasmHier angezeigt, nicht ausgeführt. Mit „Lab starten“ geben Sie ihn im Terminal Ihres eigenen Labs ein.
Beispiel: die Abschnitte von add.wasm
| Id | Abschnitt | Größe | Was die Bytes sagen |
|---|---|---|---|
| 1 | type | 7 Bytes | ein Funktionstyp: zwei i32 hinein, ein i32 heraus |
| 3 | function | 2 Bytes | eine Funktion vom Typ 0 |
| 7 | export | 7 Bytes | Funktion 0 wird als add exportiert |
| 10 | code | 9 Bytes | local.get 0, local.get 1, i32.add, end |
Die Zellen, die Lernende ausfüllen, bleiben in dieser Vorschau leer.
Ein häufiger Fehler
Warnung
Viele halten ein WebAssembly-Modul für einen kleinen Container. Ein Container bringt Dateien eines Betriebssystems mit und ruft den Kernel direkt auf. Ein Modul bringt kein Betriebssystem mit und ruft nur seine Importe auf. Was es darf, entscheidet also allein der Host.
Das handgebaute add.wasm ausführen
docker exec wasm wasmtime run --invoke add add.wasm 2 3Hier angezeigt, nicht ausgeführt. Mit „Lab starten“ geben Sie ihn im Terminal Ihres eigenen Labs ein.
Probieren Sie es: Zahlen als LEB128
def uleb(n):
# Sieben Bits je Byte; das oberste Bit sagt: "es folgt noch ein Byte".
bytes_aus = []
while True:
rest = n % 128
n = n // 128
if n > 0:
bytes_aus.append(rest + 128)
else:
bytes_aus.append(rest)
return bytes_aus
for zahl in [5, 127, 128, 300]:
text = ""
for byte in uleb(zahl):
text = text + format(byte, "02x") + " "
print(zahl, "wird geschrieben als", text)
# Nehmen Sie 1000 in die Liste auf. Wie viele Bytes braucht die Zahl?