realpath(3)

NUME
realpath - returnează numele de rută absolut canonizat

BIBLIOTECA
Biblioteca C standard (libc, -lc)

REZUMAT
#include <limits.h>
#include <stdlib.h>

char *realpath(const char *restrict path,
               char *restrict resolved_path);

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

realpath():
    _XOPEN_SOURCE >= 500
        || /* glibc >= 2.19: */ _DEFAULT_SOURCE
        || /* glibc <= 2.19: */ _BSD_SOURCE

DESCRIERE
realpath() extinde toate legăturile simbolice și rezolvă referințele la caracterele /./, /../ și la caracterele suplimentare '/' din șirul cu terminație nulă numit de path pentru a produce un nume de rută absolut canonizat. Numele de rută rezultat este stocat sub forma unui șir cu terminație nulă, până la un maxim de PATH_MAX octeți, în memoria tampon indicată de resolved_path. Ruta rezultată nu va avea nici o legătură simbolică, nici componente /./ sau /../.

Dacă resolved_path este specificat ca fiind NULL, atunci realpath() utilizează malloc(3) pentru a aloca o memorie tampon de până la PATH_MAX octeți pentru a păstra numele de rută rezolvat și returnează un indicator la această memorie tampon. Apelantul ar trebui să elibereze această memorie tampon folosind free(3).

VALOAREA RETURNATĂ
Dacă nu există nicio eroare, realpath() returnează un indicator către resolved_path.

În caz contrar, se returnează NULL, conținutul matricei resolved_path este nedefinit, iar errno este configurată pentru a indica eroarea.

ERORI

EACCES
    Permisiunea de citire sau de căutare a fost refuzată pentru o componentă a prefixului rutei.

EINVAL
    path este NULL; (înainte de glibc 2.3, această eroare este returnată și dacă resolved_path este NULL).

EIO A apărut o eroare de In/Ieș în timpul citirii din sistemul de fișiere.

ELOOP
    S-au întâlnit prea multe legături simbolice la conversia numelui de rută.

ENAMETOOLONG
    O componentă a unui nume de rută a depășit NAME_MAX caractere sau un nume de rută întreg a depășit PATH_MAX caractere.

ENOENT
    Fișierul numit nu există.

ENOMEM
    Memorie insuficientă.

ENOTDIR
    O componentă a prefixului de rută nu este un director.

ATRIBUTE
Pentru o explicație a termenilor folosiți în această secțiune, a se vedea attributes(7).
Interfață | Atribut | Valoare
realpath() | Siguranța firelor | MT-Safe

VERSIUNI

  Extensii GNU
Dacă apelul eșuează fie cu EACCES, fie cu ENOENT și resolved_path nu este NULL, atunci prefixul din path care nu poate fi citit sau nu există este returnat în resolved_path.

STANDARDE
POSIX.1-2008.

ISTORIC
4.4BSD, POSIX.1-2001, Solaris.

POSIX.1-2001 spune cu privire la comportamentul în cazul în care resolved_path este NULL, că este definit de implementare. POSIX.1-2008 specifică comportamentul descris în această pagină.

În 4.4BSD și Solaris, limita de lungime a numelui de rută este MAXPATHLEN (se găsește în <sys/param.h>). SUSv2 prescrie PATH_MAX și NAME_MAX, așa cum se găsește în <limits.h> sau cum este furnizată de funcția pathconf(3). Un fragment tipic de sursă ar fi

    #ifdef PATH_MAX
      path_max = PATH_MAX;
    #else
      path_max = pathconf(path, _PC_PATH_MAX);
      if (path_max <= 0)
        path_max = 4096;
    #endif

(Dar consultați secțiunea ERORI).

ERORI
Versiunea standard POSIX.1-2001 a acestei funcții este incorectă prin proiectare, deoarece este imposibil să se determine o dimensiune adecvată pentru memoria tampon de ieșire, resolved_path. În conformitate cu POSIX.1-2001, este suficientă o memorie tampon de dimensiune PATH_MAX, dar PATH_MAX nu trebuie să fie o constantă definită și este posibil să trebuiască să fie obținută folosind pathconf(3). Iar solicitarea lui pathconf(3) nu ajută cu adevărat, deoarece, pe de o parte, POSIX avertizează că rezultatul lui pathconf(3) poate fi uriaș și nepotrivit pentru alocarea de memorie, iar pe de altă parte, pathconf(3) poate returna -1 pentru a indica faptul că PATH_MAX nu este delimitat. Caracteristica resolved_path == NULL, care nu este standardizată în POSIX.1-2001, dar este standardizată în POSIX.1-2008, permite evitarea acestei probleme de proiectare.

CONSULTAȚI ȘI
realpath(1), readlink(2), canonicalize_file_name(3), getcwd(3), pathconf(3), sysconf(3)

TRADUCERE
Traducerea în limba română a acestui manual a fost creată de Remus-Gabriel Chelu <remusgabriel.chelu@disroot.org>

Această traducere este documentație gratuită; citiți Licența publică generală GNU Versiunea 3 (https://www.gnu.org/licenses/gpl-3.0.html) sau o versiune ulterioară cu privire la condiții privind drepturile de autor. NU se asumă Nicio RESPONSABILITATE.

Dacă găsiți erori în traducerea acestui manual, vă rugăm să trimiteți un e-mail la translation-team-ro@lists.sourceforge.net.