.\" -*- coding: UTF-8 -*- .\" This manpage is Copyright (C) 1992 Drew Eckhardt; .\" and Copyright (C) 1993 Michael Haardt, Ian Jackson. .\" and Copyright (C) 2006, 2014 Michael Kerrisk .\" .\" %%%LICENSE_START(VERBATIM) .\" Permission is granted to make and distribute verbatim copies of this .\" manual provided the copyright notice and this permission notice are .\" preserved on all copies. .\" .\" Permission is granted to copy and distribute modified versions of this .\" manual under the conditions for verbatim copying, provided that the .\" entire resulting derived work is distributed under the terms of a .\" permission notice identical to this one. .\" .\" Since the Linux kernel and libraries are constantly changing, this .\" manual page may be incorrect or out-of-date. The author(s) assume no .\" responsibility for errors or omissions, or for damages resulting from .\" the use of the information contained herein. The author(s) may not .\" have taken the same level of care in the production of this manual, .\" which is licensed free of charge, as they might when working .\" professionally. .\" .\" Formatted or processed versions of this manual, if unaccompanied by .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" .\" Modified 1993-07-24 by Rik Faith .\" Modified 1996-04-26 by Nick Duffek .\" Modified 1996-11-06 by Eric S. Raymond .\" Modified 1997-01-31 by Eric S. Raymond .\" Modified 2004-06-23 by Michael Kerrisk .\" .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH SYMLINK 2 "15 września 2017 r." Linux "Podręcznik programisty Linuksa" .SH NAZWA symlink, symlinkat \- tworzenie nowej nazwy dla pliku .SH SKŁADNIA .nf \fB#include \fP .PP \fBint symlink(const char *\fP\fItarget\fP\fB, const char *\fP\fIlinkpath\fP\fB);\fP \fB#include \fP/* Definicja stałych AT_* */ \fB#include \fP .PP \fBint symlinkat(const char *\fP\fItarget\fP\fB, int \fP\fInewdirfd\fP\fB, const char *\fP\fIlinkpath\fP\fB);\fP .PP .fi .RS -4 Wymagane ustawienia makr biblioteki glibc (patrz \fBfeature_test_macros\fP(7)): .RE .PP .ad l \fBsymlink\fP(): .RS 4 .\" || _XOPEN_SOURCE\ &&\ _XOPEN_SOURCE_EXTENDED _XOPEN_SOURCE\ >=\ 500 || _POSIX_C_SOURCE\ >=\ 200112L || /* Wersje glibc <= 2.19: */ _BSD_SOURCE .RE .PP \fBsymlinkat\fP(): .PD 0 .ad l .RS 4 .TP 4 Od glibc 2.10: _POSIX_C_SOURCE\ >=\ 200809L .TP Przed glibc 2.10: _ATFILE_SOURCE .RE .ad b .PD .SH OPIS \fBsymlink\fP() tworzy dowiązanie symboliczne o nazwie \fIlinkpath\fP które zawiera łańcuch znakowy \fItarget\fP. .PP 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. .PP Dowiązania symboliczne mogą zawierać składniki \fI..\fP, 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. .PP 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. .PP 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' (\fBS_ISVTX\fP). .PP Jeśli ścieżka \fIlinkpath\fP istnieje to \fInie\fP będzie nadpisana. .SS symlinkat() The \fBsymlinkat\fP() system call operates in exactly the same way as \fBsymlink\fP(), except for the differences described here. .PP If the pathname given in \fIlinkpath\fP is relative, then it is interpreted relative to the directory referred to by the file descriptor \fInewdirfd\fP (rather than relative to the current working directory of the calling process, as is done by \fBsymlink\fP() for a relative pathname). .PP If \fIlinkpath\fP is relative and \fInewdirfd\fP is the special value \fBAT_FDCWD\fP, then \fIlinkpath\fP is interpreted relative to the current working directory of the calling process (like \fBsymlink\fP()). .PP If \fIlinkpath\fP is absolute, then \fInewdirfd\fP is ignored. .SH "WARTOŚĆ ZWRACANA" Po pomyślnym zakończeniu zwracane jest zero. Po błędzie zwracane jest \-1 i odpowiednio ustawiane jest \fIerrno\fP. .SH BŁĘDY .TP \fBEACCES\fP Write access to the directory containing \fIlinkpath\fP is denied, or one of the directories in the path prefix of \fIlinkpath\fP did not allow search permission. (See also \fBpath_resolution\fP(7).) .TP \fBEDQUOT\fP The user's quota of resources on the filesystem has been exhausted. The resources could be inodes or disk blocks, depending on the filesystem implementation. .TP \fBEEXIST\fP \fIlinkpath\fP już istnieje. .TP \fBEFAULT\fP \fItarget\fP lub \fIlinkpath\fP wskazuje poza dostępną dla użytkownika przestrzeń adresową. .TP \fBEIO\fP Wystąpił błąd wejścia/wyjścia. .TP \fBELOOP\fP Podczas rozwiązywania \fIlinkpath\fP napotkano zbyt wiele dowiązań symbolicznych. .TP \fBENAMETOOLONG\fP \fItarget\fP lub \fIlinkpath\fP było zbyt długie. .TP \fBENOENT\fP A directory component in \fIlinkpath\fP does not exist or is a dangling symbolic link, or \fItarget\fP or \fIlinkpath\fP is an empty string. .TP \fBENOMEM\fP Brak pamięci jądra. .TP \fBENOSPC\fP Na urządzeniu, zawierającym plik nie ma miejsca na kolejny wpis w katalogu. .TP \fBENOTDIR\fP Składnik użyty jako katalog w \fIlinkpath\fP w rzeczywistości nie jest katalogiem. .TP \fBEPERM\fP System plików zawierający \fIlinkpath\fP nie zezwala na tworzenie dowiązań symbolicznych. .TP \fBEROFS\fP Plik \fIlinkpath\fP znajduje się na systemie plików tylko dla odczytu. .PP The following additional errors can occur for \fBsymlinkat\fP(): .TP \fBEBADF\fP \fInewdirfd\fP is not a valid file descriptor. .TP \fBENOENT\fP \fIlinkpath\fP is a relative pathname and \fInewdirfd\fP refers to a directory that has been deleted. .TP \fBENOTDIR\fP \fIlinkpath\fP is relative and \fInewdirfd\fP is a file descriptor referring to a file other than a directory. .SH WERSJE \fBsymlinkat\fP() was added to Linux in kernel 2.6.16; library support was added to glibc in version 2.4. .SH "ZGODNE Z" .\" SVr4 documents additional error codes EDQUOT and ENOSYS. .\" See .\" .BR open (2) .\" re multiple files with the same name, and NFS. \fBsymlink\fP(): SVr4, 4.3BSD, POSIX.1\-2001, POSIX.1\-2008. .PP \fBsymlinkat\fP(): POSIX.1\-2008. .SH UWAGI Nie jest dokonywane sprawdzenie \fItarget\fP. .PP 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ć \fBlink\fP(2). .SS "Uwagi dla glibc" On older kernels where \fBsymlinkat\fP() is unavailable, the glibc wrapper function falls back to the use of \fBsymlink\fP(). When \fIlinkpath\fP is a relative pathname, glibc constructs a pathname based on the symbolic link in \fI/proc/self/fd\fP that corresponds to the \fInewdirfd\fP argument. .SH "ZOBACZ TAKŻE" \fBln\fP(1), \fBnamei\fP(1), \fBlchown\fP(2), \fBlink\fP(2), \fBlstat\fP(2), \fBopen\fP(2), \fBreadlink\fP(2), \fBrename\fP(2), \fBunlink\fP(2), \fBpath_resolution\fP(7), \fBsymlink\fP(7) .SH "O STRONIE" Angielska wersja tej strony pochodzi z wydania 5.10 projektu Linux \fIman\-pages\fP. Opis projektu, informacje dotyczące zgłaszania błędów oraz najnowszą wersję oryginału można znaleźć pod adresem \%https://www.kernel.org/doc/man\-pages/. .PP .SH TŁUMACZENIE Autorami polskiego tłumaczenia niniejszej strony podręcznika są: Przemek Borys i Andrzej Krzysztofowicz . .PP Niniejsze tłumaczenie jest wolną dokumentacją. Bliższe informacje o warunkach licencji można uzyskać zapoznając się z .UR https://www.gnu.org/licenses/gpl-3.0.html GNU General Public License w wersji 3 .UE lub nowszej. Nie przyjmuje się ŻADNEJ ODPOWIEDZIALNOŚCI. .PP Błędy w tłumaczeniu strony podręcznika prosimy zgłaszać na adres listy dyskusyjnej .MT manpages-pl-list@lists.sourceforge.net .ME .