NAZWA¶

unlink, unlinkat - usuwa nazwę i może usunąć plik, do której nazwa ta się odnosi

BIBLIOTEKA¶

Standardowa biblioteka C (libc, -lc)

SKŁADNIA¶

#include <unistd.h>

int unlink(const char *pathname);

#include <fcntl.h>           /* Definicja stałych AT_* */
#include <unistd.h>

int unlinkat(int dirfd, const char *pathname, int flags);

unlinkat():

    Od glibc 2.10:


        _POSIX_C_SOURCE >= 200809L


    Przed glibc 2.10:


        _ATFILE_SOURCE

OPIS¶

unlink() usuwa nazwę z systemu plików. Jeśli nazwa ta była ostatnim dowiązaniem do pliku i żaden proces nie utrzymuje tego pliku otwartego, plik jest usuwany, a przestrzeń jaką zajmował staje się dostępna do ponowego użytku.

Jeśli nazwa była ostatnim dowiązaniem do pliku, lecz istnieją procesy, które utrzymują plik otwarty, plik będzie istniał do momentu zamknięcia ostatniego, odnoszącego się do niego, deskryptora pliku.

Jeśli nazwa odnosi się do dowiązania symbolicznego, dowiązanie to jest usuwane.

Jeśli nazwa odnosiła się do gniazda, FIFO lub urządzenia, nazwa ta jest usuwana, lecz procesy, które utrzymywały obiekt otwarty, wciąż mogą go używać.

WARTOŚĆ ZWRACANA¶

Po pomyślnym zakończeniu zwracane jest zero. Po błędzie zwracane jest -1 i ustawiane errno, wskazując błąd.

BŁĘDY¶

EACCES

Dostęp do zapisu do katalogu zawierającego pathname nie jest dozwolony dla efektywnego UID-u procesu, albo jeden z katalogów w pathname nie dozwala na uprawnienie przeszukania (zob. też path_resolution(7)).

EBUSY

Plik pathname nie może być odlinkowany, ponieważ jest używany przez system lub inny proces np. jest punktem montowania lub oprogramowanie klienta NFS utworzyło go do reprezentacji aktywnego, ale poza tym nienazwanego i-węzła („NFS silly renamed” — „głupio przemianowane przez NFS”).

EFAULT

pathname wskazuje poza dostępną dla użytkownika przestrzeń adresową.

EIO

Wystąpił błąd wejścia/wyjścia.

EISDIR

pathname odnosi się do katalogu (jest to wartość spoza POSIX, zwracana od Linuksa 2.1.132).

ELOOP

Przy tłumaczeniu pathname napotkano zbyt wiele dowiązań symbolicznych.

ENAMETOOLONG

pathname było zbyt długie.

ENOENT

Składowa ścieżki pathname nie istnieje lub jest wiszącym dowiązaniem symbolicznych, lub pathname jest pusta.

ENOMEM

Brak pamięci jądra.

ENOTDIR

Składnik pathname, który powinien być katalogiem w rzeczywistości katalogiem nie jest.

EPERM

System nie zezwala na odlinkowanie katalogów lub odlinkowanie katalogów wymaga przywilejów, którymi nie dysponuje proces wywołujący (jest to błąd przewidziany przez POSIX, jak zaznaczono wyżej, Linux w tym przypadku zwraca EISDIR).

EPERM (tylko Linux)

System plików nie zezwala na odlinkowanie plików.

EPERM lub EACCES

Katalog zawierający pathname ma ustawiony bit lepkości (S_ISVTX), a efektywny UID procesu nie jest ani UID-em usuwanego pliku, ani katalogu go zawierającego oraz proces nie jest uprzywilejowany (Linux: nie ma przywileju CAP_FOWNER).

EPERM

Plik do odlinkowania jest oznaczony jako nienaruszalny (immutable) lub tylko do dopisu (zob. ioctl_iflags(2)).

EROFS

pathname odnosi się do pliku w systemie plików tylko do odczytu.

Błędy, które mogą wystąpić w unlink() i rmdir(2) mogą również wystąpić w unlinkat(). Następujące dodatkowe błędy mogą wystąpić w unlinkat():

EBADF

pathname jest względna, lecz dirfd nie wynosi ani AT_FDCWD, ani nie jest prawidłowym deskryptorem pliku.

EINVAL

We flags podano nieprawidłową wartość znacznika.

EISDIR

pathname odnosi się do katalogu, a we flags nie podano AT_REMOVEDIR.

ENOTDIR

pathname jest względna a dirfd jest deskryptorem pliku odnoszącym się do pliku zamiast do katalogu.

WERSJE¶

unlinkat() dodano w Linuksie 2.6.16; obsługę w bibliotece dodano w glibc 2.4.

STANDARDY¶

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

unlinkat(): POSIX.1-2008.

UWAGI¶

USTERKI¶

Nietrafne rozwiązania w protokole odpowiedzialnym za obsługę NFS mogą spowodować nieoczekiwane zniknięcie plików, które są wciąż w użyciu.

ZOBACZ TAKŻE¶

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)

TŁUMACZENIE¶

Autorami polskiego tłumaczenia niniejszej strony podręcznika są: Michał Kułach <michal.kulach@gmail.com>

Niniejsze tłumaczenie jest wolną dokumentacją. Bliższe informacje o warunkach licencji można uzyskać zapoznając się z GNU General Public License w wersji 3 lub nowszej. Nie przyjmuje się ŻADNEJ ODPOWIEDZIALNOŚCI.

Błędy w tłumaczeniu strony podręcznika prosimy zgłaszać na adres listy dyskusyjnej manpages-pl-list@lists.sourceforge.net.