| Les deux révisions précédentes Révision précédente Prochaine révision | Révision précédente |
| refmodule [2026/08/04 11:59] – [ssh] root | refmodule [2026/08/04 12:03] (Version actuelle) – [shm] root |
|---|
| ==== shm ==== | ==== shm ==== |
| |
| NOTA : module à finir, revoir doc (newprocessshmreader/writer) Module gérant la communication inter-processus, basée sur des messages textes. Chaque processus possède une //queue// qui permet de recevoir les messages émis par les autres processus. | //NOTA// : module à finir, revoir doc (newprocessshmreader/writer) Module gérant la communication inter-processus, basée sur des messages textes. Chaque processus possède une //queue// qui permet de recevoir les messages émis par les autres processus. |
| |
| * ''get(content)'' : renvoi dans ''content'' le prochain message reçu depuis la queue interne du processus en cours. S'il n'y a pas de message à lire, renvoi //vide//. | * ''get(content)'' : renvoi dans ''content'' le prochain message reçu depuis la queue interne du processus en cours. S'il n'y a pas de message à lire, renvoi //vide//. |
| * ''get(socket, data, timeout)'' : lit les données venant de l'autre côté de la connexion identifiée par l'id ''socket''. Les données lues sont renvoyées dans la chaîne ''data''. Si aucune donnée d'est disponible au bout du délai ''timeout'' donné, (en secondes), la chaîne ''data'' est renvoyée //vide//. | * ''get(socket, data, timeout)'' : lit les données venant de l'autre côté de la connexion identifiée par l'id ''socket''. Les données lues sont renvoyées dans la chaîne ''data''. Si aucune donnée d'est disponible au bout du délai ''timeout'' donné, (en secondes), la chaîne ''data'' est renvoyée //vide//. |
| * ''set(socket, data)'' : écrit les données de ''data'' sur la connexion identifiée par l'id ''socket''. | * ''set(socket, data)'' : écrit les données de ''data'' sur la connexion identifiée par l'id ''socket''. |
| | * ''getHostname(name, ip)'' : renvoi le nom (dans ''name'') et l'addresse ip (dans ''ip'') de l'hôte qui exécute le programme en cours. |
| |
| |
| * ''updateEnv(varName, value)'' : met à jour la variable d'environnement ''varName'' avec la valeur ''value''. Génère l'exception EXMOD_SYSTEM_SETENV si la variable est inconnue de la session en cours. | * ''updateEnv(varName, value)'' : met à jour la variable d'environnement ''varName'' avec la valeur ''value''. Génère l'exception EXMOD_SYSTEM_SETENV si la variable est inconnue de la session en cours. |
| * ''deleteEnv(varName)'' : supprime la variable d'environnement nommée ''varName'' de la session courante. Génère l'exception EXMOD_SYSTEM_SETENV si la variable est inconnue | * ''deleteEnv(varName)'' : supprime la variable d'environnement nommée ''varName'' de la session courante. Génère l'exception EXMOD_SYSTEM_SETENV si la variable est inconnue |
| * ''getOS(OScode)'' : renvoi un code, dans le paramètre ''OScode'', indiquant le type de l'OS hôte du programme en cours : Windows, Linux… | * ''getOS(OScode)'' : renvoi un code, dans le paramètre ''OScode'', indiquant le type de l'OS hôte du programme en cours (de type chaîne) : //Windows//, //Linux// |
| * ''getHostname(name, ip)'' : renvoi le nom (dans ''name'') et l'addresse ip (dans ''ip'') de l'hôte qui exécute le programme en cours | |
| * ''sendSignal(pid, signalNumber)'' : envoi le signal numéro ''signalNumber'' au processus identifié par son numéro ''pid''. Seuls les 3 signaux SIGTERM, SIGINT, SIGUSR1 sont pris en charge. Les autres sont ignorés. Fonction compatible Unix/Windows mais sous Windows, ce sont des évènements qui sont générés, pas des signaux ; SIGTERM et SIGINT génèrent un évènement ''Global\\wterm<pid>'' et SIGUSR1 génère un évènement ''Global\\wdebug<pid>'' | * ''sendSignal(pid, signalNumber)'' : envoi le signal numéro ''signalNumber'' au processus identifié par son numéro ''pid''. Seuls les 3 signaux SIGTERM, SIGINT, SIGUSR1 sont pris en charge. Les autres sont ignorés. Fonction compatible Unix/Windows mais sous Windows, ce sont des évènements qui sont générés, pas des signaux ; SIGTERM et SIGINT génèrent un évènement ''Global\\wterm<pid>'' et SIGUSR1 génère un évènement ''Global\\wdebug<pid>'' |
| * ''sleep(duration)'' : endort le process en cours, pour une durée de ''duration'' secondes | * ''sleep(duration)'' : endort le process en cours, pour une durée de ''duration'' secondes |