fstatat.2: Document AT_NO_AUTOMOUNT

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

diff --git a/man2/fstatat.2 b/man2/fstatat.2
index 2868bfbce760c28f298afbc01b6069c28a418075..c0d97ddbdbcce108e78053a54580926c2dc29201 100644 (file)
--- a/man2/fstatat.2
+++ b/man2/fstatat.2
@@ -22,9 +22,7 @@
 .\" Formatted or processed versions of this manual, if unaccompanied by
 .\" the source, must acknowledge the copyright and authors of this work.
 .\"
-.\" FIXME: Linux 2.6.38 added AT_NO_AUTOMOUNT
-.\"
-.TH FSTATAT 2 2010-11-21 "Linux" "Linux Programmer's Manual"
+.TH FSTATAT 2 2011-09-19 "Linux" "Linux Programmer's Manual"
 .SH NAME
 fstatat \- get file status relative to a directory file descriptor
 .SH SYNOPSIS
@@ -91,7 +89,16 @@ is absolute, then
 is ignored.
 
 .I flags
-can either be 0, or include the following flag:
+can either be 0, or include one or more of the following flags ORed:
+.TP
+.BR AT_NO_AUTOMOUNT " (since Linux 2.6.38)"
+Don't automount the terminal ("basename") component of
+.I pathname
+if it is a directory that is an automount point.
+This allows the caller to gather attributes of an automount point
+(rather than the location it would mount).
+This flag can be used in tools that scan directories
+to prevent mass-automounting of a directory of automount points.
 .TP
 .B AT_SYMLINK_NOFOLLOW
 If