From 496bdb56427479f7852f434e71d6104a13613a13 Mon Sep 17 00:00:00 2001
From: Michael Kerrisk <mtk.manpages@gmail.com>
Date: Mon, 10 Mar 2014 12:01:39 +0100
Subject: [PATCH] stat.2: Warn the reader that the 'stat' structure definition
 is not precise

Padding fields aren't shown, and the order of fields varies
somewhat across architectures.

Reported-by: Marius Gaubas <marius@livejournalinc.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
---
 man2/stat.2 | 13 ++++++++++++-
 1 file changed, 12 insertions(+), 1 deletion(-)

diff --git a/man2/stat.2 b/man2/stat.2
index 13e1482a5..27ccfd428 100644
--- a/man2/stat.2
+++ b/man2/stat.2
@@ -159,7 +159,18 @@ struct stat {
 };
 .fi
 .in
-.PP
+
+.I Note:
+the order of fields in the
+.I stat
+structure varies somewhat
+across architectures.
+In addition,
+the definition above does not show the padding bytes
+that may be present between some fields on various architectures.
+Consult the the glibc and kernel source code
+if you need to know the details.
+
 The
 .I st_dev
 field describes the device on which this file resides.