CHDIR
Section : Manuel du programmeur Linux (
2)
Mise à jour de la version anglaise : 26 juillet 2007
Index
Menu principal
NOM
chdir, fchdir - Changer le répertoire courant
SYNOPSIS
#include <unistd.h>
int chdir(const char *path);
int fchdir(int fd);
Exigences de macros de test de fonctionnalités pour la glibc (voir
feature_test_macros(7)) :
fchdir() :
_BSD_SOURCE || _XOPEN_SOURCE >= 500
DESCRIPTION
chdir()
remplace le répertoire de travail courant du processus appelant
par celui indiqué dans le chemin
path.
fchdir()
est identique à
chdir(),
sauf que le répertoire cible est fourni sous forme
de descripteur de fichier.
VALEUR RENVOYÉE
Ces appels renvoient 0 s'ils réussissent, ou -1 s'ils échouent,
auquel cas
errno
est renseignée en conséquence.
ERREURS
Suivant le type de système de fichiers, plusieurs erreurs peuvent
être renvoyées, les plus courantes pour
chdir()
sont les suivantes :
- EACCES
-
L'accès n'est pas autorisé sur un élément du chemin
.
(Voir aussi
path_resolution(7).)
- EFAULT
-
path
pointe en dehors de l'espace d'adressage accessible.
- EIO
-
Une erreur d'entrée-sortie s'est produite.
- ELOOP
-
path
contient une référence circulaire (à travers un lien symbolique).
- ENAMETOOLONG
-
path
est trop long.
- ENOENT
-
Le fichier n'existe pas.
- ENOMEM
-
Pas assez de mémoire pour le noyau.
- ENOTDIR
-
Un élément du chemin d'accès
path
n'est pas un répertoire.
Les erreurs courantes pour
fchdir()
sont :
- EACCES
-
Le répertoire ouvert sur
fd
n'autorise pas le parcours.
- EBADF
-
fd
n'est pas un descripteur de fichier valide.
CONFORMITÉ
SVr4, BSD 4.4, POSIX.1-2001.
NOTES
Le répertoire de travail actuel est le point de départ pour
l'interprétation des noms de chemins relatifs
(ceux qui ne commencent pas par « / »).
Un processus fils créé avec
fork(2)
hérite du répertoire de travail courant de son père.
Le répertoire de travail courant n'est pas modifié par un
execve(2).
Le prototype de
fchdir()
n'est disponible que si
_BSD_SOURCE
est définie ou si
_XOPEN_SOURCE
est définie avec la valeur 500.
VOIR AUSSI
chroot(2),
getcwd(3),
path_resolution(7)
TRADUCTION
Ce document est une traduction réalisée par Christophe Blaess
<http://www.blaess.fr/christophe/> le 9 octobre 1996
et révisée le 23 juin 2008.
L'équipe de traduction a fait le maximum pour réaliser une adaptation
française de qualité. La version anglaise la plus à jour de ce document est
toujours consultable via la commande : « LANG=C man 2 chdir ».
N'hésitez pas à signaler à l'auteur ou au traducteur, selon le cas, toute
erreur dans cette page de manuel.
Index
- NOM
-
- SYNOPSIS
-
- DESCRIPTION
-
- VALEUR RENVOYÉE
-
- ERREURS
-
- CONFORMITÉ
-
- NOTES
-
- VOIR AUSSI
-
- TRADUCTION
-
Dernière mise à jour : 23 juin 2008