Voici le rapport pour le projet d'Ingénierie des Protocoles. Il ya les instructions sur les prérequis du logiciel ainsi que son fonctionnement (compilation et exécution).

Ici vous pouvez trouver la documentation de POP3 qui est le protocole choisis pour ce projet. Il y a toutes les règles qui sont reconnues par le parseur.

Il faut installer libpcap avec la commande suivante sur linux :

apt-get install libpcap

sur mac :

brew install libpcap

Pour compiler le projet il suffit d'aller dans le répertoire pop3_dpi via le terminal et exécuter la commande make. Un fichier pop3parser va apparaitre il suffit de l'exécuter comme suit :

./pop3parser fichier.pcap

Au début nous avons essayé d'utiliser bison afin de parser le fichier pcap. Mais nous avons des soucis avec le logiciel qui ne parse pas correctement certaines commandes. Nous avons néanmoins décidé de présenter bison.

bison ne permet pas de renvoyer de données. La fonction effectuant le parsing ne renvoie qu'un code d'erreur. Pour récupérer le résultat du parsing, on passe par une variable globale, initialisé dans la fonction yyparse. On a créé une fonction utilitaire qui appelle le parser et retourne la variable globale contenant la liste des commandes parsées.

Command_list* parse(const char* str)
{
    extern Command_list* list_of_commands___;
    scan_string(str);
    yyparse();
    return list_of_commands___;
}

bison prend en entrée un flux de lexème. C'est pour ça qu'il est souvent associé à un lexer comme flex (utilisé ici). Le comportement par défaut de flex est de prendre en paramètre un fichier (FILE*). Pour lexer une chaîne de caractère, il faut utiliser des fonctions de flex pour lui indiquer quelles données prendre en entrée. C'est le but de la fonction scan_string.

void scan_string(const char* str)
{
    yy_switch_to_buffer(yy_scan_string(str));
}

bison permet de créer le parser à partir d'une description de la grammaire du langage interprété. La description de la grammaire (faite dans pop.y), est très proche de la définition des commandes dans pop3.md.

Le parseur est un traitement de chaines de caractères classique en C.

Par Benjamin Guighil, Paul Lenczner et Vincent Bonnevalle