blob: b3c1b4633ce5d3ef6c161dc2ffaf2f7716e18204 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
|
#!/bin/bash
# Copyright (C) 2019 The Android Open Source Project
#
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at
#
# http://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.
# Usage:
# build/build_abi.sh
#
# The following environment variables are considered during execution:
#
# ABI_OUT_TAG
# Customize the output file name for the abi dump. If undefined, the tag is
# derived from `git describe`.
export ROOT_DIR=$(readlink -f $(dirname $0)/..)
function show_help {
echo "USAGE: $0 [-u|--update] [-n|--nodiff]"
echo
echo " -u | --update Update the abi.xml in the source directory"
echo " -n | --nodiff Do not generate a ABI report with abidiff"
echo " -r | --print-report Print ABI report in case of differences"
}
UPDATE=0
DIFF=1
PRINT_REPORT=0
ARGS=()
for i in "$@"
do
case $i in
-u|--update)
UPDATE=1
shift # past argument=value
;;
-n|--nodiff)
DIFF=0
shift # past argument=value
;;
-r|--print-report)
PRINT_REPORT=1
shift # past argument=value
;;
-h|--help)
show_help
exit 0
;;
*)
ARGS+=("$1")
shift
;;
esac
done
set -- "${ARGS[@]}"
set -e
set -a
source "${ROOT_DIR}/build/_setup_env.sh"
# inject CONFIG_DEBUG_INFO=y
export POST_DEFCONFIG_CMDS="${POST_DEFCONFIG_CMDS} : && update_config_for_abi_dump"
function update_config_for_abi_dump() {
${KERNEL_DIR}/scripts/config --file ${OUT_DIR}/.config \
-e CONFIG_DEBUG_INFO
(cd ${OUT_DIR} && \
make O=${OUT_DIR} ${CC_LD_ARG} $archsubarch CROSS_COMPILE=${CROSS_COMPILE} olddefconfig)
}
export -f check_defconfig
export -f update_config_for_abi_dump
function version_greater_than() {
test "$(printf '%s\n' "$@" | sort -V | head -n 1)" != "$1";
}
# ensure that abigail is present in path
if ! ( hash abidiff 2>/dev/null); then
echo "ERROR: libabigail is not found in \$PATH at all!"
echo "Have you run build/abi/bootstrap and followed the instructions?"
exit 1
fi
# ensure we have a "new enough" version of abigail present before continuing
if ! ( version_greater_than "$(abidiff --version | awk '{print $2}')" \
"1.6.0" ); then
echo "ERROR: no suitable libabigail (>= 1.6.0) in \$PATH."
echo "Have you run build/abi/bootstrap and followed the instructions?"
exit 1
fi
# delegate the actual build to build.sh
ABI_DEFINITION= ${ROOT_DIR}/build/build.sh $*
echo "========================================================"
echo " Creating ABI dump"
# create abi dump
COMMON_OUT_DIR=$(readlink -m ${OUT_DIR:-${ROOT_DIR}/out/${BRANCH}})
id=${ABI_OUT_TAG:-$(git -C $KERNEL_DIR describe --dirty --always)}
abi_out_file=abi-${id}.xml
${ROOT_DIR}/build/abi/dump_abi \
--linux-tree $OUT_DIR \
--out-file ${DIST_DIR}/${abi_out_file}
# sanitize the abi.xml by removing any occurences of the kernel path
sed -i "s#${ROOT_DIR}/${KERNEL_DIR}/##g" ${DIST_DIR}/${abi_out_file}
# now also do that with any left over paths sneaking in
# (e.g. from the prebuilts)
sed -i "s#${ROOT_DIR}/##g" ${DIST_DIR}/${abi_out_file}
ln -sf ${abi_out_file} ${DIST_DIR}/abi.xml
echo "========================================================"
echo " ABI dump has been created at ${DIST_DIR}/${abi_out_file}"
rc=0
if [ -n "$ABI_DEFINITION" ]; then
if [ $DIFF -eq 1 ]; then
echo "========================================================"
echo " Comparing ABI against expected definition ($ABI_DEFINITION)"
abi_report=${DIST_DIR}/abi.report
set +e
${ROOT_DIR}/build/abi/diff_abi --baseline $KERNEL_DIR/$ABI_DEFINITION \
--new ${DIST_DIR}/${abi_out_file} \
--report ${abi_report}
rc=$?
set -e
echo "========================================================"
echo " ABI report has been created at ${abi_report}"
if [ $rc -ne 0 ]; then
echo " ABI DIFFERENCES HAVE BEEN DETECTED! (RC=$rc)"
fi
if [ $PRINT_REPORT -eq 1 ] && [ $rc -ne 0 ] ; then
echo "========================================================"
cat ${abi_report}
fi
fi
if [ $UPDATE -eq 1 ] ; then
echo "========================================================"
echo " Updating expected ABI definition ($ABI_DEFINITION)"
cp -v ${DIST_DIR}/${abi_out_file} $KERNEL_DIR/$ABI_DEFINITION
fi
fi
exit $rc
|
