Saltar al contenido

Ingeniería

Cómo se construye AriCodeOS

Un plan escrito, decisiones registradas, pruebas automáticas en cada cambio y auditorías con evidencia. Los fallos no se esconden: se reproducen, se estudian y se corrigen con una prueba.

Principios

Diez reglas que no se rompen

  • Kernel pequeño
  • Seguro por defecto
  • Drivers aislados
  • La compatibilidad heredada, fuera del kernel
  • API explícitas
  • Nada heredado sin justificación
  • Probar antes de integrar
  • Cada privilegio debe poder explicarse
  • Cada unsafe debe poder justificarse
  • Cada optimización importante debe poder medirse

Comparar y después reutilizar o mejorar

Qué significa aquí «desde cero»

No escribir cada línea: estudiar las implementaciones establecidas y sus fallos, medir las nuestras frente a ellas en compatibilidad y en la velocidad del sistema, y quedarse con la que gane (ADR 0063). El código adoptado tiene que tener una licencia permisiva; no se acepta GPL ni código propietario.

Adoptado

RustCrypto y los crates dalek para SHA-2, AES-GCM, ChaCha20-Poly1305, Ed25519 y X25519; rustls y rustls-webpki para TLS y X.509; wasmi para WebAssembly.

Propio y mejorado

El kernel, sus drivers y servicios; el servidor SSH, con ML-KEM y renegociación de claves; TCP, con su transmisión rehecha; la verificación ECDSA y RSA, HMAC, HKDF y el generador del kernel, que midieron más rápido.

15–35×
WebAssembly dentro de AriCodeOS con wasmi (ADR 0071)
0,12 → 1,15 MB/s
Salida por SSH en el portátil de referencia, tras rehacer TCP
31 → 10 ms
Eco de una tecla por SSH, en QEMU (ADR 0069)
−37 %
Coste de envío SSH por byte (ADR 0068)

Decisiones

85 decisiones de arquitectura

