nptl: Document the reason why __kind in pthread_mutex_t is part of the ABI

diff --git a/ChangeLog b/ChangeLog
index 1ac8d2c2dd0669b79a57fc12bb22c418991be346..49396f59e9af081ffbc7e1e33d80da1f0bdd26d6 100644 (file)
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,36 @@
+2016-11-07  Florian Weimer  <fweimer@redhat.com>
+
+       * sysdeps/aarch64/nptl/bits/pthreadtypes.h (struct __pthread_mutex_s):
+       Document ABI exposure of the __kind offset.
+       * sysdeps/arm/nptl/bits/pthreadtypes.h (struct __pthread_mutex_s):
+       Mention reason for the __kind offset exposure in the ABI.
+       * sysdeps/hppa/nptl/bits/pthreadtypes.h (struct __pthread_mutex_s):
+       Likewise.
+       * sysdeps/ia64/nptl/bits/pthreadtypes.h (struct __pthread_mutex_s):
+       Likewise.
+       * sysdeps/m68k/nptl/bits/pthreadtypes.h (struct __pthread_mutex_s):
+       Likewise.
+       * sysdeps/microblaze/nptl/bits/pthreadtypes.h
+       (struct __pthread_mutex_s): Likewise.
+       * sysdeps/mips/nptl/bits/pthreadtypes.h (struct __pthread_mutex_s):
+       Likewise.
+       * sysdeps/nios2/nptl/bits/pthreadtypes.h (struct __pthread_mutex_s):
+       Likewise.
+       * sysdeps/s390/nptl/bits/pthreadtypes.h (struct __pthread_mutex_s):
+       Likewise.
+       * sysdeps/sh/nptl/bits/pthreadtypes.h (struct __pthread_mutex_s):
+       Likewise.
+       * sysdeps/sparc/nptl/bits/pthreadtypes.h (struct __pthread_mutex_s):
+       Likewise.
+       * sysdeps/tile/nptl/bits/pthreadtypes.h (struct __pthread_mutex_s):
+       Likewise.
+       * sysdeps/unix/sysv/linux/alpha/bits/pthreadtypes.h
+       (struct __pthread_mutex_s): Likewise.
+       * sysdeps/unix/sysv/linux/powerpc/bits/pthreadtypes.h
+       (struct __pthread_mutex_s): Likewise.
+       * sysdeps/x86/bits/pthreadtypes.h (struct __pthread_mutex_s):
+       Likewise.
+
 2016-11-07  Steve Ellcey  <sellcey@caviumnetworks.com>
 
        * test-skeleton.c: Document do_test usage.

diff --git a/sysdeps/aarch64/nptl/bits/pthreadtypes.h b/sysdeps/aarch64/nptl/bits/pthreadtypes.h
index 13984a718dfb073421f0c6c69776875196e1e571..c376e64dd789cb2b6a0e304ac940070e8ae1001f 100644 (file)
--- a/sysdeps/aarch64/nptl/bits/pthreadtypes.h
+++ b/sysdeps/aarch64/nptl/bits/pthreadtypes.h
@@ -65,6 +65,8 @@ typedef union
     unsigned int __count;
     int __owner;
     unsigned int __nusers;
+    /* KIND must stay at this position in the structure to maintain
+       binary compatibility with static initializers.  */
     int __kind;
     int __spins;
     __pthread_list_t __list;

diff --git a/sysdeps/arm/nptl/bits/pthreadtypes.h b/sysdeps/arm/nptl/bits/pthreadtypes.h
index afb5392c8f6e9a95a33bb1319364b3e08a769622..645207bf41d406128aa38654376e4121dab2b03b 100644 (file)
--- a/sysdeps/arm/nptl/bits/pthreadtypes.h
+++ b/sysdeps/arm/nptl/bits/pthreadtypes.h
@@ -64,7 +64,7 @@ typedef union
     unsigned int __count;
     int __owner;
     /* KIND must stay at this position in the structure to maintain
-       binary compatibility.  */
+       binary compatibility with static initializers.  */
     int __kind;
     unsigned int __nusers;
     __extension__ union

