From fa39166f5e50048bca683e88cccd81d67b2b5478 Mon Sep 17 00:00:00 2001 From: Horde Nicolas Date: Sat, 17 Jul 2021 08:52:57 +0200 Subject: [PATCH] Changement du readme.md --- README.md | 61 +++++++++++++++++++++++++++++++++++++++++++++++++++++-- 1 file changed, 59 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index 1baf274..9ea5ad8 100644 --- a/README.md +++ b/README.md @@ -1,3 +1,60 @@ -# IA86, The even more pedagogical system +``` + + █████ █████████ ████████ ████████ +░░███ ███░░░░░███ ███░░░░███ ███░░░░███ + ░███ ░███ ░███ ░███ ░███ ░███ ░░░ + ░███ ░███████████ ░░████████ ░█████████ + ░███ ░███░░░░░███ ███░░░░███ ░███░░░░███ + ░███ ░███ ░███ ░███ ░███ ░███ ░███ + █████ █████ █████░░████████ ░░████████ +░░░░░ ░░░░░ ░░░░░ ░░░░░░░░ ░░░░░░░░ +THE EVEN MORE PEDAGOGICAL SYSTEM !! + +Episode 1 : Apprendre l'assembleur X86 +``` + +## Descriptif + +IA86 est un logiciel pour apprendre l'assembleur et la programmation système. Celui-ci se présente sous la forme d'un jeu assorti de plusieurs niveaux à la difficulté croissante. Progressivement le joueur acquier les concepts fondamentaux de l'informatique système au travers des différents défis à relever. Une machine virtuelle permet de vérifier que le code écrit par le joueur rempli les objectifs du niveau. + +## Structure + +Ecrit en C++, IA86 s'appuie sur la célèbre trilogie de librairies : +* Capstone (Désassembleur) - https://www.capstone-engine.org/ +* Keystone (Assembleur) - https://www.keystone-engine.org/ +* Unicore (Emulateur de processeur) - https://www.unicorn-engine.org/ + +L'interface est basée sur un système de fenêtre en terminal afin de préserver un style "ancien système" (librairie FinalCut, f - https://github.com/gansm/finalcut). + +## Developpement + +La compilation du logiciel s'opère par g++ au travers d'un conteneur docker afin d'assurer de disposer d'un environnement de compilation sur mesure et d'une reproductibilité totale. Un makefile permet de centraliser les différentes tâches au sein d'un même fichier. + +Pour compiler +``` +make all +``` + +Pour lancer le logiciel +``` +make rerun +``` + +ou + +``` +./start.sh" +``` + +En mode déboguage (avec plus d'informations) +``` +make redebug +``` + +ou + +``` +./start.sh debug" +``` + -Logiciel pour apprendre à utiliser l'assembleur