getcwd − Obtenir le répertoire courant.

#include <linux/unistd.h>

long *getcwd (char *tampon, unsigned longlongueur);

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.

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).

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.

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.

chdir(2), getcwd(3),
/usr/src/linux/fs/dcache.c

Cet appel système a été ajouté aux noyaux 2.3.x.

Thierry Vignaud <tvignaud@mandrakesoft.com>, 2000

Thierry Vignaud <tvignaud@mandrakesoft.com>, 2000