Fonctions du
système (section 2) getcwd
Nom
getcwd - Obtenir le répertoire courant.Synopsis
#include <linux/unistd.h> long *getcwd (char *tampon, unsigned longlongueur);
Description
La fonction getcwd() copie le chemin d'accès absolu du répertoire de travail courant dans la chaîne pointée par tampon, qui est de longueur longueur.Si le chemin du répertoire en cours nécessite un tampon plus long que longueur octets, la fonction renvoie NULL, et errno contient le code d'erreur ERANGE. Une application doit détecter cette erreur et allouer un tampon plus grand si besoin est.
Valeur Renvoyée
La longueur du chemin en cas de réussite, une valeur négative en cas d'échec (par exemple si le répertoire en cours n'est pas lisible).Notes
La version de la bibliothèque libc (getcwd(3) ) renvoie un pointeur sur un tableau de caractères. L'appel système du noyau renvoie la longueur du tampon rempli (incluant le '\0' final), ou un nombre négatif pour signaler une erreur. La version de la libc devrait donc être :
char *getcwd(char * buf, longueur_t longueur)
{
int retval = sys_getcwd(buf, longueur);
if (retval >= 0)
return buf;
errno = -retval;
return NULL;
}
Cette version serait plus rapide que la version actuelle getcwd(3)
qui
scanne récursivement '..' jusqu'à atteindre / alors que getcwd(2)
utilise les
possibilités du dentries cache.
Erreurs
- EFAULT
- Erreur lors de la copie de la page tampon allouée dans le noyau vers le tampon alloué par la libc dans l'espace utilisateur.
- ENOENT
- répertoire inexistant.
- ENOMEM
- pas assez de mémoire pour allouer une page intermédiaire.
- ERANGE
- longueur n'est pas
assez grande pour stocker le chemin absolu.
Voir Aussi
chdir(2) , getcwd(3) ,/usr/src/linux/fs/dcache.c
Disponibilité
Cet appel système a été ajouté aux noyaux 2.3.x.
Auteur
Thierry Vignaud <tvignaud@mandrakesoft.com>, 2000Traduction
Thierry Vignaud <tvignaud@mandrakesoft.com>, 2000