Provided by: manpages-fr-dev_4.21.0-2_all 
NOM
system - Exécuter une commande d'interpréteur
BIBLIOTHÈQUE
Bibliothèque C standard (libc, -lc)
SYNOPSIS
#include <stdlib.h>
int system(const char *commande);
DESCRIPTION
La fonction de bibliothèque system() se comporte comme si elle utilisait fork(2) pour
créer un processus enfant qui exécuterait la commande d’interpréteur indiquée dans
commande en utilisant execl(3) comme ceci :
execl("/bin/sh", "sh", "-c", commande, (char *) NULL);
system() se termine après l’exécution de la commande.
Lors de l’exécution de la commande, SIGCHLD sera bloqué, et SIGINT et SIGQUIT seront
ignorés dans le processus qui appelle system() (ces signaux seront traités conformément à
leurs valeurs par défaut dans le processus enfant qui exécute commande).
Si la valeur de commande est NULL, system() renvoie un état indiquant si un interpréteur
de commande est disponible sur le système.
VALEUR RENVOYÉE
La valeur renvoyée par system() est une des suivantes :
- Si commande est NULL, alors une valeur différente de zéro est renvoyée si un
interpréteur de commandes est accessible, et 0 sinon.
- Si un processus enfant n’a pas pu être créé ou si son état n’a pas pu être récupéré, la
valeur renvoyée est -1 et errno est définie pour indiquer l'erreur.
- Si un interpréteur n’a pas pu s’exécuter dans le processus enfant, alors la valeur
renvoyée est comme si l’interpréteur enfant s’était terminé en appelant _exit(2) avec
l’état 127.
- Si tous les appels système réussissent, alors la valeur renvoyée est l’état de retour
de l’interpréteur enfant utilisé pour exécuter commande (l’état final d’un interpréteur
est l’état final de la dernière commande qu’il exécute).
Dans les deux derniers cas, la valeur renvoyée est un « état d’attente » qui peut être
examiné en utilisant les macros décrites dans waitpid(2) (c’est-à-dire WIFEXITED(),
WEXITSTATUS(), etc.).
system() n'affecte pas l'état d'attente des autres processus enfants.
ERREURS
system() peut échouer avec une des erreurs décrites pour fork(2).
ATTRIBUTS
Pour une explication des termes utilisés dans cette section, consulter attributes(7).
┌────────────────────────────────────────────────────────┬──────────────────────┬─────────┐
│Interface │ Attribut │ Valeur │
├────────────────────────────────────────────────────────┼──────────────────────┼─────────┤
│system() │ Sécurité des threads │ MT-Safe │
└────────────────────────────────────────────────────────┴──────────────────────┴─────────┘
STANDARDS
POSIX.1-2001, POSIX.1-2008, C99.
NOTES
system() fournit simplicité et commodité : elle gère tous les détails des appels de
fork(2), execl(3) et waitpid(2), ainsi que les manipulations nécessaires des signaux ; de
plus, l’interpréteur de commande réalise les substitutions habituelles et les redirections
des entrées et sorties de commande. L'inconvénient principal de system() est son manque
d'efficacité : des appels système supplémentaires sont nécessaires pour créer le processus
qui exécute l’interpréteur de commande et pour exécuter l’interpréteur de commande.
Si la macro de test de fonctionnalité _XOPEN_SOURCE est définie (avant d'inclure tout
fichier d'en‐tête), les macros décrites dans waitpid(2) (WEXITSTATUS(), etc.) sont
disponibles en incluant <stdlib.h>.
Comme mentionné plus haut, system() ignore SIGINT et SIGQUIT. Un programme qui l'appelle
depuis une boucle risque de ne pas pouvoir être interrompu, à moins qu'il ne vérifie le
code de retour de l'enfant. Par exemple :
while (quelque_chose) {
int ret = system("toto");
if (WIFSIGNALED(ret) &&
(WTERMSIG(ret) == SIGINT || WTERMSIG(ret) == SIGQUIT))
break;
}
Selon POSIX.1, il n'est pas précisé si les gestionnaires enregistrés à l'aide de
pthread_atfork(3) sont appelés au cours de l'exécution de system(). Dans l'implémentation
de la glibc, de tels gestionnaires ne sont pas appelés.
Avant la glibc 2.1.3, la vérification de la disponibilité de /bin/sh n'était pas
réellement exécutée lorsque commande était NULL. Il était supposé être toujours
disponible, et system() renvoyait toujours 1 dans ce cas. Depuis la glibc 2.1.3, cette
vérification est effectuée, car, même si POSIX.1-2001 impose une implémentation conforme
pour fournir un interpréteur, cet interpréteur peut ne pas être disponible ou exécutable
si le programme appelant a auparavant appelé chroot(2) (ce qui n'est pas spécifié dans
POSIX.1-2001).
La commande d’interpréteur peut se terminer avec un état de 127, ce qui provoque une
valeur renvoyée de system() non distinguable du cas où un interpréteur n’a pas pu être
exécuté dans le processus enfant.
Mises en garde
N'utilisez pas system() à partir d'un programme avec privilèges (un programme set-user-ID,
set-group-ID ou possédant des capacités), car des valeurs particulières de certaines
variables d'environnement pourraient être utilisées pour corrompre l'intégrité du système.
Par exemple, PATH pourrait être redéfinie de façon à exécuter un programme arbitraire avec
privilèges. Utilisez plutôt la famille de fonctions exec(3), mais pas execlp(3) ou
execvp(3) (qui utilisent aussi la variable d'environnement PATH pour rechercher un
exécutable).
En fait, system() ne fonctionnera pas correctement à partir de programmes ayant des
privilèges set-user-ID ou set-group-ID sur les systèmes où /bin/sh redirige vers bash
version 2, car ce dernier annule les privilèges au démarrage par mesure de sécurité
(Debian utilise un interpréteur de commande différent, dash(1), qui n'effectue pas cette
annulation de privilèges si on l'invoque à l'aide du lien symbolique sh).
Toute entrée utilisateur qui constitue une partie de commande doit être nettoyée avec soin
afin de s'assurer que des commandes de l'interpréteur ou des options de commandes
inattendues ne seront pas exécutées. Les risques de ce type sont particulièrement graves
lorsqu'on utilise system() à partir d'un programme avec privilèges.
BOGUES
Si le nom de la commande commence par un trait d'union, sh(1) interprète ce nom comme une
option et le résultat est indéterminé (voir l'option -c de sh(1)). Pour contourner ce
problème, préfixez le nom de la commande avec une espace comme dans l'appel suivant :
system(" -nom-de-commande-problématique");
VOIR AUSSI
sh(1), execve(2), fork(2), sigaction(2), sigprocmask(2), wait(2), exec(3), signal(7)
TRADUCTION
La traduction française de cette page de manuel a été créée par Christophe Blaess
<https://www.blaess.fr/christophe/>, Stéphan Rafin <stephan.rafin@laposte.net>, Thierry
Vignaud <tvignaud@mandriva.com>, François Micaux, Alain Portal <aportal@univ-montp2.fr>,
Jean-Philippe Guérard <fevrier@tigreraye.org>, Jean-Luc Coulon (f5ibh) <jean-
luc.coulon@wanadoo.fr>, Julien Cristau <jcristau@debian.org>, Thomas Huriaux
<thomas.huriaux@gmail.com>, Nicolas François <nicolas.francois@centraliens.net>, Florentin
Duneau <fduneau@gmail.com>, Simon Paillard <simon.paillard@resel.enst-bretagne.fr>, Denis
Barbier <barbier@debian.org>, David Prévot <david@tilapin.org> et Lucien Gentis
<lucien.gentis@waika9.com>
Cette traduction est une documentation libre ; veuillez vous reporter à la GNU General
Public License version 3 ⟨https://www.gnu.org/licenses/gpl-3.0.html⟩ concernant les
conditions de copie et de distribution. Il n'y a aucune RESPONSABILITÉ LÉGALE.
Si vous découvrez un bogue dans la traduction de cette page de manuel, veuillez envoyer un
message à ⟨debian-l10n-french@lists.debian.org⟩.