0x0000manual
Probar parsers, de un archivo a mil targets.
Estos capítulos son mis notas de trabajo sobre pruebas de parsers, escritas para poder volver a ellas y para que otros aprendan de ellas. Empiezan por lo que hace un parser con su entrada y terminan con cómo diseñar un experimento sobre muchos targets. Cada capítulo termina con las ideas clave, un test de cinco preguntas y tres ejercicios en Parsarium, de calentamiento a reto, cada uno con una pista y una solución. Tu progreso se guarda en este navegador.
0x0010capítulos
- 01Qué hace un parserEntran bytes y sale estructura. Por qué ese paso importa para las pruebas y la seguridad, y cómo lo organiza Parsarium.
- 02Formatos y gramáticasCómo se construyen los formatos, cómo los describen una gramática y unas restricciones, y cómo leer un archivo de control byte a byte.
- 03Controles y registrosQué significa que un parser esté verificado, qué registra un harness y cómo leer el registro de una ejecución.
- 04Elegir targetsCeldas, rankings de adopción, familias de parsers y APIs estándar: cómo elegir un conjunto de targets que encaje con tu pregunta.
- 05Feedback de coberturaCómo decide AFL++ que una entrada es interesante, cómo obtiene Parsarium esa señal en ocho lenguajes y cómo leer las cifras.
- 06Testing diferencialEnvía los mismos bytes a muchos parsers y compara lo que dicen. Donde no coinciden es donde hay que mirar.
- 07Fuzzing a escalaDe una campaña de AFL++ a cientos: semillas, presupuestos, ejecuciones en paralelo, repeticiones y cómo no perder el control de todo.
- 08Triaje y divulgaciónDe un archivo en crashes/ a un informe con el que un mantenedor pueda trabajar: reproducir, reducir, deduplicar, evaluar y divulgar.
- 09Diseñar un experimentoUna lista de comprobación para estudios con muchos parsers: pregunta, targets, presupuestos, repeticiones, métricas y qué publicar.
- AGlosarioLos términos de este manual, en un solo sitio.
0x0020preparación
Antes de los ejercicios.
Instala el comando desde PyPI. Necesitas Python 3.11 o posterior; para ejecutar harnesses también necesitas Docker con soporte para Linux amd64 y arm64.
$ python3 -m pip install parsarium $ parsarium list
Algunos ejercicios leen archivos del catálogo, como controles y registros. Están en la carpeta que imprime parsarium home --path. Expórtala una vez en cada terminal; los ejercicios se refieren a ella como $PARSARIUM:
$ export PARSARIUM="$(parsarium home --path)" $ ls "$PARSARIUM"
Los resultados se guardan en runs/, dentro de la carpeta desde la que ejecutas los comandos. Si trabajas con un clon del repositorio, apunta PARSARIUM_HOME al clon y el comando lo usará.