first commit

readcmd.h

@@ -0,0 +1,41 @@
+#ifndef __READCMD_H
+#define __READCMD_H
+
+/* Lit une ligne de commande depuis l'entrée standard.
+ * Remarque :
+ * Dans le cas où suffisamment de mémoire ne peut être allouée pour le résultat,
+ * affiche un message d'erreur et appelle exit().
+ */
+
+struct cmdline *readcmd(void);
+/* Structure retournée par readcmd()
+ * Remarques utiles :
+ *    - readcmd() peut retourner null, dans le cas où le processus en attente sur readcmd reçoit un signal
+ *    - en cas d'appels successifs,
+ *      readcmd() réutilise la mémoire allouée à la structure cmdline qu'elle retourne
+ */
+struct cmdline {
+	char *err;	/* Si non null : message d'erreur à afficher. 
+				 * Dans ce cas, les autres champs sont nuls. */
+	char *in;	/* Si non null : nom du fichier vers lequel l'entrée doit être redirigée. */
+	char *out;	/* Si non null : nom du fichier vers lequel la sortie doit être redirigée. */
+	char *backgrounded; /* Si non null : commande en tâche de fond */ 
+	char ***seq;	/* Une ligne de commande est une suite de commandes liées par des tubes
+					 * Ainsi, 
+					 * - une commande est un tableau de chaînes de caractères (char **).
+                     *   Chaque élément de ce tableau est en effet une chaîne (char *)
+                     *   correspondant à un argument de la commande.
+					 *   Le dernier pointeur du tableau est suivi d'un pointeur null, qui
+                     *   marque la fin du tableau.
+					 * - seq est un tableau de commandes (char ***), chaque commande de ce
+                     *   tableau correspondant à une commande élémentaire du pipeline.
+					 *   Le dernier élément (char **) du tableau est ici aussi suivi d'un pointeur null.
+					 * - Dans le cas particulier où une ligne vide est saisie, le pointeur référencé par
+                     *   seq vaut directement NULL : puisque le tableau n'a aucun élément, le marqueur
+                     *   de fin de tableau se trouve référencé par seq, ce que l'on peut écrire 
+                     *   (*seq == NULL) 
+                     *   (ou (seq[0] == NULL), mais cela peut prêter à confusion, seq[0] n'existant pas)
+					 */
+};
+#endif
+