NOM¶

execve - Exécuter un programme

BIBLIOTHÈQUE¶

Bibliothèque C standard (libc, -lc)

SYNOPSIS¶

#include <unistd.h>

int execve(const char *pathname, char *const _Nullable argv[],
           char *const _Nullable envp[]);

DESCRIPTION¶

execve() exécute le programme auquel renvoie pathname. Il s'ensuit que le programme en cours d'exécution par le processus appelant sera remplacé par un nouveau programme, avec une pile et un tas nouvellement initialisés, et des segments de données (initialisés et non initialisés)

pathname doit être soit un exécutable binaire, soit un script qui commence par une ligne sous la forme :

#!interpréteur [argument-optionnel]

Pour des détails sur ce dernier cas, consultez « Scripts d’interpréteur » ci‐dessous.

argv est un tableau de pointeurs vers des chaînes passées au nouveau programme en tant qu'arguments de la ligne de commande. Par convention, la première de ces chaînes (à savoir argv[0]) devrait contenir le nom de fichier associé au fichier étant exécuté. Le tableau argv doit se terminer par un pointeur NULL (ainsi, dans le nouveau programme, argv[argc] vaudra NULL).

envp est un tableau de pointeurs vers des chaînes, ayant par convention la forme clé=valeur, qui sont passés au nouveau programme en tant qu'environnement. Le tableau envp dois se terminer par un pointeur NULL.

Cette page de manuel décrit l'appel système Linux en détail ; pour un aperçu de la nomenclature et des nombreuses variantes, souvent préférables et standardisées de cette fonction, fournies par la libc, dont celles qui recherchent la variable d'environnement PATH, voir exec(3).

Le vecteur d'argument et l'environnement sont accessibles à la fonction principale du nouveau programme quand elle est définie ainsi :

int main(int argc, char *argv[], char *envp[])

Notez, cependant, que l'utilisation d'un troisième argument dans la fonction principale n'est pas spécifiée dans POSIX.1, selon laquelle l'environnement doit être accessible par la variable externe environ(7).

En cas de réussite, execve() ne renvoie rien et les segments de texte, les données initialisées et non initialisées (« bss »), ainsi que la pile du processus appelant sont remplacés par ceux du programme chargé.

Si l'on effectuait un ptrace(2) sur le programme actuel, un signal SIGTRAP lui est envoyé après la réussite de execve().

Si le bit set-user-ID est positionné sur le fichier du programme auquel renvoie pathname, l'ID de l'utilisateur effectif du processus appelant passe à celui du propriétaire du programme. De même, lorsque le bit set-group-ID est positionné sur le fichier du programme, l'ID du groupe effectif du processus appelant est modifié pour correspondre à celui du groupe du fichier.

