#include <unistd.h>

char * getcwd (char * buf, size_t size);

char * getwd (char * buf);

char *get_current_dir_name(void);

Exigences de macros de test de fonctionalités pour la glibc (voir feature_test_macros(7)) :

getcwd() : _BSD_SOURCE || _XOPEN_SOURCE >= 500
get_current_dir_name() : _GNU_SOURCE  

Si le chemin du répertoire en cours nécessite un tampon plus long que size 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.

Si buf est NULL, le comportement de getcwd() est indéfini.

Comme extension de la norme POSIX.1-2001, la version Linux (libc4, libc5, glibc) de getcwd() alloue le tampon dynamiquement, en utilisant malloc(3), si buf est NULL lors de l'appel. Alors, le tampon alloué a la longueur size à moins que size soit égal à zéro, dans ce cas buf a la taille nécessaire. Il est possible (et même fortement conseillé) de libérer le tampon avec free(3) lorsqu'il a été obtenu ainsi.

get_current_dir_name(), allouera avec malloc(3) une chaîne suffisamment grande pour contenir le nom du répertoire. Si la variable d'environnement PWD est configurée, et correcte, cette valeur sera renvoyée.

getwd() n'allouera aucune mémoire. L'argument buf doit être un pointeur sur une chaîne comportant au moins PATH_MAX octets. getwd() ne renverra que les PATH_MAX premiers octets du nom réel. Notez que PATH_MAX n'est pas nécessairement une constante à la compilation. Elle peut dépendre du système de fichiers, voire être illimitée. Pour des raisons de portabilité et de sécuriré, on déconseille l'utilisation de getwd().  

EACCES

Impossible de lire ou de parcourir un composant du chemin d'accès.

EFAULT

buf pointe sur une adresse illégale.

EINVAL

L'argument size vaut zéro et buf n'est pas un pointeur NULL.

ENOENT

Le répertoire en cours a été supprimé.

ERANGE

L'argument size est inférieur à la longueur du nom du répertoire. Allouez un tampon plus grand et ré-essayez.

Ces fonctions sont souvent utilisées pour sauver le répertoire de travail afin d'y revenir plus tard. Ouvrir le répertoire courant (« . ») et appeler fchdir(2) pour y revenir est habituellement une alternative plus rapide et plus fiable (surtout sur d'autres systèmes que Linux) si l'on dispose de suffisamment de descripteurs de fichiers.  

Ce document est une traduction réalisée par Christophe Blaess <http://www.blaess.fr/christophe/> le 26 octobre 1996 et révisée le 6 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 3 getcwd ». N'hésitez pas à signaler à l'auteur ou au traducteur, selon le cas, toute erreur dans cette page de manuel.

NOM

SYNOPSIS

DESCRIPTION

VALEUR RENVOYÉE

ERREURS

CONFORMITÉ

NOTES

VOIR AUSSI

TRADUCTION