table of contents
other sections
GETCWD(3) | Manuel du programmeur Linux | GETCWD(3) |
NOM¶
getcwd, getwd, get_current_dir_name - Obtenir le répertoire de travail actuelSYNOPSIS¶
#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 fonctionnalités pour la glibc (consultez feature_test_macros(7)) :
get_current_dir_name() :
_GNU_SOURCE
- Depuis la glibc 2.12 :
-
_BSD_SOURCE || (_XOPEN_SOURCE >= 500 || _XOPEN_SOURCE && _XOPEN_SOURCE_EXTENDED) && !(_POSIX_C_SOURCE >= 200809L || _XOPEN_SOURCE >= 700)
-
Avant la glibc 2.12 : _BSD_SOURCE || _XOPEN_SOURCE >= 500 || -
_XOPEN_SOURCE && _XOPEN_SOURCE_EXTENDED
DESCRIPTION¶
Ces fonctions renvoient une chaîne terminée par une octet nul contenant un chemin absolu correspondant au répertoire de travail actuel du processus appelant. Le chemin est renvoyé comme résultat de la fonction et par le paramètre buf, s'il est présent.VALEUR RENVOYÉE¶
En cas de succès, ces fonctions renvoient un pointeur vers une chaîne contenant le chemin du répertoire de travail en courant. Dans le cas de getcwd() et getwd() il s'agit de la même valeur que buf.ERREURS¶
- 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.
- EINVAL
- getwd() : buf est NULL.
- ENAMETOOLONG
- getwd() : La taille de la chaîne, terminée par un octet nul, du chemin absolu dépasse PATH_MAX octets.
- ENOENT
- Le répertoire en cours a été supprimé.
- ERANGE
- Le paramètre size est inférieur à la longueur du nom du chemin absolu du répertoire de travail, caractère nul de fin compris. Allouez un tampon plus grand et réessayez.
CONFORMITɶ
getcwd() se conforme à POSIX.1-2001. Notez cependant que POSIX.1-2001 laisse le comportement de getcwd() non spécifié si buf est NULL.NOTES¶
Sous Linux, la fonction getcwd() est un appel système (depuis le 2.1.92). Sur des systèmes plus anciens, elle interrogerait /proc/self/cwd. Si l'appel système et le système de fichiers proc sont absents, une implémentation générique est utilisée. Dans ce cas seulement la fonction peut renvoyer EACCES sous Linux. 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 fichier.VOIR AUSSI¶
chdir(2), fchdir(2), open(2), unlink(2), free(3), malloc(3)COLOPHON¶
Cette page fait partie de la publication 3.44 du projet man-pages Linux. Une description du projet et des instructions pour signaler des anomalies peuvent être trouvées à l'adresse <http://www.kernel.org/doc/man-pages/>.TRADUCTION¶
Depuis 2010, cette traduction est maintenue à l'aide de l'outil po4a <http://po4a.alioth.debian.org/> par l'équipe de traduction francophone au sein du projet perkamon <http://perkamon.alioth.debian.org/>. Christophe Blaess <http://www.blaess.fr/christophe/> (1996-2003), Alain Portal <http://manpagesfr.free.fr/> (2003-2006). Florentin Duneau et l'équipe francophone de traduction de Debian (2006-2009). Veuillez signaler toute erreur de traduction en écrivant à <debian-l10n-french@lists.debian.org> ou par un rapport de bogue sur le paquet manpages-fr. Vous pouvez toujours avoir accès à la version anglaise de ce document en utilisant la commande « man -L C <section> <page_de_man> ».20 septembre 2010 | GNU |