From ab9260357ec40bdfb70b90f7c466bd705b39d5fc Mon Sep 17 00:00:00 2001
From: Michael Kerrisk <mtk.manpages@gmail.com>
Date: Thu, 10 Aug 2006 06:39:51 +0000
Subject: [PATCH] Document AT_SYMLINK_FOLLOW (new in 2.6.18).

---
 man2/linkat.2 | 27 +++++++++++++++------------
 1 file changed, 15 insertions(+), 12 deletions(-)

diff --git a/man2/linkat.2 b/man2/linkat.2
index da41a162d..5483dca9c 100644
--- a/man2/linkat.2
+++ b/man2/linkat.2
@@ -76,19 +76,22 @@ except that a relative pathname is interpreted relative
 to the directory referred to by the file descriptor
 .IR newdirfd .
 
-The
+By default,
+.BR linkat (2),
+does not dereference 
+.I oldpath
+if it is a symbolic link (like 
+.BR link (2)).
+Since Linux 2.6.18, the flag
+.B AT_SYMLINK_FOLLOW
+can be specified 
 .I flags
-argument is currently unused, and must be specified as 0.
-.\" Eventually there may be an AT_SYMLINK_FOLLOW flag to cause
-.\" symbolic links in oldpath to be followed (which is what
-.\" POSIX.1 requires of link(2)).
-.\" FIXME . check whether the AT_SYMLINK_FOLLOW flag eventually 
-.\" gets implemented
-.\" http://marc.theaimsgroup.com/?l=linux-kernel&m=115057175628627&w=2
-.\" List:       linux-kernel
-.\" Subject:    [PATCH] Implement AT_SYMLINK_FOLLOW flag for linkat
-.\" From:       Ulrich Drepper <drepper () redhat ! com>
-.\" Date:       2006-06-17 19:13:22
+to cause
+.I oldpath
+to be dereferenced if it is a symbolic link.
+Before kernel 2.6.18, the
+.I flags
+argument was unused, and had to be specified as 0.
 .SH "RETURN VALUE"
 On success,
 .BR linkat ()