diff --git a/sysdeps/hppa/nptl/bits/pthreadtypes.h b/sysdeps/hppa/nptl/bits/pthreadtypes.h
index 540802a70c1f23e90e76f659dbd6a80abcd09307..d0c1d584392a9b965d27343b891ac27bb87634ff 100644 (file)
--- a/sysdeps/hppa/nptl/bits/pthreadtypes.h
+++ b/sysdeps/hppa/nptl/bits/pthreadtypes.h
@@ -71,7 +71,7 @@ typedef union
     unsigned int __count;
     int __owner;
     /* KIND must stay at this position in the structure to maintain
-       binary compatibility.  */
+       binary compatibility with static initializers.  */
     int __kind;
     /* The old 4-word 16-byte aligned lock. This is initalized
        to all ones by the Linuxthreads PTHREAD_MUTEX_INITIALIZER.

diff --git a/sysdeps/ia64/nptl/bits/pthreadtypes.h b/sysdeps/ia64/nptl/bits/pthreadtypes.h
index f2e6dacf98987c29d56863df7b5e5d3375c91693..0e8388374fb776222003fa21662494c6d7c3833a 100644 (file)
--- a/sysdeps/ia64/nptl/bits/pthreadtypes.h
+++ b/sysdeps/ia64/nptl/bits/pthreadtypes.h
@@ -64,7 +64,7 @@ typedef union
     int __owner;
     unsigned int __nusers;
     /* KIND must stay at this position in the structure to maintain
-       binary compatibility.  */
+       binary compatibility with static initializers.  */
     int __kind;
     int __spins;
     __pthread_list_t __list;

diff --git a/sysdeps/m68k/nptl/bits/pthreadtypes.h b/sysdeps/m68k/nptl/bits/pthreadtypes.h
index d8faa7a000b0a0b230a9da0e43b464b5398b13db..d195492f3500fa796577ace098b1e726ea800f6d 100644 (file)
--- a/sysdeps/m68k/nptl/bits/pthreadtypes.h
+++ b/sysdeps/m68k/nptl/bits/pthreadtypes.h
@@ -64,7 +64,7 @@ typedef union
     unsigned int __count;
     int __owner;
     /* KIND must stay at this position in the structure to maintain
-       binary compatibility.  */
+       binary compatibility with static initializers.  */
     int __kind;
     unsigned int __nusers;
     __extension__ union

diff --git a/sysdeps/microblaze/nptl/bits/pthreadtypes.h b/sysdeps/microblaze/nptl/bits/pthreadtypes.h
index 9e9e307cf9853ae165d345d5e447ef54079953a5..2a1ca0a191b664ad68386b4913bf54678d12bd3a 100644 (file)
--- a/sysdeps/microblaze/nptl/bits/pthreadtypes.h
+++ b/sysdeps/microblaze/nptl/bits/pthreadtypes.h
@@ -63,7 +63,7 @@ typedef union
     unsigned int __count;
     int __owner;
     /* KIND must stay at this position in the structure to maintain
-       binary compatibility.  */
+       binary compatibility with static initializers.  */
     int __kind;
     unsigned int __nusers;
     __extension__ union

diff --git a/sysdeps/mips/nptl/bits/pthreadtypes.h b/sysdeps/mips/nptl/bits/pthreadtypes.h
index 68ed94b145fa438c857adaf496fc6df5769ac5b7..c7533a8e3262528c468cccde74f7ea2cd98e4030 100644 (file)
--- a/sysdeps/mips/nptl/bits/pthreadtypes.h
+++ b/sysdeps/mips/nptl/bits/pthreadtypes.h
@@ -87,7 +87,7 @@ typedef union
     unsigned int __nusers;
 #endif
     /* KIND must stay at this position in the structure to maintain
-       binary compatibility.  */
+       binary compatibility with static initializers.  */
     int __kind;
 #if _MIPS_SIM == _ABI64
     int __spins;

diff --git a/sysdeps/nios2/nptl/bits/pthreadtypes.h b/sysdeps/nios2/nptl/bits/pthreadtypes.h
index 76076d009a7ab6db0f20d417fc8dd3d35428f6db..ee8b7ba762bf3af9923497e93e54521a8a985045 100644 (file)
--- a/sysdeps/nios2/nptl/bits/pthreadtypes.h
+++ b/sysdeps/nios2/nptl/bits/pthreadtypes.h
@@ -64,7 +64,7 @@ typedef union
     unsigned int __count;
     int __owner;
     /* KIND must stay at this position in the structure to maintain
-       binary compatibility.  */
+       binary compatibility with static initializers.  */
     int __kind;
     unsigned int __nusers;
     __extension__ union

diff --git a/sysdeps/s390/nptl/bits/pthreadtypes.h b/sysdeps/s390/nptl/bits/pthreadtypes.h
index 40d10fea590c217e06baffed41aed4a887b40e7d..21d13bd7e70f67c05705fc3b478bc9db93eeaa91 100644 (file)
--- a/sysdeps/s390/nptl/bits/pthreadtypes.h
+++ b/sysdeps/s390/nptl/bits/pthreadtypes.h
@@ -86,7 +86,7 @@ typedef union
     unsigned int __nusers;
 #endif
     /* KIND must stay at this position in the structure to maintain
-       binary compatibility.  */
+       binary compatibility with static initializers.  */
     int __kind;
 #if __WORDSIZE == 64
 # ifdef ENABLE_LOCK_ELISION

