Utilisation des defines, ajout de commentaires dans le .h

header/source.h

@@ -2,11 +2,80 @@
 #define HEADER_SOURCE
 #include "tsock.h"
 
+/**
+ * @brief Lance le mode source. Gère UDP comme TCP et le mode Emetteur ainsi que Recepteur en TCP uniquement.
+ * Créer un socket(), un struct sockaddr_in et lance les diverses fonctions de connexion :
+ * connectTCP() puis sendMultipleData() pour le mode TCP
+ * sendMultipleData() uniquement pour le mode UDP
+ * 
+ * @param nombreMessage int, le nombre de message à envoyer.
+ * @param tailleMessage int, la taille de chacun de ces messages.
+ * @param isTCP         int, 1 -> TCP, 0 -> UDP         
+ * @param port          int, numéro du port
+ * @param ipAddress     char *, adresse IP
+ * @param emetteur      int, numéro Emetteur
+ * @param recepteur     int, numéro Recepteur
+ * @return int 0-> si réussite, autre sinon
+ */
 int launchSource(int nombreMessage,int tailleMessage,int isTCP,int port,char * ipAddress,int emetteur,int recepteur);
+
+/**
+ * @brief Envoi de trame(s) en mode UDP/TCP avec un format particulier :
+ * [msgID[5], caractères répétés] -> les caractères vont de a à z.
+ * 
+ * @param nombreMessages    int, le nombre de message à envoyer.
+ * @param tailleMessage     int, la taille de chacun de ces messages.
+ * @param sock              int, le socket créé par avance
+ * @param socketStruct      struct sockaddr_in *, la structure du socket sous forme de pointeur
+ * @param sizeSocketStruct  int, sizeof(*socketStruct). Important pour l'envoi en UDP
+ * @return int 0-> si réussite, autre sinon
+ */
 int sendMultipleData(int nombreMessages, int tailleMessage, int sock, struct sockaddr_in * socketStruct, int sizeSocketStruct, int isTCP);
+
+/**
+ * @brief Fonction simplifiée pour le connect() du mode TCP.
+ * 
+ * @param sock          int, le socket créé par avance
+ * @param socketStruct  struct sockaddr_in, structure du socket
+ * @param tailleSocket  int, sizeof(socketStruct)
+ */
 void connectTCP(int sock, struct sockaddr_in socketStruct, int tailleSocket);
+
+/**
+ * @brief Permet d'envoyer un/des message(s) avec une certaine taille spécifiquement
+ * pour la boîte au lettres. Le numéro du recepteur (nommé emetteur ici) est précisé.
+ * Une trame sera tout d'abord émise suivant le protocole de l'application avec la fonction formatTestParam()
+ * Ensuite une deuxième trame est émise avec formatTextMessage().
+ * 
+ * @param emetteur              int, numéro de l'émetteur utilisateur donc du recepteur pour le message
+ * @param nombreMessage         int, nombre de message à envoyer
+ * @param tailleMessage         int, la taille de ces messages
+ * @param sock                  int, numéro du socket crée par avance
+ * @param socketStruct          struct sockaddr_in *, pointeur sur la structure socket
+ * @param tailleSocketStruct    int, sizeof(*socketStruct)
+ */
 void modeEmetteur(int emetteur,int nombreMessage,int tailleMessage,int sock,struct sockaddr_in * socketStruct,int tailleSocketStruct);
+
+/**
+ * @brief Permet de recevoir les messages de la boite aux lettres à l'émetteur spécifié. Fonction non fonctionnelle pour le moment.
+ * 
+ * @param recepteur             int, numéro du recepteur utilisateur donc de l'emetteur pour la boite aux lettres
+ * @param sock                  int, numéro du socket crée par avance
+ * @param socketStruct          struct sockaddr_in *, pointeur sur la structure socket
+ * @param tailleSocketStruct    int, sizeof(*socketStruct)
+ */
 void modeRecepteur(int recepteur,int sock,struct sockaddr_in * socketStruct,int tailleSocketStruct);
+
+/**
+ * @brief Récupère la longueur émise par la fonction write() (TCP) ou sendto() (UDP)
+ * Si elle est égale à -1 : ferme le programme car l'envoi n'a pas pu être effectué.
+ * Sinon affiche les divers paramètres avec un compteur de message (count).
+ * 
+ * @param sendingMessage    char *, le message à envoyer 
+ * @param tailleMessage     int, la taille du message théorique
+ * @param longueurEmis      int, la taille du message à envoyer (-1 -> Erreur)
+ * @param count             int, compteur
+ */
 void printAndVerif(char * sendingMessage,int tailleMessage,int longueurEmis, int count);
 
 #endif

src/source.c

@@ -75,8 +75,7 @@ void modeEmetteur(int emetteur,int nombreMessage,int tailleMessage,int sock,stru
     char sendingMessage[tailleMessage],*paramMessage,*actualMessage,messageChar='a';
     for(int i=0;i<nombreMessage;i++)
     {
-        //paramMessage = 2 pour un emetteur, 1 pour un recepteur
-        paramMessage = formatTextParam(2,1,emetteur,tailleMessage+1,nombreMessage);
+        paramMessage = formatTextParam(MODE_EMIS,1,emetteur,tailleMessage+1,nombreMessage);
         longueurEmis = write(sock,paramMessage,16);
         printAndVerif(paramMessage,16,longueurEmis,i);
 
@@ -92,7 +91,7 @@ void modeRecepteur(int recepteur,int sock,struct sockaddr_in * socketStruct,int
 {
     int longueurEmis;
     char *paramMessage;
-    paramMessage = formatTextParam(1,recepteur,1,0,0);
+    paramMessage = formatTextParam(MODE_RECEPTEUR,recepteur,1,0,0);
     longueurEmis = write(sock,paramMessage,16);
     printAndVerif(paramMessage,16,longueurEmis,0);
 }