Un petit fichier qui tourne partout
WebAssembly, ou Wasm, est un format binaire compact pour les programmes. Un runtime le traduit en code machine sur l’ordinateur où il arrive. Hors du navigateur, il fait tourner des plugins, des fonctions serverless et des outils en ligne de commande, dans un bac à sable.
Aujourd’hui, vous lancez un module avec Wasmtime et vous lisez ses octets un par un.
À la fin de cette leçon
Remarque
Je peux expliquer ce que contient un module WebAssembly en lisant ses octets.
Mots-clés
| Mot | Ce que ça veut dire | Exemple |
|---|---|---|
| WebAssembly | un format binaire portable pour les programmes | |
| Module | un programme WebAssembly compilé | add.wasm |
| Runtime | le programme qui charge et exécute un module | wasmtime |
| Bac à sable | une clôture que le programme ne peut pas franchir | |
| Import | une fonction que l’hôte doit fournir au module | |
| Section | une partie étiquetée d’un fichier .wasm |
Les cellules que les étudiants remplissent restent vides dans cet aperçu.
Pourquoi WebAssembly hors du navigateur ?
Un programme natif est construit pour un processeur et un système d’exploitation. Un module WebAssembly est construit une seule fois. Le runtime le compile ensuite pour la machine présente, Arm ou Intel, Linux ou Windows.
Il démarre aussi en quelques millisecondes et reste petit. C’est pourquoi il convient aux plugins et aux fonctions lancés souvent. Wasmtime, de la Bytecode Alliance, est le runtime de votre labo.
Demander sa version à Wasmtime
docker exec wasm wasmtime --versionAffichée ici, non exécutée. Appuyez sur Démarrer le labo pour la saisir dans le terminal de votre propre labo.
Lancer un premier programme WASI
docker exec wasm wasmtime run hello.watAffichée ici, non exécutée. Appuyez sur Démarrer le labo pour la saisir dans le terminal de votre propre labo.
Un module n’atteint que ce qu’il importe
Un module a son propre bloc de mémoire, et rien d’autre. Il ne peut ni ouvrir un fichier, ni lire l’horloge, ni envoyer un octet. Il faut que l’hôte lui donne une fonction pour cela. Ces fonctions sont ses imports.
hello.wat importe une seule fonction, fd_write, depuis WASI, la WebAssembly System Interface. Avec cet import, il peut écrire du texte, et rien de plus.
Exemple travaillé : ce que demande hello.wat
| Partie | Dans hello.wat | Ce que cela veut dire |
|---|---|---|
| Import | fd_write depuis wasi_snapshot_preview1 | L’hôte le laisse écrire dans un flux |
| Mémoire | une page de 64 Kio | Sa propre mémoire, celle de personne d’autre |
| Données | Hello from WebAssembly | Le texte, rangé dans cette mémoire |
| Export | _start | Là où commence un programme WASI |
Les cellules que les étudiants remplissent restent vides dans cet aperçu.
Que contient un fichier .wasm ?
Un fichier .wasm commence par quatre octets magiques, 00 61 73 6d : un zéro, puis les lettres asm. Quatre octets de version suivent.
Viennent ensuite les sections. Chacune donne un octet d’identifiant, sa taille, puis son contenu. Les tailles sont écrites en LEB128 : sept bits par octet, et le bit de poids fort reste à 1 tant qu’un octet suit. Le labo a construit add.wasm octet par octet avec wasmbin.py.
Lire add.wasm section par section
docker exec tools python3 steps/sections.py add.wasmAffichée ici, non exécutée. Appuyez sur Démarrer le labo pour la saisir dans le terminal de votre propre labo.
Exemple travaillé : les sections de add.wasm
| Id | Section | Taille | Ce que disent les octets |
|---|---|---|---|
| 1 | type | 7 octets | un type de fonction : deux i32 en entrée, un i32 en sortie |
| 3 | function | 2 octets | une fonction, du type 0 |
| 7 | export | 7 octets | exporter la fonction 0 sous le nom add |
| 10 | code | 9 octets | local.get 0, local.get 1, i32.add, end |
Les cellules que les étudiants remplissent restent vides dans cet aperçu.
Erreur fréquente
Attention
On croit souvent qu’un module WebAssembly est un petit conteneur. Un conteneur emporte les fichiers d’un système d’exploitation et appelle le noyau directement. Un module n’emporte aucun système et ne peut appeler que ses imports. C’est donc l’hôte qui décide de tout ce qu’il peut faire.
Lancer add.wasm, construit à la main
docker exec wasm wasmtime run --invoke add add.wasm 2 3Affichée ici, non exécutée. Appuyez sur Démarrer le labo pour la saisir dans le terminal de votre propre labo.
À vous : écrire des nombres en LEB128
def uleb(n):
# Sept bits par octet ; le bit de poids fort dit "un autre octet suit".
octets = []
while True:
bas = n % 128
n = n // 128
if n > 0:
octets.append(bas + 128)
else:
octets.append(bas)
return octets
for nombre in [5, 127, 128, 300]:
texte = ""
for octet in uleb(nombre):
texte = texte + format(octet, "02x") + " "
print(nombre, "s’écrit", texte)
# Ajoutez 1000 à la liste. Combien d’octets lui faut-il ?