Dans le cadre du projet de Système (SY5) du 5ème semestre, nous avons implémenté le shell tsh, qui gère chaque fichier tarball comme un dossier.
tsh est capable d’exécuter les commandes suivantes :
help -> donne des informations sur les commandes spéciales que nous avons implémentées (listées ci-dessous).
ls [-l] name -> si name est un tarball ou un répertoire alors affiche son contenu direct (à profondeur +1 des sous dossiers comme ls classique) sinon si name est un fichier affiche son nom. L’option -l donne des informations supplémentaires (comme la taille, les droits, etc...) comme pour ls classique. On peut donner plusieurs name à ls sur la même ligne de commande.
cd répertoire -> permet de se déplacer dans le répertoire demandé ou dans le tarball si répertoire en est un.
pwd -> affiche notre position actuelle dans l'arborescence de fichier (avec éventuellement un chemin contenant des tarballs).
exit -> quitte le tsh
cat -> sans argument, recopie STDIN sur STDOUT. Avec argument, affiche le contenu dans d'un fichier.
mv [repertoire1] [repertoire2] -> déplace repertoire1 vers repertoire2.
rm [-r] [repertoire] -> permet la suppression d'un fichier quelconque et également d'un répertoire avec l'option -r
rmdir [repertoire] -> permet la suppression d'un répertoire vide
cp [-r] [repertoire] [repertoire] -> copie un fichier sous un nom différent et également d'un répertoire si utilisée avec l'option -r
mkdir [repertoire] -> crée un nouveau répertoire vide
Ainsi que toutes les commandes habituelles lorsqu'aucun tarball n'est en jeu.
Également tsh gère les redirections d'entrée (<), de sortie standard (> ou >>) et de sortie erreur (2> ou 2>>) ainsi que les tubes (|).
De façon générale , quelques difficultés ont été rencontrées dont les plus grandes implique le déplacement et le traitement d'informations au sein d'une
archive qui auront nécessités beaucoup de temps et de réflexions !
Le traitement de la position d'un fichier, de son header, et de son contenu dans un tar aura été source de nombreux problèmes que nous avons, dans l'ensemble esperont-le,
réussit à résoudre.
La fonction qui nous a posé le plus de difficulté est cp car présentant de très nombreux cas de figures différents.
Nous avons aussi rencontré quelques bugs rigolos en implémentant les redirections.
Une petite erreur dans le calcul de la position du fichier à copier ...
Tous les bugs qui étaient présent dans le tsh lors du premier rendu on été corrigé.
Une grande partie des issues que nous avons ouvertes sur le projet, sont maintenant closed, mais il en reste quelques unes que nous n'avons pas pu implémenter.
Actuellement l'affichage par ls dans le tar n'est pas très pratique comparé a l'affichage de bash a cause du manque de couleur. Nous n'avons pas implémenté l'affichage
des dossiers ou archives en couleurs différentes.
Comme dit plus haut, actuellement nous n'effectuons pas de vérifications des droits des utilisateurs pour les commandes
cd, mkdir ou autres dans un tar. Un utilisateur n'ayant pas les droits d'executions d'un dossier pourrait quand même se déplacer dans celui-ci via la commande cd si
il possède les droits d'executer le tar.
Nous aurions aussi aimé implémenter une commande history et une gestion des dernières commandes écrites dans le shell, afin de faciliter son utilisation.
Finalement, le tsh ne gère actuellement aucun signaux que l'utilisateur pourrait lui envoyer, et par exemple, CTRL-C l'arrête.
Avec la commande suivante vous pouvez lancer une vague de tests unitaires afin de vérifier le bon fonctionnement de tsh :
./test/sh
Dans le dossier tests, le script test.sh permet de construire une arborescence de fichier pour tester les commandes, et le script testrm.sh de la supprimer.
Nous avons aussi créé une arborescence de fichiers classiques, et une archive, afin de pouvoir tester facilement les fonctionnalités du tsh.
Vous pouvez télécharger l'image Docker directement depuis le dépôt Docker en utilisant cette commande :
docker pull tireur2cables/tsh_img
Ensuite vous pouvez soit utiliser la commande suivante pour créer un nouveau tag de cette image :
docker tag tireur2cables/tsh_img tsh_img
Ou alors vous pouvez remplacer tsh_img par tireur2cables/tsh_img dans les parties suivantes.
Vous pouvez également construire l'image Docker vous même en utilisant cette commande dans la racine du dépôt Git :
docker build -t tsh_img .
Vous pouvez lancer le conteneur en mode interactif en utilisant cette commande :
docker run -tiw /home/tsh-testing tsh_img
Vous pouvez exécuter le tsh dans le conteneur que vous venez de lancer en utilisant cette commande :
./tsh.sh
Cette commande compilera le projet s'il faut puis lance l'exécutable code/tsh.
Maintenant vous pouvez faire tout ce que vous voulez dans tsh en lançant vos commandes.
Dans le répertoire test vous trouverez de quoi faire déjà quelques essais avec des tarballs, des dossiers et des fichiers. Cependant vous ne devriez pas aller dans le répertoire code ou ses sous répertoires afin de préserver le fonctionnement de tsh et de ces tests unitaires.
Si vous n'utilisez pas Docker, vous devrez installer la librairie readline que nous utilisons pour la lecture des commandes.
Vous pouvez les faire sur Debian avec la commande :
sudo apt-get install libreadline-dev