From: Chris Metcalf <cmetcalf@ezchip.com>
Date: Thu, 19 Mar 2015 17:33:01 +0000 (-0400)
Subject: linux-generic: add a README
X-Git-Tag: upstream/2.30~6210
X-Git-Url: http://review.tizen.org/git/?a=commitdiff_plain;h=becb26b84bfe4d3273c4e2d4e7684dfbbf7c6bcd;p=external%2Fglibc.git

linux-generic: add a README
---

diff --git a/ChangeLog b/ChangeLog
index d449323..b9b3c2c 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,7 @@
+2015-03-19  Chris Metcalf  <cmetcalf@ezchip.com>
+
+	* sysdeps/unix/sysv/linux/generic/README: New file.
+
 2015-03-18  Joseph Myers  <joseph@codesourcery.com>
 
 	[BZ #18138]
diff --git a/sysdeps/unix/sysv/linux/generic/README b/sysdeps/unix/sysv/linux/generic/README
new file mode 100644
index 0000000..301a610
--- /dev/null
+++ b/sysdeps/unix/sysv/linux/generic/README
@@ -0,0 +1,11 @@
+This hierarchy supports Linux systems using the new
+asm-generic/unistd.h, which removes many familiar old syscalls.  For
+example, to implement open(), newer Linux architectures require glibc
+to invoke the __NR_openat syscall with AT_FDCWD.  This hierarchy
+provides all those implementations.
+
+It also provides support for 32-bit platforms using the 64-bit kernel
+syscall APIs, as the 32-bit ones are no longer provided.  Note that
+newer ILP32 environments (x32 or AArch64:ILP32, for example) are
+converting to use more 64-bit types in kernel syscalls, so that aspect
+of this support is in more flux as of this writing.