Provided by:
manpages-fr-dev_3.27fr1.4-1_all 
NOM
chroot - Modifier le repertoire racine
SYNOPSIS
#include <unistd.h>
int chroot(const char *path);
Exigences de macros de test de fonctionnalites pour la glibc (consultez
feature_test_macros(7)) :
chroot() :
Depuis la glibc 2.2.2 :
_BSD_SOURCE ||
(_XOPEN_SOURCE >= 500 ||
_XOPEN_SOURCE && _XOPEN_SOURCE_EXTENDED) &&
!(_POSIX_C_SOURCE >= 200112L || _XOPEN_SOURCE >= 600)
Avant la glibc 2.2.2 : aucune
DESCRIPTION
chroot() remplace le repertoire racine du processus appelant par celui
specifie par le chemin path. Ce repertoire sera utilise comme origine
des chemins commencant par /. Le repertoire racine est herite par tous
les enfants du processus appelant.
Seul un processus privilegie (sous Linux : un processus ayant la
capacite CAP_SYS_CHROOT) peut appeler chroot().
Cette fonction change un des ingredients de l'algorithme de resolution
des chemins, et ne modifie rien d'autre.
Notez que cet appel systeme ne modifie pas le repertoire de travail,
aussi << . >> peut se retrouver en-dehors de l'arbre dont la racine est
<< / >>. En particulier, le superutilisateur peut s'evader d'un
<< piege chroot >> en faisant :
mkdir foo; chroot foo; cd ..
Cet appel ne ferme aucun descripteur de fichier, et de tels
descripteurs peuvent permettre un acces a des fichiers hors de l'arbre
dont la racine est le nouveau << / >>.
VALEUR RENVOY'EE
S'il reussit, cet appel systeme renvoie 0. S'il echoue, il renvoie -1
et remplit errno en consequence.
ERREURS
Suivant le type de systeme de fichiers, plusieurs erreurs peuvent etre
renvoyees. Les plus courantes sont les suivantes :
EACCES L'acces a un element du chemin est interdit. (Voir aussi
path_resolution(7).)
EFAULT path pointe en dehors de l'espace d'adressage accessible.
EIO Une erreur d'entree-sortie s'est produite.
ELOOP path contient une reference circulaire (a travers un lien
symbolique)
ENAMETOOLONG
path est trop long.
ENOENT Le fichier n'existe pas.
ENOMEM Pas assez de memoire pour le noyau.
ENOTDIR
Un element du chemin d'acces path n'est pas un repertoire.
EPERM L'appelant n'a pas les privileges suffisants.
CONFORMIT'E
SVr4, BSD 4.4, SUSv2 (considere comme historique). Cette fonction n'est
pas decrite dans POSIX.1-2001.
NOTES
Un processus fils cree avec fork(2) herite du repertoire racine de son
pere. Le repertoire racine n'est pas modifie par un execve(2).
FreeBSD a un appel systeme jail() plus solide.
VOIR AUSSI
chdir(2), path_resolution(7)
COLOPHON
Cette page fait partie de la publication 3.27 du projet man-pages
Linux. Une description du projet et des instructions pour signaler des
anomalies peuvent etre trouvees a l'adresse
<URL:http://www.kernel.org/doc/man-pages/>.
TRADUCTION
Depuis 2010, cette traduction est maintenue a l'aide de l'outil po4a
<URL:http://po4a.alioth.debian.org/> par l'equipe de traduction
francophone au sein du projet perkamon
<URL:http://perkamon.alioth.debian.org/>.
Christophe Blaess <URL:http://www.blaess.fr/christophe/> (1996-2003),
Alain Portal <URL:http://manpagesfr.free.fr/> (2003-2006). Julien
Cristau et l'equipe francophone de traduction de Debian (2006-2009).
Veuillez signaler toute erreur de traduction en ecrivant a
<debian-l10n-french@lists.debian.org> ou par un rapport de bogue sur le
paquet manpages-fr.
Vous pouvez toujours avoir acces a la version anglaise de ce document
en utilisant la commande << man -L C <section> <page_de_man> >>.