Scroll to navigation

READLINK(2) Podręcznik programisty Linuksa READLINK(2)

NAZWA

readlink - odczytanie wartości dowiązania symbolicznego

SKŁADNIA

#include <unistd.h>

int readlink(const char *path, char *buf, size_t bufsiz);

OPIS

readlink umieszcza zawartość dowiązania symbolicznego path w buforze buf, którego wielkość wynosi bufsiz. readlink nie dokleja do bufora buf znaku NUL. W przypadku, gdy bufor jest za mały, aby pomieścić całą zawartość dowiązania, jest ona obcinana (do ilości znaków równej długości bufsiz).

WARTOŚĆ ZWRACANA

Wywołanie to, gdy się zakończy pomyślnie, zwraca liczbę znaków umieszczonych w buforze, lub -1 w przypadku wystąpienia błędu. Kod błędu jest umieszczany w errno.

BŁĘDY

Składnik ścieżki nie jest katalogiem.
bufsiz nie jest dodatnie.
Scieżka, lub składnik ścieżki były za długie.
Plik o podanej nazwie nie istnieje.
Brak praw przeszukiwania dla składnika ścieżki.
Natrafiono na zbyt wiele dowiązań symbolicznych podczas tłumaczenia ścieżki.
Podany plik nie jest dowiązaniem symbolicznym.
Podczas odczytu z systemu plików wystąpił błąd we/wy.
buf wskazuje poza przydzieloną procesowi przestrzeń adresową.
Zabrakło dostępnej pamięci kernela.

ZGODNE Z

X/OPEN, 4.4BSD (funkcja readlink pojawiła się w BSD 4.2).

ZOBACZ TAKŻE

stat(2), lstat(2), symlink(2)

1997-08-21 Linux 2.0.30