projet-systeme-exploitation.../readcmd.h

42 lines
2.1 KiB
C
Raw Normal View History

2021-04-20 16:12:44 +00:00
#ifndef __READCMD_H
#define __READCMD_H
/* Lit une ligne de commande depuis l'entrée standard.
* Remarque :
* Dans le cas 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 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
*/
2021-04-21 12:15:14 +00:00
struct cmdline
{
char *err; /* Si non null : message d'erreur à afficher.
2021-04-20 16:12:44 +00:00
* Dans ce cas, les autres champs sont nuls. */
2021-04-21 12:15:14 +00:00
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
2021-04-20 16:12:44 +00:00
* 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 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