scripts/headers_install.sh

   1 #!/bin/sh
   2 # SPDX-License-Identifier: GPL-2.0
   3
   4 if [ $# -ne 2 ]
   5 then
   6         echo "Usage: headers_install.sh INFILE OUTFILE"
   7         echo
   8         echo "Prepares kernel header files for use by user space, by removing"
   9         echo "all compiler.h definitions and #includes, removing any"
  10         echo "#ifdef __KERNEL__ sections, and putting __underscores__ around"
  11         echo "asm/inline/volatile keywords."
  12         echo
  13         echo "INFILE: header file to operate on"
  14         echo "OUTFILE: output file which the processed header is written to"
  15
  16         exit 1
  17 fi
  18
  19 # Grab arguments
  20 INFILE=$1
  21 OUTFILE=$2
  22 TMPFILE=$OUTFILE.tmp
  23
  24 trap 'rm -f $OUTFILE $TMPFILE' EXIT
  25
  26 # SPDX-License-Identifier with GPL variants must have "WITH Linux-syscall-note"
  27 if [ -n "$(sed -n -e "/SPDX-License-Identifier:.*GPL-/{/WITH Linux-syscall-note/!p}" $INFILE)" ]; then
  28         echo "error: $INFILE: missing \"WITH Linux-syscall-note\" for SPDX-License-Identifier" >&2
  29         exit 1
  30 fi
  31
  32 sed -E -e '
  33         s/([[:space:](])(__user|__force|__iomem)[[:space:]]/\1/g
  34         s/__attribute_const__([[:space:]]|$)/\1/g
  35         s@^#include <linux/compiler(|_types).h>@@
  36         s/(^|[^a-zA-Z0-9])__packed([^a-zA-Z0-9_]|$)/\1__attribute__((packed))\2/g
  37         s/(^|[[:space:](])(inline|asm|volatile)([[:space:](]|$)/\1__\2__\3/g
  38         s@#(ifndef|define|endif[[:space:]]*/[*])[[:space:]]*_UAPI@#\1 @
  39 ' $INFILE > $TMPFILE || exit 1
  40
  41 scripts/unifdef -U__KERNEL__ -D__EXPORTED_HEADERS__ $TMPFILE > $OUTFILE
  42 [ $? -gt 1 ] && exit 1
  43
  44 # Remove /* ... */ style comments, and find CONFIG_ references in code
  45 configs=$(sed -e '
  46 :comment
  47         s:/\*[^*][^*]*:/*:
  48         s:/\*\*\**\([^/]\):/*\1:
  49         t comment
  50         s:/\*\*/: :
  51         t comment
  52         /\/\*/! b check
  53         N
  54         b comment
  55 :print
  56         P
  57         D
  58 :check
  59         s:^\(CONFIG_[[:alnum:]_]*\):\1\n:
  60         t print
  61         s:^[[:alnum:]_][[:alnum:]_]*::
  62         s:^[^[:alnum:]_][^[:alnum:]_]*::
  63         t check
  64         d
  65 ' $OUTFILE)
  66
  67 # The entries in the following list do not result in an error.
  68 # Please do not add a new entry. This list is only for existing ones.
  69 # The list will be reduced gradually, and deleted eventually. (hopefully)
  70 #
  71 # The format is <file-name>:<CONFIG-option> in each line.
  72 config_leak_ignores="
  73 arch/arc/include/uapi/asm/page.h:CONFIG_ARC_PAGE_SIZE_16K
  74 arch/arc/include/uapi/asm/page.h:CONFIG_ARC_PAGE_SIZE_4K
  75 arch/arc/include/uapi/asm/swab.h:CONFIG_ARC_HAS_SWAPE
  76 arch/arm/include/uapi/asm/ptrace.h:CONFIG_CPU_ENDIAN_BE8
  77 arch/hexagon/include/uapi/asm/ptrace.h:CONFIG_HEXAGON_ARCH_VERSION
  78 arch/hexagon/include/uapi/asm/user.h:CONFIG_HEXAGON_ARCH_VERSION
  79 arch/ia64/include/uapi/asm/cmpxchg.h:CONFIG_IA64_DEBUG_CMPXCHG
  80 arch/m68k/include/uapi/asm/ptrace.h:CONFIG_COLDFIRE
  81 arch/nios2/include/uapi/asm/swab.h:CONFIG_NIOS2_CI_SWAB_NO
  82 arch/nios2/include/uapi/asm/swab.h:CONFIG_NIOS2_CI_SWAB_SUPPORT
  83 arch/x86/include/uapi/asm/auxvec.h:CONFIG_IA32_EMULATION
  84 arch/x86/include/uapi/asm/auxvec.h:CONFIG_X86_64
  85 arch/x86/include/uapi/asm/mman.h:CONFIG_X86_INTEL_MEMORY_PROTECTION_KEYS
  86 include/uapi/linux/atmdev.h:CONFIG_COMPAT
  87 include/uapi/linux/eventpoll.h:CONFIG_PM_SLEEP
  88 include/uapi/linux/hw_breakpoint.h:CONFIG_HAVE_MIXED_BREAKPOINTS_REGS
  89 include/uapi/linux/pktcdvd.h:CONFIG_CDROM_PKTCDVD_WCACHE
  90 "
  91
  92 for c in $configs
  93 do
  94         leak_error=1
  95
  96         for ignore in $config_leak_ignores
  97         do
  98                 if echo "$INFILE:$c" | grep -q "$ignore$"; then
  99                         leak_error=
 100                         break
 101                 fi
 102         done
 103
 104         if [ "$leak_error" = 1 ]; then
 105                 echo "error: $INFILE: leak $c to user-space" >&2
 106                 exit 1
 107         fi
 108 done
 109
 110 rm -f $TMPFILE
 111 trap - EXIT