getcwd(3)                  Library Functions Manual                  getcwd(3)

NUME
       getcwd, getwd, get_current_dir_name - ob<?>ine directorul curent de
       lucru

BIBLIOTECA
       Biblioteca C standard (libc, -lc)

SINOPSIS
       #include <unistd.h>

       char *getcwd(size_t size;
                    char buf[size], size_t size);
       char *get_current_dir_name(void);

       [[depreciat]] char *getwd(char buf[PATH_MAX]);

   Cerin<?>e pentru macrocomenzi de testare a caracteristicilor pentru glibc
   (consulta<?>i feature_test_macros(7)):

       get_current_dir_name():
           _GNU_SOURCE

       getwd():
           Incepand cu glibc 2.12:
               (_XOPEN_SOURCE >= 500) && ! (_POSIX_C_SOURCE >= 200809L)
                   || /* glibc >= 2.19: */ _DEFAULT_SOURCE
                   || /* glibc <= 2.19: */ _BSD_SOURCE
           Inainte de glibc 2.12:
               _BSD_SOURCE || _XOPEN_SOURCE >= 500

DESCRIERE
       Aceste func<?>ii returneaza un <?>ir de caractere cu termina<?>ie nula
       care con<?>ine un nume de ruta absolut care este directorul de lucru
       curent al procesului apelant. Numele rutei este returnat ca rezultat al
       func<?>iei <?>i prin intermediul argumentului buf, daca este prezent.

       Func<?>ia getcwd() copiaza un nume de ruta absolut al directorului
       curent de lucru in matricea indicata de buf, care are lungimea size.

       Daca lungimea numelui de ruta absolut al directorului de lucru curent,
       inclusiv octetul nul de terminare, depa<?>e<?>te size octe<?>i, se
       returneaza NULL, iar errno este stabilita la ERANGE; o aplica<?>ie
       trebuie sa verifice aceasta eroare <?>i sa aloce o memorie tampon mai
       mare daca este necesar.

       Ca extensie la standardul POSIX.1-2001, getcwd() al glibc aloca memoria
       tampon dinamic folosind malloc(3) daca buf este NULL. In acest caz,
       memoria tampon alocata are lungimea size, cu excep<?>ia cazului in care
       size este zero, cand buf este alocat cat de mare este necesar.
       Apelantul trebuie sa elibereze cu free(3) memoria tampon returnata.

       get_current_dir_name() va aloca cu malloc(3) o matrice suficient de
       mare pentru a con<?>ine ruta absoluta a directorului curent de lucru.
       Daca variabila de mediu PWD este definita, iar valoarea sa este
       corecta, atunci aceasta valoare va fi returnata. Apelantul trebuie sa
       elibereze cu free(3) memoria tampon returnata.

       getwd() nu malloc(3) nicio memorie. Argumentul buf trebuie sa fie un
       indicator catre o matrice cu o lungime de cel pu<?>in PATH_MAX
       octe<?>i. Daca lungimea numelui de ruta absolut al directorului de
       lucru curent, inclusiv octetul nul de terminare, depa<?>e<?>te PATH_MAX
       octe<?>i, se returneaza NULL, iar errno este stabilitat la
       ENAMETOOLONG. - Re<?>ine<?>i ca pe unele sisteme, PATH_MAX poate sa nu
       fie o constanta in timp de compilare; in plus, valoarea sa poate
       depinde de sistemul de fi<?>iere, consulta<?>i pathconf(3)). - Din
       motive de portabilitate <?>i securitate, utilizarea lui getwd() este
       depreciata.

VALOAREA RETURNATA
       In caz de succes, aceste func<?>ii returneaza un indicator catre un
       <?>ir de caractere care con<?>ine numele de ruta al directorului de
       lucru curent. In cazul func<?>iilor getcwd() <?>i getwd(), aceasta are
       aceea<?>i valoare ca buf.

       In caz de e<?>ec, aceste func<?>ii returneaza NULL, iar errno este
       configurata pentru a indica eroarea. Con<?>inutul matricei indicate de
       buf este nedefinit in caz de eroare.

ERORI-IE<?>IRE
       EACCES Permisiunea de a citi sau de a cauta o componenta a numelui
              fi<?>ierului a fost refuzata.

       EFAULT buf indica o adresa gre<?>ita.

       EINVAL Argumentul size este zero <?>i buf nu este un indicator nul.

       EINVAL getwd(): buf este NULL.

       ENAMETOOLONG
              getwd(): Dimensiunea <?>irului de nume de ruta absolut cu
              termina<?>ie nula depa<?>e<?>te PATH_MAX octe<?>i.

       ENOENT Directorul curent de lucru a fost dezlegat(<?>ters).

       ENOMEM Memorie insuficienta.

       ERANGE Argumentul size este mai mic decat lungimea numelui de ruta
              absolut al directorului de lucru, inclusiv octetul nul de
              incheiere. Trebuie sa aloca<?>i o matrice mai mare <?>i sa
              incerca<?>i din nou.

ATRIBUTE
       Pentru o explica<?>ie a termenilor folosi<?>i in aceasta sec<?>iune, a
       se vedea attributes(7).

       +----------------------------------+---------------------+-------------+
       |Interfa<?>a                       | Atribut             | Valoare     |
       +----------------------------------+---------------------+-------------+
       |getcwd(), getwd()                 | Siguran<?>a firelor | MT-Safe     |
       +----------------------------------+---------------------+-------------+
       |get_current_dir_name()            | Siguran<?>a firelor | MT-Safe env |
       +----------------------------------+---------------------+-------------+
