520cc8
commit df648905e7d8340bb3e78813fd25e2077b9685d9
520cc8
Author: Joseph Myers <joseph@codesourcery.com>
520cc8
Date:   Mon Dec 17 18:29:36 2018 +0000
520cc8
520cc8
    Add test that MAP_* constants agree with kernel.
520cc8
    
520cc8
    Continuing the process of building up and using Python infrastructure
520cc8
    for extracting and using values in headers, this patch adds a test
520cc8
    that MAP_* constants from sys/mman.h agree with those in the Linux
520cc8
    kernel headers.  (Other sys/mman.h constants could be added to the
520cc8
    test separately.)
520cc8
    
520cc8
    This set of constants has grown over time, so the generic code is
520cc8
    enhanced to allow saying extra constants are OK on either side of the
520cc8
    comparison (where the caller sets those parameters based on the Linux
520cc8
    kernel headers version, compared with the version the headers were
520cc8
    last updated from).  Although the test is a custom Python file, my
520cc8
    intention is to move in future to a single Python script for such
520cc8
    tests and text files it takes as inputs, once there are enough
520cc8
    examples to provide a guide to the common cases in such tests (I'd
520cc8
    like to end up with most or all such sets of constants copied from
520cc8
    kernel headers having such tests, and likewise for structure layouts
520cc8
    from the kernel).
520cc8
    
520cc8
    The Makefile code is essentially the same as for tst-signal-numbers,
520cc8
    but I didn't try to find an object file to depend on to represent the
520cc8
    dependency on the headers used by the test (the conform/ tests don't
520cc8
    try to represent such header dependencies at all, for example).
520cc8
    
520cc8
    Tested with build-many-glibcs.py, and also for x86_64 with older
520cc8
    kernel headers.
520cc8
    
520cc8
            * scripts/glibcextract.py (compare_macro_consts): Take parameters
520cc8
            to allow extra macros from first or second sources.
520cc8
            * sysdeps/unix/sysv/linux/tst-mman-consts.py: New file.
520cc8
            * sysdeps/unix/sysv/linux/Makefile [$(subdir) = misc]
520cc8
            (tests-special): Add $(objpfx)tst-mman-consts.out.
520cc8
            ($(objpfx)tst-mman-consts.out): New makefile target.
520cc8
520cc8
diff --git a/scripts/glibcextract.py b/scripts/glibcextract.py
520cc8
index ecc4d5b6cc387c7d..06f712ad115e0f9e 100644
520cc8
--- a/scripts/glibcextract.py
520cc8
+++ b/scripts/glibcextract.py
520cc8
@@ -136,12 +136,19 @@ def compute_macro_consts(source_text, cc, macro_re, exclude_re=None):
520cc8
     return compute_c_consts(sym_data, cc)
520cc8
 
520cc8
 
520cc8
-def compare_macro_consts(source_1, source_2, cc, macro_re, exclude_re=None):
520cc8
+def compare_macro_consts(source_1, source_2, cc, macro_re, exclude_re=None,
520cc8
+                         allow_extra_1=False, allow_extra_2=False):
520cc8
     """Compare the values of macros defined by two different sources.
520cc8
 
520cc8
     The sources would typically be includes of a glibc header and a
520cc8
-    kernel header.  Return 1 if there were any differences, 0 if the
520cc8
-    macro values were the same.
520cc8
+    kernel header.  If allow_extra_1, the first source may define
520cc8
+    extra macros (typically if the kernel headers are older than the
520cc8
+    version glibc has taken definitions from); if allow_extra_2, the
520cc8
+    second source may define extra macros (typically if the kernel
520cc8
+    headers are newer than the version glibc has taken definitions
520cc8
+    from).  Return 1 if there were any differences other than those
520cc8
+    allowed, 0 if the macro values were the same apart from any
520cc8
+    allowed differences.
520cc8
 
520cc8
     """
520cc8
     macros_1 = compute_macro_consts(source_1, cc, macro_re, exclude_re)
520cc8
@@ -150,13 +157,19 @@ def compare_macro_consts(source_1, source_2, cc, macro_re, exclude_re=None):
520cc8
         return 0
520cc8
     print('First source:\n%s\n' % source_1)
520cc8
     print('Second source:\n%s\n' % source_2)
520cc8
+    ret = 0
520cc8
     for name, value in sorted(macros_1.items()):
520cc8
         if name not in macros_2:
520cc8
             print('Only in first source: %s' % name)
520cc8
+            if not allow_extra_1:
520cc8
+                ret = 1
520cc8
         elif macros_1[name] != macros_2[name]:
520cc8
             print('Different values for %s: %s != %s'
520cc8
                   % (name, macros_1[name], macros_2[name]))
520cc8
+            ret = 1
520cc8
     for name in sorted(macros_2.keys()):
520cc8
         if name not in macros_1:
520cc8
             print('Only in second source: %s' % name)
520cc8
-    return 1
520cc8
+            if not allow_extra_2:
520cc8
+                ret = 1
520cc8
+    return ret
520cc8
diff --git a/sysdeps/unix/sysv/linux/Makefile b/sysdeps/unix/sysv/linux/Makefile
520cc8
index 9c10ee53b26e1b1b..863ed80c2a2713d3 100644
520cc8
--- a/sysdeps/unix/sysv/linux/Makefile
520cc8
+++ b/sysdeps/unix/sysv/linux/Makefile
520cc8
@@ -98,6 +98,15 @@ $(objpfx)tst-sysconf-iov_max: $(objpfx)tst-sysconf-iov_max-uapi.o
520cc8
 
