Provided by: manpages-fr-dev_4.15.0-9_all 
NOM
execveat - Exécuter un programme relatif au descripteur de fichier d'un répertoire
SYNOPSIS
#include <linux/fcntl.h> /* Definition of AT_* constants */
#include <unistd.h>
int execveat(int dirfd, const char *pathname,
const char *const argv[], const char *const envp[],
int flags);
DESCRIPTION
L'appel système execveat() exécute le programme auquel renvoient dirfd et pathname. Il
opère exactement de la même manière que execve(2), excepté les différences décrites dans
cette page de manuel.
Si le nom de chemin fourni dans pathname est relatif, il est interprété relativement au
répertoire référencé par le descripteur de fichier dirfd (plutôt que relativement au
répertoire de travail courant du processus appelant, comme cela est fait par execve(2)
pour un chemin relatif).
Si pathname est relatif et que dirfd est la valeur spéciale AT_FDCWD, pathname est
interprété relativement au répertoire de travail courant du processus appelant (comme avec
execve(2)).
Si pathname est absolu, alors dirfd est ignoré.
Si pathname est une chaîne vide et si le drapeau AT_EMPTY_PATH est indiqué, le descripteur
de fichier dirfd spécifie le fichier à exécuter (c-est-à-dire que dirfd renvoie à un
fichier exécutable et non à un répertoire).
L'argument flags est un masque de bit qui peut comprendre zéro ou plusieurs des drapeaux
suivants :
AT_EMPTY_PATH
Si pathname est une chaîne vide, opérer sur le fichier auquel renvoie dirfd (qu'on
peut obtenir en utilisant le drapeau O_PATH de open(2)).
AT_SYMLINK_NOFOLLOW
Si le fichier identifié par dirfd est un pathname non NULL est un lien symbolique,
l'appel échoue avec l'erreur ELOOP.
VALEUR RENVOYÉE
On success, execveat() does not return. On error, -1 is returned, and errno is set to
indicate the error.
ERREURS
Les mêmes erreurs qui apparaissent pour execve(2) peuvent apparaître pour execveat(2). Les
erreurs supplémentaires suivantes peuvent également se produire pour execveat(2) :
pathname
is relative but dirfd is neither AT_FDCWD nor a valid file descriptor.
EINVAL flags contient un attribut non valable.
ELOOP flags comprend AT_SYMLINK_NOFOLLOW et le fichier identifié par dirfd et un pathname
non NULL est un lien symbolique.
ENOENT Le programme identifié par dirfd et pathname exige d'utiliser un interpréteur (tel
qu'un script qui commence par « #! », mais le descripteur de fichier dirfd a été
ouvert avec le drapeau O_CLOEXEC, d'où il s'en suit que le fichier du programme est
inaccessible à l'interpréteur lancé. Voir BOGUES.
ENOTDIR
pathname est relatif et dirfd est un descripteur de fichier faisant référence à un
fichier qui n'est pas un dossier.
VERSIONS
execveat() was added to Linux in kernel 3.19. Library support was added to glibc in
version 2.34.
CONFORMITÉ
L'appel système execveat() est spécifique à Linux.
NOTES
Outre les raisons expliquées dans openat(2), l'appel système execveat() est également
nécessaire pour permettre à fexecve(3) d'être implémenté sur des systèmes où aucun système
de fichiers /proc n'est monté.
Si on lui demande d'exécuter un fichier script, argv[0] qui est passé à l'interpréteur de
script est une chaîne sous la forme /dev/fd/N ou /dev/fd/N/P, où N est le numéro du
descripteur de fichier passé via l'argument dirfd. Une chaîne sous la première forme
apparaît quand AT_EMPTY_PATH est utilisé. Une chaîne sous la deuxième forme apparaît quand
le script est indiqué via dirfd et pathname ; dans ce cas, P est la valeur donnée à
pathname.
Pour les mêmes raisons décrites dans fexecve(3), l'usage naturel quand on utilise
execveat() est de positionner l'attribut close-on-exec sur dirfd (mais voir BOGUES).
BOGUES
L'erreur ENOENT décrite ci-dessus signifie qu'il n'est pas possible de positionner
l'attribut close-on-exec sur le descripteur de fichier donné à l'appel sous la forme :
execveat(fd, "", argv, envp, AT_EMPTY_PATH);
Cependant, l'impossibilité de positionner l'attribut close-on-exec signifie qu'un
descripteur de fichier renvoyant à un script a une fuite via le script lui-même. Outre
qu'elle gaspille le descripteur de fichier, cette fuite peut l'épuiser dans des scénari où
les scripts utilisent execveat() de manière récursive.
VOIR AUSSI
execve(2), openat(2), fexecve(3)
COLOPHON
Cette page fait partie de la publication 5.13 du projet man-pages Linux. Une description
du projet et des instructions pour signaler des anomalies et la dernière version de cette
page peuvent être trouvées à l'adresse https://www.kernel.org/doc/man-pages/.
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 ⟨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⟩.