kabi: add kABI reference checking tool

hulk inclusion
category: feature
bugzilla: https://gitee.com/openeuler/kernel/issues/I4JZ0H?from=project-issue
CVE: NA

Add check-kabi tool to detect the kabi changes introduced
by the patch.

Usage:
  ./scripts/check-kabi -k Module.symvers.baseline -s Module.symvers

This tool is ported from CentOS 7.x source packages.
Signed-off-by: NXie XiuQi <xiexiuqi@huawei.com>
Reviewed-by: NLi Bin <huawei.libin@huawei.com>
Signed-off-by: NYang Yingliang <yangyingliang@huawei.com>
Signed-off-by: NJialin Zhang <zhangjialin11@huawei.com>
Reviewed-by: NCheng Jian <cj.chengjian@huawei.com>
Signed-off-by: NZheng Zengkai <zhengzengkai@huawei.com>

scripts/check-kabi

+#!/usr/bin/python
+# SPDX-License-Identifier: GPL-2.0
+#
+# check-kabi - Red Hat kABI reference checking tool
+#
+# We use this script to check against reference Module.kabi files.
+#
+# Author: Jon Masters <jcm@redhat.com>
+# Copyright (C) 2007-2009 Red Hat, Inc.
+#
+# This software may be freely redistributed under the terms of the GNU
+# General Public License (GPL).
+
+# Changelog:
+#
+# 2009/08/15 - Updated for use in RHEL6.
+# 2007/06/13 - Initial rewrite in python by Jon Masters.
+
+__author__ = "Jon Masters <jcm@redhat.com>"
+__version__ = "2.0"
+__date__ = "2009/08/15"
+__copyright__ = "Copyright (C) 2007-2009 Red Hat, Inc"
+__license__ = "GPL"
+
+import getopt
+import os
+import re
+import string
+import sys
+
+true = 1
+false = 0
+
+def load_symvers(symvers,filename):
+	"""Load a Module.symvers file."""
+
+	symvers_file = open(filename,"r")
+
+	while true:
+		in_line = symvers_file.readline()
+		if in_line == "":
+			break
+		if in_line == "\n":
+			continue
+		checksum,symbol,directory,type = string.split(in_line)
+
+		symvers[symbol] = in_line[0:-1]
+
+def load_kabi(kabi,filename):
+	"""Load a Module.kabi file."""
+
+	kabi_file = open(filename,"r")
+
+	while true:
+		in_line = kabi_file.readline()
+		if in_line == "":
+			break
+		if in_line == "\n":
+			continue
+		checksum,symbol,directory,type = string.split(in_line)
+
+		kabi[symbol] = in_line[0:-1]
+
+def check_kabi(symvers,kabi):
+	"""Check Module.kabi and Module.symvers files."""
+
+	fail=0
+	warn=0
+	changed_symbols=[]
+	moved_symbols=[]
+
+	for symbol in kabi:
+		abi_hash,abi_sym,abi_dir,abi_type = string.split(kabi[symbol])
+		if symvers.has_key(symbol):
+			sym_hash,sym_sym,sym_dir,sym_type = string.split(symvers[symbol])
+			if abi_hash != sym_hash:
+				fail=1
+				changed_symbols.append(symbol)
+
+			if abi_dir != sym_dir:
+				warn=1
+				moved_symbols.append(symbol)
+		else:
+			fail=1
+			changed_symbols.append(symbol)
+
+	if fail:
+		print "*** ERROR - ABI BREAKAGE WAS DETECTED ***"
+		print ""
+		print "The following symbols have been changed (this will cause an ABI breakage):"
+		print ""
+		for symbol in changed_symbols:
+			print symbol
+		print ""
+
+	if warn:
+		print "*** WARNING - ABI SYMBOLS MOVED ***"
+		print ""
+		print "The following symbols moved (typically caused by moving a symbol from being"
+		print "provided by the kernel vmlinux out to a loadable module):"
+		print ""
+		for symbol in moved_symbols:
+			print symbol
+		print ""
+
+	"""Halt the build, if we got errors and/or warnings. In either case,
+	   double-checkig is required to avoid introducing / concealing
+	   KABI inconsistencies."""
+	if fail or warn:
+		sys.exit(1)
+	sys.exit(0)
+
+def usage():
+	print """
+check-kabi: check Module.kabi and Module.symvers files.
+
+	check-kabi [ -k Module.kabi ] [ -s Module.symvers ]
+
+"""
+
+if __name__ == "__main__":
+
+	symvers_file = ""
+	kabi_file = ""
+
+	opts, args = getopt.getopt(sys.argv[1:], 'hk:s:')
+
+	for o, v in opts:
+		if o == "-s":
+			symvers_file = v
+		if o == "-h":
+			usage()
+			sys.exit(0)
+		if o == "-k":
+			kabi_file = v
+
+	if (symvers_file == "") or (kabi_file == ""):
+		usage()
+		sys.exit(1)
+
+	symvers={}
+	kabi={}
+
+	load_symvers(symvers,symvers_file)
+	load_kabi(kabi,kabi_file)
+	check_kabi(symvers,kabi)
+