NAZWA

       symlink - tworzenie nowej nazwy dla pliku

SKŁADNIA

       #include <unistd.h>

       int symlink(const char *oldpath, const char *newpath);

OPIS

        Uwaga! To tłumaczenie może być nieaktualne!

       symlink  tworzy  dowiązanie  symboliczne  o  nazwie  newpath które zawiera łańcuch znakowy
       oldpath.

       Dowiązania  symboliczne  są  interpretowane  w  czasie  działania,  tak  jakby   zawartość
       dowiązania była podstawiana do ścieżki, przeglądanej by znaleźć plik lub katalog.

       Dowiązania  symboliczne  mogą  zawierać  składniki  ..,  które  (jeśli używane na początku
       dowiązania) odnoszą się do katalogów nadrzędnych katalogu, w którym  dane  dowiązanie  się
       znajduje.

       Dowiązanie  symboliczne  (znane  również  pod nazwą miękiego dowiązania) może wskazywać na
       plik istniejący, lub nie istniejący; ten drugi przypadek znany jest pod pojęciem wiszącego
       dowiązania.

       Prawa  dostępu  dla  dowiązania  symbolicznego  są  nieistotne;  jego  właścicielstwo jest
       ignorowane  podczas   podążania   za   nim,   lecz   sprawdzane   podczas   usuwania   lub
       przemianowywania, gdy dowiązanie jest w katalogu z ustawionym bitem `sticky'.

       Jeśli ścieżka newpath istnieje to nie będzie nadpisana.

WARTOŚĆ ZWRACANA

       Po  pomyślnym  zakończeniu  zwracane  jest zero. Po błędzie zwracane jest -1 i odpowiednio
       ustawiane errno.

BŁĘDY

       EPERM  System plików zawierający pathname nie zezwala na tworzenie dowiązań symbolicznych.

       EFAULT oldpath lub newpath wskazuje poza dostępną dla użytkownika przestrzeń adresową.

       EACCES Zapis do katalogu zawierającego newpath nie  jest  dozwolony  dla  efektywnego  UID
              procesu  wywołującego  tę  funkcję  lub  jeden z katalogów w newpath nie pozwala na
              przeszukiwanie (wykonywanie).

       ENAMETOOLONG
              oldpath lub newpath było zbyt długie.

       ENOENT Składnik newpath, który powinien być katalogiem, nie  istnieje  lub  jest  wiszącym
              dowiązaniem symbolicznym lub oldpath jest łańcuchem pustym.

       ENOTDIR
              Składnik użyty jako katalog w newpath w rzeczywistości nie jest katalogiem.

       ENOMEM Brak pamięci jądra.

       EROFS  Plik newpath znajduje się na systemie plików tylko dla odczytu.

       EEXIST newpath już istnieje.

       ELOOP  Podczas rozwiązywania newpath napotkano zbyt wiele dowiązań symbolicznych.

       ENOSPC Na urządzeniu, zawierającym plik nie ma miejsca na kolejny wpis w katalogu.

       EIO    Wystąpił błąd we/wy.

UWAGI

       Nie jest dokonywane sprawdzenie oldpath.

       Usunięcie  nazwy,  na  którą  wskazuje  dowiązanie symboliczne, w rzeczywistości spowoduje
       skasowanie pliku (chyba że ma jeszcze inne twarde dowiązania).  Jeśli  zachowanie  to  nie
       jest porządane, należy używać link.

ZGODNE Z

       SVr4,  SVID,  BSD  4.3  X/OPEN.  SVr4  dokumentuje  dodatkowe kody błędów EDQUOT i ENOSYS.
       Zobacz open(2) po wiele plików o tej samej nazwie oraz NFS.

ZOBACZ TAKŻE

       readlink(2), link(2), unlink(2), rename(2), open(2), lstat(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 symlink

       Prosimy  o  pomoc  w  aktualizacji stron man - więcej informacji można znaleźć pod adresem
       http://sourceforge.net/projects/manpages-pl/.