Fichiers
ui/doc/adr/ADR-0002-wrappers-syscall-en-asm.md
2026-10-11 01:55:22 +02:00

ADR-0002 — Wrappers syscall en assembleur plutot qu en asm inline C++

  • Statut : accepte
  • Date : 2026-09-05
  • Portee : chantier 2

Contexte

Sans libc, il faut emettre svc #0 soi-meme. Deux facons de le faire :

  1. Assembleur pur, dans un .S : une routine par appel, assemblee telle quelle, appelee par bl.
  2. Assembleur inline dans une fonction C++ static inline, avec des contraintes de registres et une liste de clobbers.

L asm inline est la solution la plus repandue — c est ce que fait musl, et ce que font la plupart des noyaux unikernel. Elle merite donc une justification explicite d etre ecartee.

Decision

Assembleur pur, dans asm/syscall.S.

Ce que ca coute

  • Un appel de fonction par syscall. L asm inline se serait fondu dans l appelant : pas de bl, pas de ret, et le compilateur aurait pu ordonner les instructions autour du svc. On paie donc environ deux instructions et une prediction de branchement par appel. Sur un svc qui coute plusieurs centaines de cycles de transition en mode noyau, c est du bruit — mais c est un cout reel, et il faut le nommer.
  • Aucune propagation de constantes a travers le wrapper. Le compilateur ne voit qu un appel opaque : il ne peut pas savoir que sys::write(2, s, n) utilise toujours le meme descripteur, ni eliminer un appel mort.
  • Deux endroits a tenir a jour pour ajouter un appel : le .S et le .hpp.

Ce que ca apporte

  1. Le contrat de registres est verifiable a l oeil. Une routine de trois instructions est lisible dans un desassemblage et se compare directement a arch/arm64/kernel/entry.S. Une contrainte inline "r"(x) avec une liste de clobbers est un contrat entre nous et l optimiseur, et ce contrat est silencieux quand il est faux.
  2. Pas de dependance au comportement de l optimiseur. L asm inline peut etre duplique, deplace, ou sorti d une boucle par le compilateur s il juge le bloc pur. Il faut alors volatile et une liste de clobbers "memory" exacte, sous peine de bugs qui n apparaissent qu a -O2 et pas a -O0. C est exactement le genre de non-determinisme que le pilier 1 rejette.
  3. Cout constant, mesurable, identique a chaque site d appel. Avec l asm inline, le code genere autour du svc depend du contexte : le cout du wrapper varie d un appel a l autre. Ici il est le meme partout.
  4. Alignement de pile garanti par construction. Aucun wrapper ne touche a sp ni n empile x30. Il n y a donc rien a verifier : la contrainte des 16 octets de l AAPCS64 est respectee parce qu il n existe pas de code pour la violer.
  5. Une macro assure l uniformite. PROJ3_SYSCALL_DIRECT emet les quatorze wrappers directs a l identique. Il est structurellement impossible que l un d eux ait un prologue ou une transformation qui traine.

Consequences

  • Les numeros d appel sont dans src/proj3/sys/syscall_nr.hpp, inclus par le .S (qui est preprocesse). Ils ne sont jamais ecrits en dur dans le corps d une routine.
  • La valeur de retour n est pas transformee dans le wrapper (cf. doc/convention-syscall.md, option C). Le .S se limite a mov x8, #N puis svc #0 puis ret.
  • open est le seul wrapper qui remanie ses arguments : la table generique AArch64 n a pas de __NR_open, seulement openat. Il decale les quatre arguments et injecte AT_FDCWD. C est documente dans le fichier, et c est pour cela qu il n utilise pas la macro.
  • Si un jour le cout de l appel devenait mesurable sur un chemin chaud — ce qui demanderait un syscall dans une boucle serree, situation que le projet cherche a eviter par ailleurs — la reponse serait de supprimer le syscall, pas de l inliner.

Alternatives ecartees

  • asm volatile inline avec contraintes. Ecartee pour les raisons 1, 2 et 3 ci-dessus.
  • Une seule routine generique syscall(nr, a, b, c, d, e, f). Ecartee : elle oblige a decaler sept arguments a chaque appel, elle perd le typage des arguments, et elle rend le desassemblage illisible (tous les appels se ressemblent).