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