DESCRIPTION.

Lance l'exécution d'un programme dans un nouveau processus.

SYNTAXE.

os.posix_spawn ( executable , arguments , environnement , attributA = valeurA , ... , attributN = valeurN )

os.posix_spawn ( ) ⇨ appel de la méthode [ OBLIGATOIRE ]

executable ⇨ fichier exécutable [ OBLIGATOIRE ]

arguments ⇨ liste des attributs à passer [ OBLIGATOIRE ]

environnement ⇨ liens symboliques [ optionnel ]

attribut = valeur ⇨ paramètres d'exécution [ optionnel ]

REMARQUES.

De préférence on utilsisera plutot la méthode subprocess.run ( ), du module subprocess, de la bibliothèque standard, qui est plus sûr et mieux approprié que os.posix_spawn ( ).

executable doit être fichier exécutable sur la machine hote et avec l'os actuel.

arguments est une succussion de valeurs à passer comme attributs pour le bon fonctionnement souhaité pour executable. Il peut s'agir, selon les cas, d'une suite de valeurs séparées par des virgules, d'une list ( ), d'un tuple ( ). Notez bien que le premier argument passer, automatiquement, à executable sera toujours le nom de executable, Ce nom pourra, souvent, remplacer le premier argument fourni dans arguments. C'est pourquoi attributs devraient toujours commencer avec le nom de la commande à lancer, mais ce n'est pas obligatoire.

environnement doit être un objet mapper, mapping, qui sera utilisé pour remplacer les variables d'environnement qui pourraient être définies autrement dans le nouveau processus. 

LISTE DES ATTRIBUTS.

file_actions = ( action1 , ... , actionN ), actions que devra effectuer executable.

la valeur de file_actions peut être une séquence de tuple ( ) ou None, valeur par défaut, si aucune action n'est requise. Si des tuple ( ) ils doivent avoir l'une des formes :

- ( os.POSIX_SPAWN_OPEN , descripteur , executable , options , mode ) ;

- ( os.POSIX_SPAWN_CLOSE , descripteur ) ;

- ( os.POSIX_SPAWN_DUP2 , descripteur , nouveau_descripteur ).

resetids = booleen, attribution de l'UID et du GID du nouveau processus.

Si booleen vaut True, l'UID et le GID effectifs de l'enfant seront réinitialisés aux véritables UID et GID du processus parent. Si l'argument est False, valeur par défaut, l'enfant conserve l'UID et le GID effectifs du parent. Dans les deux cas, si les bits d'autorisation set-user-ID et set-group-ID sont activés sur le fichier exécutable, leur effet remplacera le paramètre de l'UID et du GID effectifs. Cet argument correspond à l'indicateur POSIX_SPAWN_RESETIDS de la bibliothèque C.

scheduler = moment , panification de l'exécution.

moment doit être un tuple ( ) contenant la politique du planificateur (facultatif) et une instance de sched_param avec les paramètres du planificateur. Une valeur None, valeur par défaut, à la place de la stratégie du planificateur indique qu’elle n’est pas fournie. Cet argument est une combinaison des indicateurs POSIX_SPAWN_SETSCHEDPARAM et POSIX_SPAWN_SETSCHEDULER de la bibliothèque C.

setpgroup = valeur , groupe de processus à associer au nouveau processus.

valeur peut être None, valeur par défaut, 0 ou l'identifiant d'un groupe de processus valide.

setsid = booleen, création de l'ID de session.

Si booleen vaut True, il créera un nouvel ID de session pour posix_spawn. l'attribut setsid n'est valide qu'avec POSIX_SPAWN_SETSID et POSIX_SPAWN_SETSID_NP. Sinon, si booleen vaut False, il n'y aura pas de création de nouveal ID.

setsigdef = ( ), disposition des signaux.

setsigdef réinitialisera la disposition de tous les signaux dans l'ensemble spécifié. Cet argument correspond au flag POSIX_SPAWN_SETSIGDEF de la bibliothèque C.

setsigmask = ( ), masque de signal.

setsigmask définira le masque de signal sur l'ensemble de signaux spécifié. Si le paramètre n'est pas utilisé, alors l'enfant hérite du masque de signal du parent. Cet argument correspond au flag POSIX_SPAWN_SETSIGMASK de la bibliothèque C.

Les méthodes offertes par le module subprocess, de la bibliothèque standard, en particulier subprocess.run ( ) seront, le plus souvent, mieux adaptées au lancement de commandes de nouveaux processus. il sera donc préférable d'employé à la place de la méthode os.posix_spawn (.

EXEMPLE.

import os

kapplication = "votreexecutable" # indiquez un fichier exécutable de votre environnement

os.posix_spawn ( kapplication , [ ] )