unlink(2)                     System Calls Manual                    unlink(2)

NUME
       unlink, unlinkat - <?>terge un nume <?>i, eventual, fi<?>ierul la care
       se refera

BIBLIOTECA
       Biblioteca C standard (libc, -lc)

SINOPSIS
       #include <unistd.h>

       int unlink(const char *ruta);

       #include <fcntl.h>           /* Definirea constantelor AT_* */
       #include <unistd.h>

       int unlinkat(int fd-director, const char *ruta, int fanioane);

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

       unlinkat():
           Incepand cu glibc 2.10
               _POSIX_C_SOURCE >= 200809L
           Inainte de glibc 2.10:
               _ATFILE_SOURCE

DESCRIERE
       unlink() <?>terge un nume din sistemul de fi<?>iere. Daca numele
       respectiv a fost ultima legatura la un fi<?>ier <?>i niciun proces nu
       are fi<?>ierul deschis, fi<?>ierul este <?>ters, iar spa<?>iul pe care
       il folosea este disponibil pentru reutilizare.

       Daca numele a fost ultima legatura la un fi<?>ier, dar orice proces are
       inca fi<?>ierul deschis, fi<?>ierul va ramane in existen<?>a pana cand
       ultimul descriptor de fi<?>ier care se refera la acesta este inchis.

       In cazul in care numele se referea la o legatura simbolica, aceasta
       este eliminata.

       Daca numele se referea la un soclu, FIFO sau dispozitiv, numele
       acestuia este eliminat, dar procesele care au obiectul deschis pot
       continua sa il utilizeze.

   unlinkat()
       Apelul de sistem unlinkat() func<?>ioneaza exact in acela<?>i mod ca
       unlink() sau rmdir(2) (in func<?>ie de faptul daca fanioane include sau
       nu fanionul AT_REMOVEDIR), cu excep<?>ia diferen<?>elor descrise aici.

       Daca ruta data in ruta este relativa, atunci aceasta este interpretata
       in raport cu directorul la care se refera descriptorul de fi<?>ier
       fd-director ( <?>i nu in raport cu directorul curent de lucru al
       procesului apelant, a<?>a cum se procedeaza in unlink() <?>i rmdir(2)
       pentru un nume de ruta relativ).

       Daca ruta data in ruta este relativa <?>i fd-director este valoarea
       speciala AT_FDCWD, atunci ruta este interpretata relativ la directorul
       curent de lucru al procesului apelant (ca unlink() <?>i rmdir(2)).

       Daca ruta este absoluta, atunci fd-director este ignorat.

       fanioane este o masca de bi<?>i care poate fi specificata fie ca 0, fie
       prin asocierea conform logicii SAU a valorilor fanioanelor care
       controleaza func<?>ionarea unlinkat(). In prezent, este definit un
       singur astfel de fanion:

       AT_REMOVEDIR
              In mod implicit, unlinkat() efectueaza echivalentul lui unlink()
              pe ruta. Daca fanionul AT_REMOVEDIR este specificat, efectueaza
              echivalentul lui rmdir(2) pe ruta.

       A se vedea openat(2) pentru o explica<?>ie a necesita<?>ii unlinkat().

VALOAREA RETURNATA
       In caz de succes, se returneaza zero. In caz de eroare, se returneaza
       -1, iar errno este configurata pentru a indica eroarea.

ERORI-IE<?>IRE
       EACCES Accesul de scriere la directorul care con<?>ine ruta nu este
              permis pentru UID-ul efectiv al procesului, sau unul dintre
              directorii din ruta nu a permis permisiunea de cautare; (a se
              vedea <?>i path_resolution(7)).

       EBUSY  Fi<?>ierul ruta nu poate fi dezlegat deoarece este utilizat de
              sistem sau de un alt proces; de exemplu, este un punct de
              montare sau software-ul client NFS l-a creat pentru a reprezenta
              un nod-i activ, dar fara nume (,,NFS silly renamed").

       EFAULT ruta indica in afara spa<?>iului de adrese accesibil.

       EIO    A aparut o eroare de In/Ie<?>.

       EISDIR ruta se refera la un director; (aceasta este valoarea non-POSIX
              returnata de la Linux 2.1.132).

       ELOOP  Prea multe legaturi simbolice au fost intalnite in traducerea
              rutei.

       ENAMETOOLONG
              ruta era prea lunga.

       ENOENT O componenta din ruta nu exista sau este o legatura simbolica
              rupta, sau ruta este goala.

       ENOMEM Nu a fost disponibila suficienta memorie pentru nucleu.

       ENOTDIR
              O componenta utilizata ca director in ruta nu este, de fapt, un
              director.

       EPERM  Sistemul nu permite dezlegarea directoarelor sau dezlegarea
              directoarelor necesita privilegii pe care procesul apelant nu le
              are; (acesta este rezultatul de eroare prescris de POSIX; dupa
              cum s-a men<?>ionat mai sus, Linux returneaza EISDIR pentru
              acest caz).

       EPERM (numai in Linux)
              Sistemul de fi<?>iere nu permite dezlegarea fi<?>ierelor.

       EPERM sau EACCES
              Directorul care con<?>ine ruta are bitul lipicios (S_ISVTX)
              activat <?>i UID-ul efectiv al procesului nu este nici UID-ul
              fi<?>ierului care urmeaza sa fie <?>ters, nici cel al
              directorului care il con<?>ine, iar procesul nu este privilegiat
              (Linux: nu are capacitatea CAP_FOWNER).

       EPERM  Fi<?>ierul care urmeaza sa fie dezlegat este marcat ca fiind
              imuabil sau numai cu adaugare; (a se vedea
              FS_IOC_SETFLAGS(2const).)

       EROFS  ruta se refera la un fi<?>ier pe un sistem de fi<?>iere
              numai-pentru-citire.

       Acelea<?>i erori care apar pentru unlink() <?>i rmdir(2) pot aparea
       <?>i pentru unlinkat(). Urmatoarele erori suplimentare pot aparea
       pentru unlinkat():

       EBADF  ruta este relativa, dar dirfd nu este nici AT_FDCWD, nici un
              descriptor de fi<?>ier valid.

       EINVAL O valoare nevalida de fanion a fost specificata in fanioane.

       EISDIR ruta se refera la un director, iar AT_REMOVEDIR nu a fost
              specificat in fanioane.

       ENOTDIR
              ruta este relativa <?>i dirfd este un descriptor de fi<?>ier ce
              se refera la un alt fi<?>ier decat un director.

STANDARDE
       POSIX.1-2008.

ISTORIC
       unlink()
              SVr4, 4.3BSD, POSIX.1-2001.

       unlinkat()
              POSIX.1-2008. Linux 2.6.16, glibc 2.4.

   glibc
       Pe nucleele mai vechi in care unlinkat() nu este disponibil, func<?>ia
       de invaluire glibc revine la utilizarea unlink() sau rmdir(2). Atunci
       cand ruta este o ruta relativa,, glibc construie<?>te un nume de ruta
       bazat pe legatura simbolica din /proc/self/fd care corespunde
       argumentului fd-director.

ERORI
       Neajunsurile din protocolul care sta la baza NFS pot provoca
       dispari<?>ia nea<?>teptata a fi<?>ierelor care sunt inca utilizate.

CONSULTA<?>I <?>I
       rm(1), unlink(1), chmod(2), link(2), mknod(2), open(2), rename(2),
       rmdir(2), mkfifo(3), remove(3), path_resolution(7), symlink(7)

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    17 mai 2025                        unlink(2)