.\" -*- 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 <nsd@bbc.com>
.\" Modified 1996-11-06 by Eric S. Raymond <esr@thyrsus.com>
.\" Modified 1997-01-31 by Eric S. Raymond <esr@thyrsus.com>
.\" Modified 2004-06-23 by Michael Kerrisk <mtk.manpages@gmail.com>
.\"
.\"*******************************************************************
.\"
.\" 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 <unistd.h>\fP
.PP
\fBint symlink(const char *\fP\fItarget\fP\fB, const char *\fP\fIlinkpath\fP\fB);\fP

\fB#include <fcntl.h>           \fP/* Definicja stałych AT_* */
\fB#include <unistd.h>\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
    || /* Glibc versions <= 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/.

.SH TŁUMACZENIE
Autorami polskiego tłumaczenia niniejszej strony podręcznika są:
Przemek Borys <pborys@dione.ids.pl>
i
Andrzej Krzysztofowicz <ankry@green.mf.pg.gda.pl>
.

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.

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