aboutsummaryrefslogtreecommitdiffstats
path: root/man2/link.2
diff options
context:
space:
mode:
Diffstat (limited to 'man2/link.2')
-rw-r--r--man2/link.220
1 files changed, 20 insertions, 0 deletions
diff --git a/man2/link.2 b/man2/link.2
index 0725cd2b85..492a71aa42 100644
--- a/man2/link.2
+++ b/man2/link.2
@@ -382,6 +382,26 @@ is dereferenced if it is a symbolic link.
For precise control over the treatment of symbolic links when
creating a link, use
.BR linkat (2).
+.SS Glibc notes
+On older kernels where
+.BR linkat ()
+is unavailable, the glibc wrapper function falls back to the use of
+.BR link (),
+unless the
+.B AT_SYMLINK_FOLLOW
+is specified.
+When
+.I oldpath
+and
+.I newpath
+are relative pathnames,
+glibc constructs pathnames based on the symbolic links in
+.IR /proc/self/fd
+that correspond to the
+.I olddirfd
+and
+.IR newdirfd
+arguments.
.SH BUGS
On NFS filesystems, the return code may be wrong in case the NFS server
performs the link creation and dies before it can say so.