NAZWA¶
link - utworzenie nowej nazwy dla pliku
SKŁADNIA¶
#include <unistd.h>
int link(const char *oldpath, const char
*newpath);
OPIS¶
Uwaga! To tłumaczenie może być nieaktualne!
link tworzy nowe dowiązanie (nazywane też dowiązaniem
twardym) do istniejącego pliku.
Jeśli plik
newpath już istnieje, to
nie będzie
nadpisany.
Ta nowa nazwa może być używana dokłądnie tak samo jak
stara w dowolnychoperacjach; obie nazwy odnoszą się do tego samego
pliku (i w związku z tym mają te same prawa i
właścicielstwo). Nie można też powiedzieć, która
nazwa jest `oryginalna'.
WARTOŚĆ ZWRACANA¶
Po pomyślnym zakończeniu zwracane jest zero. Po błędzie
zwracane jest -1 i odpowiednio ustawiane
errno.
BŁĘDY¶
- EXDEV
- oldpath i newpath nie leżą na tym
samym systemie plików.
- EPERM
- system plików zawierający oldpath i
newpath nie obsługuje tworzenia twardych
dowiązań.
- EFAULT
- oldpath lub newpath wskazuje poza
dostępną dla użyrkownika przestrzeń
adresową.
- EACCES
- Zapis do katalogu zawierającego newpath nie
jest dozwolony dla efekywnego UID procesu, lub jeden z katalogów w
oldpath lub newpath nie daje uprawnień przeszukiwania
(wykonania).
- ENAMETOOLONG
- oldpath lub newpath było zbyt
długie.
- ENOENT
- Składnik katalogu w oldpath lub newpath nie
istnieje, lub jest wiszącym dowiązaniem symbolicznym.
- ENOTDIR
- Składnik oldpath lub newpath
używany jako katalog nie jest w rzeczywistości katalogiem.
- ENOMEM
- Brak dostępnej pamięci jądra.
- EROFS
- Plik leży na systemie plików tylko dla
odczytu.
- EEXIST
- newpath już istnieje.
- EMLINK
- Plik wskazywany przez oldpath ma już
maksymalną ilość dowiązań.
- ELOOP
- Podczas rozwiązywania oldpath lub
newpath napotkano zbyt wiele dowiązań symbolicznych.
- ENOSPC
- Na urządzeniu, zawierającym plik nie ma miejsca
na nowy wpis w katalogu.
- EPERM
- oldpath jest katalogiem.
- EIO
- Wystąpił błąd we/wy.
UWAGI¶
Twarde dowiązania, tworzone z pomocą
link, nie mogą
wykraczać poza jeden system plików. W takich sytuacjach można
użyć funkcji
symlink.
ZGODNE Z¶
SVr4, SVID, POSIX, BSD 4.3, X/OPEN. SVr4 dokumentuje dodatkowe błędy
ENOLINK i EMULTIHOP; POSIX.1 nie dokumentuje ELOOP. X/OPEN nie dokumentuje
EFAULT, ENOMEM ani EIO.
USTERKI¶
Na systemach NFS, wartość zwracana może być
nieprawidłowa w wypadku gdy serwer NFS dokonuje tworzenia dowiązania
i umiera przed zakomunikowaniem tego faktu. Można użyć
stat(2) aby dowiedzieć się czy dowiązanie zostało
utworzone.
ZOBACZ TAKŻE¶
symlink(2),
unlink(2),
rename(2),
open(2),
stat(2),
ln(1)
Powyższe tłumaczenie pochodzi z nieistniejącego już Projektu
Tłumaczenia Manuali i
może nie być aktualne. W razie
zauważenia różnic między powyższym opisem a
rzeczywistym zachowaniem opisywanego programu lub funkcji, prosimy o
zapoznanie się z oryginalną (angielską) wersją strony
podręcznika za pomocą polecenia:
- man --locale=C 2 link
Prosimy o pomoc w aktualizacji stron man - więcej informacji można
znaleźć pod adresem
http://sourceforge.net/projects/manpages-pl/.