GETCWD(3)          Manuel du programmeur Linux          GETCWD(3)


NOM
       getcwd,  get_current_dir_name,  getwd  - Obtenir le réper­
       toire courant.

SYNOPSIS
       #include <unistd.h>

       char *getcwd (char *buf, size_t size);
       char *get_current_working_dir_name (void);
       char *getwd (char *buf);

DESCRIPTION
       La fonction getcwd() copie le  chemin  d'accès  absolu  du
       répertoire  de  travail courant dans la chaîne pointée par
       buf, qui est de longueur size.

       Si le chemin du répertoire en cours  nécessite  un  buffer
       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 buffer plus grand
       si besoin est.

       Comme extension du standard POSIX.1,  getcwd()  alloue  le
       buffer  dynamiquement,  en  utilisant malloc(), si buf est
       NULL lors de  l'appel.   Alors,  le  buffer  alloué  a  la
       longueur  size  à  moins  que size soit inférieure à zéro,
       dans ce cas buf a la taille nécessaire.  Il  est  possible
       (et  même  fortement  conseillé) de libérer le buffer avec
       free() lorsqu'il a été obtenu ainsi.

       get_current_dir_name, qui ne possède un prototype  que  si
       la  constante  __USE_GNU  est  définie, allouera avec mal­
       loc(3) une chaîne suffisament grande pour contenir le  nom
       du répertoire. Si la variable d'environnement PWD est con­
       figurée, et correcte, cette valeur sera renvoyée.

       getwd, qui ne possède un prototype  que  si  la  constante
       __USE_BSD est définie, n'allouera aucune mémoire.  L'argu­
       ment 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.

VALEUR RENVOYÉE
       NULL en cas d'échec (par exemple si le répertoire en cours
       n'est pas lisible), avec errno contenant le code d'erreur.
       En cas de réussite buf est renvoyé.

CONFORMITÉ
       POSIX.1

VOIR AUSSI
       chdir(2), free(3), malloc(3).





GNU                      26 Octobre 1996                        1





GETCWD(3)          Manuel du programmeur Linux          GETCWD(3)


TRADUCTION
       Christophe Blaess, 1997.























































GNU                      26 Octobre 1996                        2