Ubuntu Manpage: link, linkat - tworzy kolejną nazwę pliku

Provided by: manpages-pl-dev_4.23.1-1_all

NAZWA

       link, linkat - tworzy kolejną nazwę pliku

BIBLIOTEKA

       Standardowa biblioteka C (libc, -lc)

SKŁADNIA

       #include <unistd.h>

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

       #include <fcntl.h>           /* Definicja stałych AT_* */
       #include <unistd.h>

       int linkat(int olddirfd, const char *oldpath,
                  int newdirfd, const char *newpath, int flags);

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

       linkat():
           Od glibc 2.10:
               _POSIX_C_SOURCE >= 200809L
           Przed glibc 2.10:
               _ATFILE_SOURCE

OPIS

       link()  tworzy  nowe  dowiązanie  (nazywane  też  dowiązaniem  zwykłym  albo  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ładnie tak samo jak stara, w dowolnych operacjach;  obie
       nazwy  odnoszą  się  do  tego  samego  pliku (i w związku z tym mają te same uprawnienia i
       własność). Nie można też powiedzieć, która nazwa jest „oryginalna”.

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

       Jeśli  ścieżka  podana w oldpath jest względna, jest ona interpretowana względem katalogu,
       do którego odnosi się deskryptor  pliku  olddirfd  (zamiast  względem  bieżącego  katalogu
       roboczego   procesu  wywołującego,  jak  ma  to  miejsce  w  link()  w  przypadku  ścieżek
       względnych).

       Jeśli oldpath jest względna, a olddirfd ma wartość specjalną  AT_FDCWD,  to  oldpath  jest
       interpretowana  względem  bieżącego katalogu roboczego procesu wywołującego (czyli tak jak
       robi to link()).

       Jeśli oldpath jest bezwzględna, to olddirfd jest ignorowane.

       Interpretacja newpath jest taka sama jak oldpath, z tym  wyjątkiem,  że  ścieżka  względna
       jest interpretowana względem katalogu, do którego odnosi się deskryptor pliku newdirfd.

       Następujące wartości mogą być zsumowane bitowo (OR) we flags:

       AT_EMPTY_PATH (od Linuksa 2.6.39)
              Jeśli  oldpath jest pustym łańcuchem, tworzy dowiązanie do pliku, do którego odnosi
              się olddirfd (który mógł być pozyskany za pomocą znacznika O_PATH open(2)). W takim
              przypadku  olddirfd może odnosić się do dowolnego typu pliku, z wyjątkiem katalogu.
              Zwykle nie zadziała to, gdy licznik  dowiązań  wskazuje  zero  (pliki  utworzone  z
              O_TMPFILE   i   bez   O_EXCL   są   wyjątkiem).   Wywołujący  musi  mieć  przywilej
              CAP_DAC_READ_SEARCH (ang. capability), aby użyć tego znacznika. Niniejszy  znacznik
              jest typowo linuksowy; należy zdefiniować _GNU_SOURCE, aby pozyskać jego definicję.

       AT_SYMLINK_FOLLOW (od Linuksa 2.6.18)
              Domyślnie,  linkat(),  nie rozwija oldpath, jeśli jest ona dowiązaniem symbolicznym
              (jak link()). Można podać znacznik AT_SYMLINK_FOLLOW we flags, aby oldpath  została
              rozwiązana,  jeśli  jest  dowiązaniem  symbolicznym. Jeśli zamontowano procfs, może
              posłużyć to za alternatywę do AT_EMPTY_PATH, podobnie do:

                  linkat(AT_FDCWD, "/proc/self/fd/<fd>", newdirfd,
                         newname, AT_SYMLINK_FOLLOW);

       Przed Linuksem 2.6.18, argument flags nie był używany; wymagane było podanie jego wartości
       równej 0.

       Więcej informacji o potrzebie wprowadzenia linkat() 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

EACCES Odmówiono zapisu do katalogu zawierającego newpath lub brak uprawnienia
przeszukiwania dla jednego z katalogów w składowej ścieżek oldpath lub newpath
(zob. też path_resolution(7)).

EDQUOT Przydział bloków dyskowych użytkownika dotyczący systemu plików został wyczerpany.

EEXIST newpath już istnieje.

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

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

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

EMLINK Plik do którego odnosi się oldpath, osiągnął już maksymalną liczbę prowadzących do
niego dowiązań zwykłych. Przykładowo, w systemie plików ext4(5) bez cechy
dir_index, limit liczby dowiązań zwykłych wynosi 65 000; na btrfs(5) jest to 65 535
dowiązań.

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.

ENOMEM Brak pamięci jądra.

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

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

EPERM oldpath jest katalogiem.

EPERM System plików zawierający oldpath i newpath nie obsługuje tworzenia twardych
dowiązań.

EPERM (od Linuksa 3.6)
Wywołujący nie ma uprawnienia do utworzenia dowiązania zwykłego do tego pliku (zob.
opis /proc/sys/fs/protected_hardlinks w proc(5)).

EPERM oldpath została oznaczona jako tylko do odczytu (immutable) lub tylko do nadpisu
(append-only; zob ioctl_iflags(2)).

EROFS Plik leży na systemie plików tylko dla odczytu.

EXDEV oldpath i newpath nie są zamontowane w tym samym systemie plików (Linux dopuszcza
montowanie systemu plików w wielu punktach, ale link() nie działa poprzez różne
montowania, nawet gdy w obu miejscach zamontowano ten sam system plików).

Mogą wystąpić następujące dodatkowe błędy dla linkat():

EBADF oldpath (newpath) są względne, lecz olddirfd (newdirfd) nie wynosi ani AT_FDCWD,
ani nie jest prawidłowym deskryptorem pliku.

EINVAL We flags podano nieprawidłową wartość znacznika.

ENOENT We flags podano AT_EMPTY_PATH, lecz wywołujący nie posiada przywileju
CAP_DAC_READ_SEARCH (ang. capability).

ENOENT Próbowano utworzyć dowiązanie do pliku /proc/self/fd/NN, odnoszącego się do
deskryptora liku utworzonego za pomocą

open(path, O_TMPFILE | O_EXCL, mode);

Zobacz open(2).

ENOENT Próbowano utworzyć dowiązanie do pliku /proc/self/fd/NN, odnoszącego się do pliku,
który usunięto.

ENOENT oldpath jest ścieżką względną, a olddirfd odnosi się do usuniętego katalogu albo
newpath jest ścieżką względną, a newdirfd odnosi się do usuniętego katalogu.

ENOTDIR
oldpath jest względna, a olddirfd jest deskryptorem pliku odnoszącym się do pliku
innego niż katalog; lub analogicznie dla newpath i newdirfd

EPERM We flags podano AT_EMPTY_PATH, oldpath jest łańcuchem pustym, a olddirfd odnosi się
do katalogu.

WERSJE

       POSIX.1-2001 twierdzi, że link() powinien rozwiązywać oldpath, jeśli jest ona  dowiązaniem
       symbolicznym.  Jednak  od Linuksa 2.0, Linux tak nie czyni: jeśli oldpath jest dowiązaniem
       symbolicznym, to newpath jest tworzona jako dowiązanie zwykłe  (twarde)  do  samego  pliku
       dowiązania  symbolicznego  (tj.  newpath staje się dowiązaniem symbolicznym do tego samego
       pliku, do którego odnosi się oldpath). Niektóre inne implementacje zachowują się w ten sam
       sposób  co Linux. POSIX.1-2008 zmieniło specyfikację link(), czyniąc rozwiązywanie oldpath
       gdy jest to dowiązanie symboliczne, zależnym  od  implementacji.  Aby  uzyskać  precyzyjną
       kontrolę  nad traktowaniem dowiązań symbolicznych przy tworzeniu dowiązań zwykłych, należy
       korzystać z linkat().

   glibc
       W starszych jądrach, gdy niedostępne jest linkat() funkcja opakowująca z biblioteki  glibc
       z konieczności korzysta z link(), chyba że podano AT_SYMLINK_FOLLOW. Gdy oldpath i newpath
       są ścieżkami względnymi, glibc tworzy ścieżki w zależności  od  dowiązań  symbolicznych  w
       /proc/self/fd, które odnoszą się do argumentów olddirfd i newdirfd.

STANDARDY

       link() POSIX.1-2008.

HISTORIA

       link() SVr4, 4.3BSD, POSIX.1-2001 (lecz zob. WERSJE).

       linkat()
              POSIX.1-2008.  Linux 2.6.16, glibc 2.4.

UWAGI

       Dowiązania zwykłe (twarde), tworzone z pomocą link(), nie mogą wykraczać poza jeden system
       plików. W takich sytuacjach można użyć funkcji symlink(2).

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

       ln(1), open(2), rename(2), stat(2), symlink(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
       ⟨https://www.gnu.org/licenses/gpl-3.0.html⟩  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⟩.