Les transformations précitées des ID effectifs ne sont pas effectuées (c'est-à-dire que les bits set-user-ID et set-group-ID sont ignorés) si un des éléments suivants est vrai :

•

l'attribut no_new_privs est défini pour le thread appelant (voir prctl(2)) ;

•

le système de fichiers sous-jacent est monté en nosuid (le drapeau MS_NOSUID de mount(2)) ;

•

ou un ptrace va être appliqué au processus appelant.

Les capacités du fichier du programme (voir capabilities(7)) sont également ignorées si un des éléments ci-dessus est vrai.

L'UID effectif du processus est copié dans le set-user-ID sauvegardé ; de la même manière, le GID effectif est copié dans le set-group-ID sauvegardé. Ces copies ont lieu après toute modification d'ID effectif à cause des bits de permission set-user-ID et set-group-ID.

L'UID et le GID réel du processus ainsi que ses ID de groupe complémentaires ne sont pas modifiés par un appel à execve().

Si l'exécutable est un fichier binaire a.out lié dynamiquement, et contenant des appels aux bibliothèques partagées, l'éditeur de liens dynamiques de Linux ld.so(8) est appelé au début de l'exécution, afin de charger les bibliothèques partagées nécessaires en mémoire et d'effectuer l'édition des liens de l'exécutable avec eux.

Si l'exécutable est au format ELF lié dynamiquement, l'interpréteur indiqué dans le segment PT_INTERP sera invoqué pour charger les bibliothèques partagées. Cet interpréteur est généralement /lib/ld-linux.so.2 pour les fichiers binaires liés avec la glibc (voir ld-linux.so(8)).

#!interpréteur [argument-optionnel]

interpréteur [argument-optionnel] pathname arg...

VALEUR RENVOYÉE¶

En cas de réussite, execve() ne renvoie rien, en cas d'échec il renvoie -1 et errno est positionné pour indiquer l'erreur.

ERREURS¶

E2BIG

Le nombre total d'octets dans l'environnement (envp) et la liste d'arguments (argv) est trop grande.

EACCES

Le droit de parcours est refusé pour un des composants du préfixe du chemin pathname ou du nom d'un interpréteur de script (consultez aussi path_resolution(7)).

EACCES

Le fichier ou l'interpréteur de script n'est pas un fichier régulier.

EACCES

L'autorisation d'exécution est refusée pour le fichier, ou un interpréteur de script, ou un interpréteur ELF.

EACCES

Le système de fichiers est monté avec l'option noexec.

EAGAIN (depuis Linux 3.1)

Ayant modifié son UID réel avec un des appels set*uid(), l’appelant était – et est toujours — au-delà de sa limite de ressources RLIMIT_NPROC (consultez setrlimit(2)). Pour une explication plus précise de cette erreur, consultez NOTES.

EFAULT

pathname ou l'un des pointeurs du vecteur argv ou envp pointe en dehors de l'espace d'adressage accessible.

EINVAL

Un exécutable ELF a plusieurs segments PT_INTERP (indique plusieurs interpréteurs).

EIO

Une erreur d'entrée-sortie s'est produite.

EISDIR

L'interpréteur ELF cité est un répertoire.

ELIBBAD

L'interpréteur ELF mentionné n'est pas dans un format connu.

ELOOP

Trop de liens symboliques rencontrés dans la résolution de pathname ou du nom de l'interpréteur de script ou ELF.

ELOOP

La limite maximale de niveaux a été atteinte pendant l'interprétation récursive du script (voir « scripts interpréteurs » ci-dessus). Avant Linux 3.8 l'erreur générée dans ce cas était ENOEXEC.

EMFILE

La limite du nombre de descripteurs de fichiers par processus a été atteinte.

ENAMETOOLONG

nom_chemin est trop long.

ENFILE

La limite du nombre total de fichiers ouverts pour le système entier a été atteinte.

ENOENT

Aucun fichier pathname ou interpréteur de script ou ELF n'existe.

ENOEXEC

Le fichier exécutable n'est pas dans le bon format, ou est destiné à une autre architecture.

ENOMEM

La mémoire disponible du noyau n'était pas suffisante.

ENOTDIR

Un composant du préfixe du chemin de pathname ou de l'interpréteur de script ou ELF n'est pas un répertoire.

EPERM

Le système de fichiers est monté avec l'attribut nosuid, l’utilisateur n’est pas le superutilisateur et le fichier a un bit set-user-ID ou set-group-ID positionné.

EPERM

Le processus est suivi avec ptrace(2), l'utilisateur n'est pas le superutilisateur, et le fichier a un bit set-user-ID ou set-group-ID positionné.

EPERM

Une application « capability-dumb » n'obtiendrait pas toutes les capacités rendues possibles par le fichier exécutable. Voir capabilities(7).

ETXTBSY

L'exécutable spécifié était ouvert en écriture par un ou plusieurs processus.

STANDARDS¶

POSIX.1-2001, POSIX.1-2008, SVr4, 4.3BSD. POSIX ne documente pas le comportement de « #! » mais celui-ci existe (avec quelques variations) sur d'autres systèmes UNIX.

NOTES¶

On pourrait parfois voir execve() (et les fonctions associées décrites dans exec(3)) décrit comme un « exécuteur de nouveau processus » (ou équivalent). C'est une description très trompeuse : il n'y a pas de nouveau processus ; beaucoup d'attributs du processus appelant demeurent inchangés (en particulier son PID). Tout ce que fait execve() est de s'organiser pour qu'un processus existant (le processus appelant) exécute un nouveau programme.

Les processus set-user-ID et set-group-ID ne peuvent pas être suivis par ptrace(2).

Le résultat d'un montage de système de fichiers avec l'attribut nosuid peut varier suivant les versions du noyau Linux : certaines refuseront l'exécution des fichiers set-user-ID et set-group-ID lorsque cela donnerait à l'appelant des privilèges qu'il n'a pas (et renverront l'erreur EPERM), d'autres ignoreront simplement les bits set-user-ID et set-group-ID mais accepteront d'effectuer l'appel exec().

Sur Linux, argv et envp peuvent être indiqués comme NULL. Dans les deux cas, cela a le même effet que de spécifier un argument comme un pointeur sur une liste contenant un seul pointeur NULL. N'en profitez pas pour faire des choses non standard et non portables !. Sur de nombreux autres systèmes UNIX, spécifier argv comme NULL donnera une erreur (EFAULT). D'autres systèmes UNIX traitent le cas envp==NULL comme Linux.

POSIX.1 indique que les valeurs renvoyées par sysconf(3) ne doivent pas changer pendant la vie d'un processus. Cependant, depuis Linux 2.6.23, si la limite de ressources RLIMIT_STACK change, alors la valeur renvoyée par _SC_ARG_MAX changera également, pour refléter le fait que la limite de l'espace qui reçoit les paramètres de la ligne de commande et les variables d'environnement a changé.

Dans la plupart des cas où execve() échoue, le contrôle renvoie vers l’image exécutable d’origine et l’appelant de execve() peut alors traiter l’erreur. Cependant, dans de (rares) cas (typiquement provoqués par un épuisement de ressources), l’échec pourrait se produire après le point de non-retour : l’image exécutable d’origine a été supprimée, mais la nouvelle image n’a pas pu être construite complètement. Dans ces cas-là, le noyau tue le processus avec un signal SIGSEGV (SIGKILL jusqu'à Linux 3.17).

EXEMPLES¶

Le programme suivant est conçu pour être exécuté par le second programme ci‐dessous. Il se contente d'afficher les paramètres de sa ligne de commande, un par ligne.

/* myecho.c */
#include <stdio.h>
#include <stdlib.h>
int
main(int argc, char *argv[])
{


    for (size_t j = 0; j < argc; j++)


        printf("argv[%zu]: %s\n", j, argv[j]);


    exit(EXIT_SUCCESS);
}

Ce programme peut être utilisé pour exécuter le programme donné comme argument de ligne de commande :

/* execve.c */
#include <stdio.h>
#include <stdlib.h>
#include <unistd.h>
int
main(int argc, char *argv[])
{


    static char *newargv[] = { NULL, "hello", "world", NULL };


    static char *newenviron[] = { NULL };


    if (argc != 2) {


        fprintf(stderr, "Utilisation : %s <fichier_à_exécuter>\n", argv[0]);


        exit(EXIT_FAILURE);


    }


    newargv[0] = argv[1];


    execve(argv[1], newargv, newenviron);


    perror("execve");   /* execve() ne renvoie qu'en cas d'erreur */


    exit(EXIT_FAILURE);
}

On peut utiliser le second programme pour exécuter le premier de la façon suivante :

$ cc myecho.c -o myecho
$ cc execve.c -o execve
$ ./execve ./myecho
argv[0]: ./myecho
argv[1]: hello
argv[2]: world

On peut aussi utiliser ces programmes pour montrer l'utilisation d'un interpréteur de scripts. Pour ce faire, on crée un script dont l'« interpréteur » est notre programme myecho :

$ cat > script
#!./myecho script-arg
^D
$ chmod +x script

On peut alors utiliser notre programme pour exécuter le script :

$ ./execve ./script
argv[0]: ./myecho
argv[1]: script-arg
argv[2]: ./script
argv[3]: hello
argv[4]: world

VOIR AUSSI¶

chmod(2), execveat(2), fork(2), get_robust_list(2), ptrace(2), exec(3), fexecve(3), getauxval(3), getopt(3), system(3), capabilities(7), credentials(7), environ(7), path_resolution(7), ld.so(8)

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 Jean-Philippe MENGUAL <jpmengual@debian.org>

Cette traduction est une documentation libre ; veuillez vous reporter à la GNU General Public License version 3 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.