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)

INFORMACJE O TŁUMACZENIU

       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/.