From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from smtp.tuxdriver.com (charlotte.tuxdriver.com [70.61.120.58]) by dpdk.org (Postfix) with ESMTP id BCFD51B341 for ; Tue, 16 Jan 2018 19:22:53 +0100 (CET) Received: from [107.15.66.59] (helo=hmswarspite.think-freely.org) by smtp.tuxdriver.com with esmtpsa (TLSv1:AES256-SHA:256) (Exim 4.63) (envelope-from ) id 1ebVsX-0003vM-81; Tue, 16 Jan 2018 13:22:47 -0500 Received: from hmswarspite.think-freely.org (localhost [127.0.0.1]) by hmswarspite.think-freely.org (8.15.2/8.15.2) with ESMTP id w0GIMVX8027180; Tue, 16 Jan 2018 13:22:31 -0500 Received: (from nhorman@localhost) by hmswarspite.think-freely.org (8.15.2/8.15.2/Submit) id w0GIMUCX027179; Tue, 16 Jan 2018 13:22:30 -0500 From: Neil Horman To: dev@dpdk.org Cc: Neil Horman , thomas@monjalon.net, john.mcnamara@intel.com, bruce.richardson@intel.com, Ferruh Yigit , Stephen Hemminger Date: Tue, 16 Jan 2018 13:22:25 -0500 Message-Id: <20180116182225.27133-1-nhorman@tuxdriver.com> X-Mailer: git-send-email 2.14.3 In-Reply-To: <20180115190545.25687-1-nhorman@tuxdriver.com> References: <20180115190545.25687-1-nhorman@tuxdriver.com> X-Spam-Score: -2.9 (--) X-Spam-Status: No Subject: [dpdk-dev] [PATCH v2] checkpatches.sh: Add checks for ABI symbol addition X-BeenThere: dev@dpdk.org X-Mailman-Version: 2.1.15 Precedence: list List-Id: DPDK patches and discussions List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 16 Jan 2018 18:22:54 -0000 Recently, some additional patches were added to allow for programmatic marking of C symbols as experimental. The addition of these markers is dependent on the manual addition of exported symbols to the EXPERIMENTAL section of the corresponding libraries version map file. The consensus on review is that, in addition to mandating the addition of symbols to the EXPERIMENTAL version in the map, we need a mechanism to enforce our documented process of mandating that addition when they are introduced. To that end, I am proposing this change. It is an addition to the checkpatches script, which scan incoming patches for additions and removals of symbols to the map file, and warns the user appropriately Signed-off-by: Neil Horman CC: thomas@monjalon.net CC: john.mcnamara@intel.com CC: bruce.richardson@intel.com CC: Ferruh Yigit CC: Stephen Hemminger --- Change notes v2) * Cleaned up and documented awk script (shemminger) * fixed sort/uniq usage (shemminger) * moved checking to new script (tmonjalon) * added maintainer entry (tmonjalon) * added license (tmonjalon) --- MAINTAINERS | 2 + devtools/checkpatches.sh | 22 ++++++- devtools/validate-new-api.sh | 138 +++++++++++++++++++++++++++++++++++++++++++ 3 files changed, 161 insertions(+), 1 deletion(-) create mode 100755 devtools/validate-new-api.sh diff --git a/MAINTAINERS b/MAINTAINERS index b51c2d096..d3a3c245e 100644 --- a/MAINTAINERS +++ b/MAINTAINERS @@ -42,6 +42,7 @@ F: doc/ Developers and Maintainers Tools M: Thomas Monjalon +M: Neil Horman F: MAINTAINERS F: devtools/check-dup-includes.sh F: devtools/check-maintainers.sh @@ -52,6 +53,7 @@ F: devtools/get-maintainer.sh F: devtools/git-log-fixes.sh F: devtools/load-devel-config F: devtools/test-build.sh +F: devtools/validate-new-api.sh F: license/ diff --git a/devtools/checkpatches.sh b/devtools/checkpatches.sh index 7676a6b50..cf5c67b09 100755 --- a/devtools/checkpatches.sh +++ b/devtools/checkpatches.sh @@ -35,6 +35,8 @@ # - DPDK_CHECKPATCH_LINE_LENGTH . $(dirname $(readlink -e $0))/load-devel-config +export VALIDATE_NEW_API=$(dirname $(readlink -e $0))/validate-new-api.sh + length=${DPDK_CHECKPATCH_LINE_LENGTH:-80} # override default Linux options @@ -51,6 +53,7 @@ NEW_TYPEDEFS,COMPARISON_TO_NULL" print_usage () { cat <<- END_OF_HELP + $(dirname $0) usage: $(basename $0) [-q] [-v] [-nX|patch1 [patch2] ...]] Run Linux kernel checkpatch.pl with DPDK options. @@ -61,6 +64,7 @@ print_usage () { END_OF_HELP } + number=0 quiet=false verbose=false @@ -96,9 +100,25 @@ check () { # else report=$($DPDK_CHECKPATCH_PATH $options - 2>/dev/null) fi - [ $? -ne 0 ] || return 0 + reta=$? + $verbose || printf '\n### %s\n\n' "$3" printf '%s\n' "$report" | sed -n '1,/^total:.*lines checked$/p' + + echo + echo "Checking API additions/removals:" + if [ -n "$1" ] ; then + report=$($VALIDATE_NEW_API $1) + elif [ -n "$2" ] ; then + report=$(git format-patch \ + --find-renames --no-stat --stdout -1 $commit | + $VALIDATE_NEW_API -) + else + report=$($VALIDATE_NEW_API -) + fi + [ $? -ne 0 -o $reta -ne 0 ] || return 0 + printf '%s\n' "$report" | sed -n '1,/^total:.*lines checked$/p' + status=$(($status + 1)) } diff --git a/devtools/validate-new-api.sh b/devtools/validate-new-api.sh new file mode 100755 index 000000000..3499f5f8b --- /dev/null +++ b/devtools/validate-new-api.sh @@ -0,0 +1,138 @@ +#!/bin/sh + +# SPDX-License-Identifier: BSD-3-Clause +# Copyright(c) 2018 Neil Horman <nhorman@tuxdriver.com> + +build_map_changes() +{ + local fname=$1 + local mapdb=$2 + + cat $fname | filterdiff -i *.map | awk ' + # Initialize our variables + BEGIN {map="";sym="";ar="";sec=""; in_sec=0} + + # Anything that starts with + or -, followed by an a + # and ends in the string .map is the name of our map file + # This may appear multiple times in a patch if multiple + # map files are altered, and all section/symbol names + # appearing between a triggering of this rule and the + # next trigger of this rule are associated with this file + /[-+] a\/.*\.map/ {map=$2} + + # Triggering this rule, which starts a line with a + and ends it + # with a { identifies a versioned section. The section name is + # the rest of the line with the + and { symbols remvoed. + # Triggering this rule sets in_sec to 1, which actives the + # symbol rule below + /+.*{/ {gsub("+","");sec=$1; in_sec=1} + + # This rule idenfies the end of a section, and disables the + # symbol rule + /.*}/ {in_sec=0} + + # This rule matches on a + followed by any characters except a : + # (which denotes a global vs local segment), and ends with a ;. + # The semicolon is removed and the symbol is printed with its + # association file name and version section, along with an + # indicator that the symbol is a new addition. Note this rule + # only works if we have found a version section in the rule + # above (hence the in_sec check). Otherwise we flag it as an + # unknown section + /^+[^}].*[^:*];/ {gsub(";","");sym=$2; + if (in_sec == 1) { + print map " " sym " " sec " add" + } else { + print map " " sym " unknown add" + } + } + + # This is the same rule as above, but the rule matches on a + # leading - rather than a +, denoting that the symbol is being + # removed. + /^-[^}].*[^:*];/ {gsub(";","");sym=$2; + if (in_sec == 1) { + print map " " sym " " sec " del" + } else { + print map " " sym " unknown del" + } + }' > ./$mapdb + + sort -u $mapdb > ./$mapdb.2 + mv -f $mapdb.2 $mapdb + +} + +check_for_rule_violations() +{ + local mapdb=$1 + local mname + local symname + local secname + local ar + local ret=0 + + while read mname symname secname ar + do + if [ "$ar" == "add" ] + then + + if [ "$secname" == "unknown" ] + then + # Just inform the user of this occurrence, but + # don't flag it as an error + echo -n "INFO: symbol $syname is added but " + echo -n "patch has insuficient context " + echo -n "to determine the section name " + echo -n "please ensure the version is " + echo "EXPERIMENTAL" + continue + fi + + if [ "$secname" != "EXPERIMENTAL" ] + then + # Symbols that are getting added in a section + # other ithan the experimental section + # to be moving from an already supported + # section or its a violation + grep -q \ + "$mname $symname [^EXPERIMENTAL] del" $mapdb + if [ $? -ne 0 ] + then + echo -n "ERROR: symbol $symname " + echo -n "is added in a section " + echo -n "other than the EXPERIMENTAL " + echo "section of the version map" + ret=1 + fi + fi + else + + if [ "$secname" != "EXPERIMENTAL" ] + then + # Just inform users that non-experimenal + # symbols need to go through a deprecation + # process + echo -n "INFO: symbol $symname is being " + echo -n "removed, ensure that it has " + echo "gone through the deprecation process" + fi + fi + done < $mapdb + + return $ret +} + + +mapfile=`mktemp mapdb.XXXXXX` +patch=$1 + +build_map_changes $patch $mapfile +check_for_rule_violations $mapfile +exit_code=$? + +rm -f $mapfile + +exit $exit_code + + -- 2.14.3