focal (2) symlink.2.gz

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