diff --git a/sysdeps/sh/nptl/bits/pthreadtypes.h b/sysdeps/sh/nptl/bits/pthreadtypes.h
index 13fbd7379a0f34d18bae19075b267367e0cc643b..5354f78676ab83b1e81e94eff110c3dd9867b676 100644 (file)
--- a/sysdeps/sh/nptl/bits/pthreadtypes.h
+++ b/sysdeps/sh/nptl/bits/pthreadtypes.h
@@ -64,7 +64,7 @@ typedef union
     unsigned int __count;
     int __owner;
     /* KIND must stay at this position in the structure to maintain
-       binary compatibility.  */
+       binary compatibility with static initializers.  */
     int __kind;
     unsigned int __nusers;
     __extension__ union

diff --git a/sysdeps/sparc/nptl/bits/pthreadtypes.h b/sysdeps/sparc/nptl/bits/pthreadtypes.h
index d45cb61277e3f9f059b8b7bebefaafd7265735cb..e781a258aa0cb7f106f7d97ae8d24d1cf940a265 100644 (file)
--- a/sysdeps/sparc/nptl/bits/pthreadtypes.h
+++ b/sysdeps/sparc/nptl/bits/pthreadtypes.h
@@ -87,7 +87,7 @@ typedef union
     unsigned int __nusers;
 #endif
     /* KIND must stay at this position in the structure to maintain
-       binary compatibility.  */
+       binary compatibility with static initializers.  */
     int __kind;
 #if __WORDSIZE == 64
     int __spins;

diff --git a/sysdeps/tile/nptl/bits/pthreadtypes.h b/sysdeps/tile/nptl/bits/pthreadtypes.h
index 7d6865066a078261ef35e72438e0d6450554792d..b14b1c6f5e9ebe2c9615e02e03d6c6f6d5d0a32b 100644 (file)
--- a/sysdeps/tile/nptl/bits/pthreadtypes.h
+++ b/sysdeps/tile/nptl/bits/pthreadtypes.h
@@ -87,7 +87,7 @@ typedef union
     unsigned int __nusers;
 #endif
     /* KIND must stay at this position in the structure to maintain
-       binary compatibility.  */
+       binary compatibility with static initializers.  */
     int __kind;
 #if __WORDSIZE == 64
     int __spins;

diff --git a/sysdeps/unix/sysv/linux/alpha/bits/pthreadtypes.h b/sysdeps/unix/sysv/linux/alpha/bits/pthreadtypes.h
index 1a1779b5d41ad33417808c120a7dc37479bcfeef..b7af0380e975cd3e4dbed42bf087050df9682af8 100644 (file)
--- a/sysdeps/unix/sysv/linux/alpha/bits/pthreadtypes.h
+++ b/sysdeps/unix/sysv/linux/alpha/bits/pthreadtypes.h
@@ -63,7 +63,7 @@ typedef union
     int __owner;
     unsigned int __nusers;
     /* KIND must stay at this position in the structure to maintain
-       binary compatibility.  */
+       binary compatibility with static initializers.  */
     int __kind;
     int __spins;
     __pthread_list_t __list;

diff --git a/sysdeps/unix/sysv/linux/powerpc/bits/pthreadtypes.h b/sysdeps/unix/sysv/linux/powerpc/bits/pthreadtypes.h
index 345e79ae727bbb2b2a595d67e692cf049d1e3f87..d230ac9678617be2a30f00c61fe1a96f6eae80b7 100644 (file)
--- a/sysdeps/unix/sysv/linux/powerpc/bits/pthreadtypes.h
+++ b/sysdeps/unix/sysv/linux/powerpc/bits/pthreadtypes.h
@@ -87,7 +87,7 @@ typedef union
     unsigned int __nusers;
 #endif
     /* KIND must stay at this position in the structure to maintain
-       binary compatibility.  */
+       binary compatibility with static initializers.  */
     int __kind;
 #if __WORDSIZE == 64
     short __spins;

diff --git a/sysdeps/x86/bits/pthreadtypes.h b/sysdeps/x86/bits/pthreadtypes.h
index 16b8f4fbb1c700f0ce4439bd15311cf61909e58b..c641a405e38f2b867c4dcbd72a1ba6e311c3ba9e 100644 (file)
--- a/sysdeps/x86/bits/pthreadtypes.h
+++ b/sysdeps/x86/bits/pthreadtypes.h
@@ -98,7 +98,7 @@ typedef union
     unsigned int __nusers;
 #endif
     /* KIND must stay at this position in the structure to maintain
-       binary compatibility.  */
+       binary compatibility with static initializers.  */
     int __kind;
 #ifdef __x86_64__
     short __spins;