VERSIUNI
       POSIX.1-2001 lasa comportamentul lui getcwd() nespecificat daca buf
       este NULL.

       POSIX.1-2001 nu define<?>te nicio eroare pentru getwd().

VERSIUNI
   Diferen<?>e intre biblioteca C <?>i nucleu
       In Linux, nucleul ofera un apel de sistem getcwd(), pe care func<?>iile
       descrise in aceasta pagina il vor utiliza daca este posibil. Apelul de
       sistem ia acelea<?>i argumente ca <?>i func<?>ia de biblioteca cu
       acela<?>i nume, dar este limitat la returnarea a cel mult PATH_MAX
       octe<?>i. (Inainte de Linux 3.12, limita de dimensiune a numelui de
       ruta returnat era dimensiunea paginii de sistem. Pe multe arhitecturi,
       PATH_MAX <?>i dimensiunea paginii de sistem sunt ambele de 4096
       octe<?>i, dar cateva arhitecturi au o dimensiune a paginii mai mare).
       Daca lungimea numelui de ruta al directorului de lucru curent
       depa<?>e<?>te aceasta limita, atunci apelul de sistem e<?>ueaza cu
       eroarea ENAMETOOLONG. In acest caz, func<?>iile bibliotecii revin la o
       implementare alternativa (mai lenta) care returneaza numele de ruta
       complet.

       Ca urmare a unei modificari in Linux 2.6.36, numele de ruta returnat de
       apelul de sistem getcwd() va fi prefixat cu <?>irul ,,(unreachable)"
       daca directorul curent nu se afla sub directorul radacina al procesului
       curent (de exemplu, deoarece procesul a stabilit o noua radacina a
       sistemului de fi<?>iere utilizand chroot(2) fara a-<?>i schimba
       directorul curent in noua radacina). Un astfel de comportament poate fi
       cauzat <?>i de un utilizator neprivilegiat prin schimbarea directorului
       curent intr-un alt spa<?>iu de nume de montare. Atunci cand au de-a
       face cu nume de ruta din surse neincrezatoare, apelan<?>ii func<?>iilor
       descrise in aceasta pagina (inainte de glibc 2.27) sau apelul de sistem
       getcwd() brut ar trebui sa ia in considerare verificarea daca numele de
       ruta returnat incepe cu ,,/" sau ,,(" pentru a evita interpretarea
       eronata a unei rute inaccesibile ca fiind un nume de ruta relativ.

STANDARDE
       getcwd()
              POSIX.1-2008.

       get_current_dir_name()
              GNU.

       getwd()
              Niciunul.

ISTORIC
       getcwd()
              POSIX.1-2001.

       getwd()
              POSIX.1-2001, dar marcat ca INVECHIT. Eliminat in POSIX.1-2008.
              Utiliza<?>i in schimb getcwd().

       Sub Linux, aceste func<?>ii utilizeaza apelul de sistem getcwd()
       (disponibil incepand cu Linux 2.1.92). Pe sistemele mai vechi, acestea
       ar interoga /proc/self/cwd. Daca lipsesc atat apelul de sistem, cat
       <?>i sistemul de fi<?>iere proc, este apelata o implementare generica.
       Numai in acest caz aceste apeluri pot e<?>ua sub Linux cu EACCES.

NOTE
       Aceste func<?>ii sunt adesea utilizate pentru a salva loca<?>ia
       directorului curent de lucru in scopul revenirii la acesta ulterior.
       Deschiderea directorului curent (,,.") <?>i apelarea fchdir(2) pentru a
       reveni este de obicei o alternativa mai rapida <?>i mai fiabila atunci
       cand sunt disponibili suficient de mul<?>i descriptori de fi<?>iere, in
       special pe alte platforme decat Linux.

ERORI
       De la modificarea Linux 2.6.36 care a adaugat ,,(unreachable)" in
       circumstan<?>ele descrise mai sus, implementarea glibc a getcwd() nu
       s-a conformat POSIX <?>i a returnat un nume de ruta relativ atunci cand
       loca<?>ia API necesita un nume de ruta absolut. Incepand cu glibc 2.27,
       acest lucru este corectat; apelarea getcwd() de la un astfel de nume de
       ruta va duce acum la e<?>ec cu ENOENT.

CONSULTA<?>I <?>I
       pwd(1), chdir(2), fchdir(2), open(2), unlink(2), free(3), malloc(3)

TRADUCERE
       Traducerea in limba romana a acestui manual a fost facuta de Remus-
       Gabriel Chelu <remusgabriel.chelu@disroot.org>

       Aceasta traducere este documenta<?>ie gratuita; citi<?>i Licen<?>a
       publica generala GNU Versiunea 3
       <https://www.gnu.org/licenses/gpl-3.0.html> sau o versiune ulterioara
       cu privire la condi<?>ii privind drepturile de autor.  NU se asuma
       NICIO RESPONSABILITATE.

       Daca gasi<?>i erori in traducerea acestui manual, va rugam sa
       trimite<?>i un e-mail la <translation-team-ro@lists.sourceforge.net>.

Pagini de manual de Linux 6.15   28 iunie 2025                       getcwd(3)