abi/dump_abi

#!/usr/bin/env python3
#
# 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.
#

import argparse
import os
import sys

from abitool import get_abi_tool

def dump_abi(abitool, linux_tree, out_file, whitelist):
    tool = get_abi_tool(abitool)
    tool.dump_kernel_abi(linux_tree, out_file, whitelist)

def main():
    """ Build the linux kernel, freshly cloning if needed"""
    parser = argparse.ArgumentParser()
    parser.add_argument('--linux-tree',
                        help='Path to kernel tree containing '
                             'vmlinux and modules',
                        required=True)
    parser.add_argument('--abi-tool', default='libabigail',
                        help='abi tool to be used to monitor abi')
    parser.add_argument('--out-file', default=None,
                        help='where to write the abi dump to')
    parser.add_argument('--kmi-whitelist', default=None,
                        help='KMI whitelist to filter for')

    args = parser.parse_args()

    dump_abi(args.abi_tool,
             args.linux_tree,
             args.out_file or os.path.join(args.linux_tree, "abi.xml"),
             args.kmi_whitelist)

if __name__ == "__main__":
    sys.exit(main())