BE_reseau/README.md

89 lines
5.4 KiB
Markdown
Raw Blame History

This file contains invisible Unicode characters

This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# BE RESEAU
## TPs BE Reseau - 3 MIC
Les détails du sujet du BE est accessible depuis le cours "Programmation Système et Réseau" sur moodle.
## Contenu du dépôt « template » fourni
Ce dépôt inclut le code source initial fourni pour démarrer le BE. Plus précisément :
- README.md (ce fichier) qui notamment décrit la préparation de lenvironnement de travail et le suivi des versions de votre travail;
- tsock_texte et tsock_video : lanceurs pour les applications de test fournies.
- dossier include : contenant les définitions des éléments fournis que vous aurez à manipuler dans le cadre du BE.
- dossier src : contenant l'implantation des éléments fournis et à compléter dans le cadre du BE.
- src/mictcp.c : fichier au sein duquel vous serez amenés à faire l'ensemble de vos contributions (hors bonus éventuels).
## Création du dépôt mictcp
1. Création dun compte git étudiant : Si vous ne disposez pas dun compte git, connectez vous sur http://github.com/ et créez un compte par binôme.
2. Afin dêtre capable de mettre à jour le code que vous aurez produit sur le dépôt central Github, il vous faudra créer un jeton daccès qui jouera le rôle de mot de passe. Veuillez le sauvegarder, car il vous le sera demandé lors de l'accès au dépôt central. Pour ce faire, veuillez suivre les étapes décrites : https://docs.github.com/en/authentication/keeping-your-account-and-data-secure/creating-a-personal-access-token
3. Création dun dépôt Etudiant sur GitHub pour le BE Reseau
Créer une copie du dépôt template enseignant : https://github.com/rezo-insat/mictcp, en vous y rendant et en cliquant sur le bouton « use this template » situé dans le coin en haut, plutôt à droite de la page. Il est demandé de le choisir comme dépôt privé. Il est impératif pour les corrections que vous rajoutiez le compte : rezo-insat comme collaborateur afin de permettre à vos enseignants d'accéder à votre dépôt. Pour ce faire, sélectionner le bouton "settings" puis "collaborators" et rajouter comme utilisateur : rezo-insat. La marche à suivre est décrite ci-après : https://docs.github.com/en/organizations/managing-access-to-your-organizations-repositories/adding-outside-collaborators-to-repositories-in-your-organization
4. Créer un clone local de votre dépôt Github, i.e. une copie locale du dépôt sur votre compte insa.
cliquer sur le bouton « code » de votre dépôt, copier lURL qui permet de lidentifier.
Ouvrir un terminal de votre machine. En vous plaçant dans le répertoire de travail de votre choix, taper depuis le terminal :
git clone <url de votre dépôt>
Vous avez désormais une copie locale de votre dépôt, que vous pouvez mettre à jour et modifier à volonté au gré de votre avancement sur les TPs.
5. Afin de nous permettre davoir accès à votre dépôt, merci de bien vouloir renseigner l'URL de votre dépôt sur le fichier accessible depuis le lien "fichier URLs dépôts étudiants" se trouvant sur moodle (au niveau de la section: BE Reseau).
## Compilation du protocole mictcp et lancement des applications de test fournies
Pour compiler mictcp et générer les exécutables des applications de test depuis le code source fourni, taper :
make
Deux applicatoins de test sont fournies, tsock_texte et tsock_video, elles peuvent être lancées soit en mode puits, soit en mode source selon la syntaxe suivante:
Usage: ./tsock_texte [-p|-s]
Usage: ./tsock_video [[-p|-s] [-t (tcp|mictcp)]
Seul tsock_video permet d'utiliser, au choix, votre protocole mictcp ou une émulation du comportement de tcp sur un réseau avec pertes.
## Suivi de versions de votre travail
Vous pouvez travailler comme vous le souhaitez sur le contenu du répertoire local. Vous pouvez mettre à jour les fichiers existants, rajouter dautres ainsi que des dossiers et en retirer certains à votre guise.
Pour répercuter les changements que vous faites sur votre répertoire de travail local sur le dépôt central GitHub, sur votre terminal, taper :
git add .
git commit -m «un message décrivant la mise à jour»
git push
- Marquage des versions successives de votre travail sur mictcp
Lorsque vous le souhaitez, git permet d'associer une étiquette à un état précis de votre dépôt par l'intermédiaires de tags. Il vous est par exemple possible d'utiliser ce mécanisme pour marquer (et par conséquence pouvoir retrouver) l'état de votre dépôt pour chacune des versions successives de votre travail sur mictcp.
Pour Créer un tag « v1 » et l'associer à l'état courrant de votre dépôt, vous taperez la commande suivante sur votre terminal :
git tag v1
Pour lister les tags existants au sein de votre dépôt
git tag -l
Pour transférer les tags de votre dépôt local vers le dépôt central sur github:
git push origin --tags
Ceci permettra à votre enseignant de positionner le dépôt dans l'état ou il était au moment du marquage avec chacun des tags que vous définissez.
## Suivi de votre avancement
Veuillez utiliser, à minima, un tag pour chacune des versions successives de mictcp qui sont définies au sein du sujet du BE disponible sous moodle.
## Liens utiles
Aide pour la création dun dépôt depuis un template : https://docs.github.com/en/repositories/creating-and-managing-repositories/creating-a-repository-from-a-template
Manuel d'utilisation de git: https://git-scm.com/docs