520cc8
 $(objpfx)tst-pkey: $(shared-thread-library)
520cc8
 
520cc8
+tests-special += $(objpfx)tst-mman-consts.out
520cc8
+$(objpfx)tst-mman-consts.out: ../sysdeps/unix/sysv/linux/tst-mman-consts.py
520cc8
+	PYTHONPATH=../scripts \
520cc8
+	$(PYTHON) ../sysdeps/unix/sysv/linux/tst-mman-consts.py \
520cc8
+		   --cc="$(CC) $(patsubst -DMODULE_NAME=%, \
520cc8
+					  -DMODULE_NAME=testsuite, \
520cc8
+					  $(CPPFLAGS))" \
520cc8
+	< /dev/null > $@ 2>&1; $(evaluate-test)
520cc8
+
520cc8
 endif # $(subdir) == misc
520cc8
 
520cc8
 ifeq ($(subdir),time)
520cc8
diff --git a/sysdeps/unix/sysv/linux/tst-mman-consts.py b/sysdeps/unix/sysv/linux/tst-mman-consts.py
520cc8
new file mode 100644
520cc8
index 0000000000000000..1a613beec0da16fb
520cc8
--- /dev/null
520cc8
+++ b/sysdeps/unix/sysv/linux/tst-mman-consts.py
520cc8
@@ -0,0 +1,65 @@
520cc8
+#!/usr/bin/python3
520cc8
+# Test that glibc's sys/mman.h constants match the kernel's.
520cc8
+# Copyright (C) 2018 Free Software Foundation, Inc.
520cc8
+# This file is part of the GNU C Library.
520cc8
+#
520cc8
+# The GNU C Library is free software; you can redistribute it and/or
520cc8
+# modify it under the terms of the GNU Lesser General Public
520cc8
+# License as published by the Free Software Foundation; either
520cc8
+# version 2.1 of the License, or (at your option) any later version.
520cc8
+#
520cc8
+# The GNU C Library is distributed in the hope that it will be useful,
520cc8
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
520cc8
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
520cc8
+# Lesser General Public License for more details.
520cc8
+#
520cc8
+# You should have received a copy of the GNU Lesser General Public
520cc8
+# License along with the GNU C Library; if not, see
520cc8
+# <http://www.gnu.org/licenses/>.
520cc8
+
520cc8
+import argparse
520cc8
+import sys
520cc8
+
520cc8
+import glibcextract
520cc8
+
520cc8
+
520cc8
+def linux_kernel_version(cc):
520cc8
+    """Return the (major, minor) version of the Linux kernel headers."""
520cc8
+    sym_data = ['#include <linux/version.h>', 'START',
520cc8
+                ('LINUX_VERSION_CODE', 'LINUX_VERSION_CODE')]
520cc8
+    val = glibcextract.compute_c_consts(sym_data, cc)['LINUX_VERSION_CODE']
520cc8
+    val = int(val)
520cc8
+    return ((val & 0xff0000) >> 16, (val & 0xff00) >> 8)
520cc8
+
520cc8
+
520cc8
+def main():
520cc8
+    """The main entry point."""
520cc8
+    parser = argparse.ArgumentParser(
520cc8
+        description="Test that glibc's sys/mman.h constants "
520cc8
+        "match the kernel's.")
520cc8
+    parser.add_argument('--cc', metavar='CC',
520cc8
+                        help='C compiler (including options) to use')
520cc8
+    args = parser.parse_args()
520cc8
+    linux_version_headers = linux_kernel_version(args.cc)
520cc8
+    linux_version_glibc = (4, 19)
520cc8
+    sys.exit(glibcextract.compare_macro_consts(
520cc8
+        '#define _GNU_SOURCE 1\n'
520cc8
+        '#include <sys/mman.h>\n',
520cc8
+        '#define _GNU_SOURCE 1\n'
520cc8
+        '#include <linux/mman.h>\n',
520cc8
+        args.cc,
520cc8
+        'MAP_.*',
520cc8
+        # A series of MAP_HUGE_<size> macros are defined by the kernel
520cc8
+        # but not by glibc.  MAP_UNINITIALIZED is kernel-only.
520cc8
+        # MAP_FAILED is not a MAP_* flag and is glibc-only, as is the
520cc8
+        # MAP_ANON alias for MAP_ANONYMOUS.  MAP_RENAME, MAP_AUTOGROW,
520cc8
+        # MAP_LOCAL and MAP_AUTORSRV are in the kernel header for
520cc8
+        # MIPS, marked as "not used by linux"; SPARC has MAP_INHERIT
520cc8
+        # in the kernel header, but does not use it.
520cc8
+        'MAP_HUGE_[0-9].*|MAP_UNINITIALIZED|MAP_FAILED|MAP_ANON'
520cc8
+        '|MAP_RENAME|MAP_AUTOGROW|MAP_LOCAL|MAP_AUTORSRV|MAP_INHERIT',
520cc8
+        linux_version_glibc > linux_version_headers,
520cc8
+        linux_version_headers > linux_version_glibc))
520cc8
+
520cc8
+if __name__ == '__main__':
520cc8
+    main()