Scroll to navigation

symlink(2) System Calls Manual symlink(2)

NAZWA

symlink, symlinkat - tworzy nową nazwę dla pliku

BIBLIOTEKA

Standardowa biblioteka C (libc, -lc)

SKŁADNIA

#include <unistd.h>
int symlink(const char *target, const char *linkpath);
#include <fcntl.h>           /* Definicja stałych AT_* */
#include <unistd.h>
int symlinkat(const char *target, int newdirfd, const char *linkpath);


Wymagane ustawienia makr biblioteki glibc (patrz
  feature_test_macros(7)):


symlink():




    _XOPEN_SOURCE >= 500 || _POSIX_C_SOURCE >= 200112L


        || /* glibc <= 2.19: */ _BSD_SOURCE


symlinkat():




    Od glibc 2.10:


        _POSIX_C_SOURCE >= 200809L


    Przed glibc 2.10:


        _ATFILE_SOURCE






OPIS


symlink() tworzy dowiązanie symboliczne o nazwie
    linkpath które zawiera łańcuch znakowy
    target.


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 (czasem nazywane
    również miękkim dowiązaniem) może
    wskazywać na plik istniejący, lub nieistniejący; ten
    drugi przypadek znany jest pod pojęciem wiszącego
    dowiązania.


Prawa dostępu dla dowiązania symbolicznego są
    nieistotne; jego własność jest ignorowana podczas
    podążania za nim (z wyjątkiem sytuacji, gdy
    włączono funkcję protected_symlinks, zgodnie z
    wyjaśnieniem w proc(5)), lecz sprawdzane podczas usuwania lub
    przemianowywania, gdy dowiązanie jest w katalogu z ustawionym bitem
    lepkości (S_ISVTX).


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




symlinkat()


Wywołanie systemowe symlinkat() operuje w
    dokładnie taki sam sposób jak symlink(), z
    wyjątkiem różnic opisanych tutaj.


Jeśli ścieżka podana w linkpath jest
    względna, jest to interpretowane w odniesieniu do katalogu do
    którego odnosi się deskryptor pliku newdirfd (zamiast w
    odniesieniu do bieżącego katalogu roboczego procesu
    wywołującego, jak w stosunku do ścieżek
    względnych robi to symlink()).


Jeśli linkpath jest względna a
    newdirfd ma wartość specjalną AT_FDCWD,
    to linkpath jest interpretowana w odniesieniu do
    bieżącego katalogu roboczego procesu
    wywołującego (jak symlink()).


Jeśli ścieżka linkpath jest
    bezwzględna, to newdirfd jest ignorowane.


Więcej informacji o potrzebie wprowadzenia
    symlinkat() można znaleźć w podręczniku
    openat(2).








WARTOŚĆ ZWRACANA


Po pomyślnym zakończeniu zwracane jest zero. Po
    błędzie zwracane jest -1 i ustawiane errno,
    wskazując błąd.






BŁĘDY



  

  
Odmówiono zapisu do katalogu zawierającego linkpath
      lub jeden z katalogów w składowej ścieżek
      linkpath nie zezwala na uprawnienie przeszukiwania (zob. też
      path_resolution(7)).

  

  
(symlinkat()) linkpath jest względne, lecz
      newdirfd nie wynosi ani AT_FDCWD, ani nie jest
      prawidłowym deskryptorem pliku.

  

  
Wyczerpano przydział zasobów użytkownika w systemie
      plików. Zasobami mogą być i-węzły lub
      bloki dyskowe, w zależności od implementacji systemu
      plików.

  

  
linkpath już istnieje.

  

  
target lub linkpath wskazuje poza dostępną dla
      użytkownika przestrzeń adresową.

  

  
Wystąpił błąd
    wejścia/wyjścia.

  

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

  

  
target lub linkpath było zbyt długie.

  

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

  

  
(symlinkat()) linkpath jest ścieżką
      względną, a newdirfd odnosi się do
      usuniętego katalogu.

  

  
Brak pamięci jądra.

  

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

  

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

  

  
(symlinkat()) linkpath jest względna, a
      newdirfd jest deskryptorem pliku odnoszącym się do
      pliku, zamiast do katalogu.

  

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

  

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








WERSJE


symlinkat() zostało dodane w Linuksie 2.6.16;
    obsługę biblioteki dodano do glibc w wersji 2.4.






STANDARDY


symlink(): SVr4, 4.3BSD, POSIX.1-2001, POSIX.1-2008.


symlinkat(): POSIX.1-2008.






UWAGI


Nie jest dokonywane sprawdzenie target.


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 pożądane, należy
    używać link(2).




Uwagi dla glibc


Na starszych wersjach jądra Linux, gdzie symlinkat()
    nie było dostępne, funkcja opakowująca z glibc wraca do
    używania symlink(). Kiedy linkpath jest
    względną ścieżką, glibc konstruuje
    ścieżkę na bazie dowiązania symbolicznego w
    /proc/self/fd, które odpowiada argumentowi
  newdirfd.








ZOBACZ TAKŻE


ln(1), namei(1), lchown(2), link(2),
    lstat(2), open(2), readlink(2), rename(2),
    unlink(2), path_resolution(7), symlink(7)






TŁUMACZENIE


Autorami polskiego tłumaczenia niniejszej strony
    podręcznika są: Przemek Borys <pborys@dione.ids.pl>,
    Andrzej Krzysztofowicz <ankry@green.mf.pg.gda.pl> i Michał
    Kułach <michal.kulach@gmail.com>


Niniejsze tłumaczenie jest wolną
    dokumentacją. Bliższe informacje o warunkach licencji
    można uzyskać zapoznając się z
    GNU General
    Public License w wersji 3 lub nowszej. Nie przyjmuje się
    ŻADNEJ ODPOWIEDZIALNOŚCI.


Błędy w tłumaczeniu strony podręcznika
    prosimy zgłaszać na adres listy dyskusyjnej
    manpages-pl-list@lists.sourceforge.net.







  

    5 lutego 2023 r.
    Linux man-pages 6.03