Cada decisión que da forma al sistema queda registrada como un ADR con su contexto, las alternativas valoradas y sus consecuencias.

  • ADR 0001 · Rust no_std como lenguaje del kernel (frente a AriCode)
  • ADR 0002 · Arranque solo por UEFI
  • ADR 0003 · Microkernel pragmático
  • ADR 0004 · Seguridad basada en capabilities
  • ADR 0005 · Drivers en espacio de usuario
  • ADR 0006 · El crate uefi en AriBoot
  • ADR 0007 · Comportamiento de prueba por línea de órdenes, no por features
  • ADR 0008 · Solo Rust estable; stubs de interrupción en ensamblador generado
  • ADR 0009 · Mapa físico lineal construido por el cargador
  • ADR 0010 · Objetos del kernel por handle con generación y derechos
  • ADR 0011 · Ciclo de vida de los servicios y estado consultable
  • ADR 0012 · Plazos, correlación y reintentos en las llamadas IPC
  • ADR 0013 · Teclados en espacio de usuario como entrada de consola
  • ADR 0014 · Persistencia de AriFS: sumas de control, diario y flush
  • ADR 0015 · Lanzamientos asíncronos y límites observables
  • ADR 0016 · Permisos por recurso: ficheros compartidos de solo lectura
  • ADR 0017 · Aplicaciones de fuera del árbol instaladas en AriFS
  • ADR 0018 · Instalación y actualización transaccional de paquetes
  • ADR 0019 · Perfil aricode-wasm v1 y validación
  • ADR 0020 · Recepción desde varios endpoints (ipc_receive_any)
  • ADR 0021 · Tipos de memoria UEFI estándar en AriBoot
  • ADR 0022 · MSI además de MSI-X para los drivers de usuario
  • ADR 0023 · Almacenamiento USB como servicio de bloques dentro de usbd
  • ADR 0024 · Núcleo de red compartido y driver Realtek r8169
  • ADR 0025 · Servidor SSH con shells de sesión lanzados por init
  • ADR 0026 · HTTPS con cliente TLS 1.3 y verificación X.509
  • ADR 0027 · Actualizaciones del sistema por la red
  • ADR 0028 · Protocolo de fallos, modo estricto y eventos de fallo
  • ADR 0029 · Orígenes de actualización y el índice firmado
  • ADR 0030 · Aviso de extremo cerrado en los endpoints IPC
  • ADR 0031 · Driver EHCI en espacio de usuario con hubs USB 2.0
  • ADR 0032 · Autopruebas de arranque solo bajo petición
  • ADR 0033 · Un plazo absoluto para cada descarga HTTP
  • ADR 0034 · Secretos TCP: números de secuencia iniciales y puertos efímeros
  • ADR 0035 · Protección de los sockets en escucha: cola limitada, cupo de SYN|ACK y reset
  • ADR 0036 · Los descriptores de fichero siguen a su cliente
  • ADR 0037 · Los sockets siguen a su cliente
  • ADR 0038 · Vida de los búferes DMA
  • ADR 0039 · La fuente de entropía, visible
  • ADR 0040 · Ejecutor de pruebas en paralelo y contenedor de CI
  • ADR 0041 · Los agentes trabajan fuera de la base de confianza (propuesta)
  • ADR 0042 · Drivers oficiales, estabilidad de protocolos y licencias (propuesta)
  • ADR 0043 · Semilla del kernel conservada entre arranques
  • ADR 0044 · Una sola espera para IPC, IRQ y plazo
  • ADR 0045 · Canal de actualización de desarrollo
  • ADR 0046 · El compositor vuelca las zonas dañadas a ritmo de fotograma
  • ADR 0047 · Una consola de sesión para los programas lanzados desde un shell SSH
  • ADR 0048 · Redirecciones HTTP y un origen de actualización público
  • ADR 0049 · Páginas a cero en el primer acceso, y qué pasa cuando se acaba la memoria
  • ADR 0050 · La autoridad del servicio de ficheros, cerrada en todos los caminos
  • ADR 0051 · Las direcciones que indica un dispositivo PCI se comprueban antes de usarlas
  • ADR 0052 · Sesiones del compositor: una ventana pertenece al cliente que la creó
  • ADR 0053 · Las aplicaciones nunca reciben los servicios de entrada sin filtrar
  • ADR 0054 · Claves de certificado desautorizadas, rechazadas en cualquier punto de la cadena
  • ADR 0055 · El combustible de WASM cuenta el trabajo
  • ADR 0057 · Los valores de handle no se reutilizan antes de tiempo, y la entrada de consola es de quien la lee
  • ADR 0058 · El nombre común del sujeto nunca es un nombre de equipo
  • ADR 0060 · Un estado de actualización dañado falla cerrado
  • ADR 0061 · Una línea de interrupción solo enmascara su propia fuente; MSI-X solo donde sigue en su sitio
  • ADR 0062 · Ningún comodín sobre un sufijo público
  • ADR 0063 · Comparar y después reutilizar o mejorar
  • ADR 0064 · Las descargas de imágenes de sistema pasan por UPDATE
  • ADR 0065 · SIMD en los programas de usuario
  • ADR 0066 · Criptografía adoptada, medida frente a la nuestra
  • ADR 0067 · TLS y X.509 con rustls y rustls-webpki
  • ADR 0068 · Servidor SSH propio, con ML-KEM, renegociación de claves y un envío más rápido
  • ADR 0069 · sshd espera una sola vez al cliente y al shell
  • ADR 0070 · TCP propio, con la transmisión rehecha tras compararla con smoltcp
  • ADR 0071 · WebAssembly con wasmi, perfil v2
  • ADR 0072 · AriFS v2, reemplazo copy-on-write y una partición más grande
  • ADR 0073 · Paquetes de drivers firmados y tres niveles de confianza
  • ADR 0074 · Un sistema base y un perfil de escritorio opcional
  • ADR 0075 · El teclado y el touchpad PS/2 en el escritorio
  • ADR 0076 · Texto más allá del ASCII: el teclado español tal como lo escribe Linux
  • ADR 0077 · El botón de cerrar de una ventana
  • ADR 0078 · Un escritorio digno de ese nombre
  • ADR 0079 · El tamaño propio del panel cuando el firmware no lo ofrece
  • ADR 0080 · Un solo camino de los programas al hardware
  • ADR 0081 · Ventanas con dos búferes
  • ADR 0082 · Hilos en un proceso
  • ADR 0083 · El motor de la GPU en la HD 4000
  • ADR 0084 · Memoria para programas grandes
  • ADR 0085 · Redimensionar ventanas por sus bordes y esquinas
  • ADR 0086 · Cálculo en la HD 4000, sin compilador
  • ADR 0087 · Conectar y usar en los puertos raíz del xHCI

Medido, no supuesto

Optimizaciones elegidas por los números

Cifras de QEMU con TCG en el equipo de desarrollo, p50. Sirven para comparar compilaciones entre sí, no para predecir el hardware real.

10 ms → 46 µs
Llamada IPC al servicio de ficheros (ADR 0020)
712 → 141 µs
Lectura de 4 KiB, tras agrupar sectores
5,7 → 2,6 ms
Reemplazo atómico de 4 KiB, un flush menos
99 ns
Ida y vuelta de una llamada al sistema vacía

Proceso

Ramas, pruebas y auditorías

Git flow

Ramas main, develop y feature, fix y hotfix. Commits pequeños con mensajes descriptivos; toda la batería QEMU tiene que pasar antes de llegar a main.

Auditorías

Los hitos importantes se auditan y los hallazgos se registran con evidencia. Las versiones de corrección (0.1.1, 0.3.1, 0.4.1, 0.5.1 y 0.8.1) incorporan los arreglos.

Protocolo de fallos

Registrar, reproducir, estudiar desde varios ángulos, confirmar con evidencia, corregir con una prueba, auditar y cerrar. En modo estricto un componente se detiene en su primer fallo inesperado en lugar de entrar en bucle.

El incidente 0001, errores de transacción en el pendrive del portátil, se investigó con tres estudios independientes, volcados en modo estricto y medidas en el equipo de desarrollo antes de aceptar ningún arreglo.