213 lines
8.6 KiB
C++
213 lines
8.6 KiB
C++
// Copyright (C) 2016 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.
|
|
|
|
#include "abi_diff.h"
|
|
|
|
#include <fstream>
|
|
|
|
#include <llvm/Support/CommandLine.h>
|
|
#include <llvm/Support/FileSystem.h>
|
|
#include <llvm/Support/raw_ostream.h>
|
|
|
|
static llvm::cl::OptionCategory header_checker_category(
|
|
"header-abi-diff options");
|
|
|
|
static llvm::cl::opt<std::string> compatibility_report(
|
|
"o", llvm::cl::desc("<compatibility report>"), llvm::cl::Required,
|
|
llvm::cl::cat(header_checker_category));
|
|
|
|
static llvm::cl::opt<std::string> lib_name(
|
|
"lib", llvm::cl::desc("<lib name>"), llvm::cl::Required,
|
|
llvm::cl::cat(header_checker_category));
|
|
|
|
static llvm::cl::opt<std::string> arch(
|
|
"arch", llvm::cl::desc("<arch>"), llvm::cl::Required,
|
|
llvm::cl::cat(header_checker_category));
|
|
|
|
static llvm::cl::opt<std::string> new_dump(
|
|
"new", llvm::cl::desc("<new dump>"), llvm::cl::Required,
|
|
llvm::cl::cat(header_checker_category));
|
|
|
|
static llvm::cl::opt<std::string> old_dump(
|
|
"old", llvm::cl::desc("<old dump>"), llvm::cl::Required,
|
|
llvm::cl::cat(header_checker_category));
|
|
|
|
static llvm::cl::opt<std::string> ignore_symbol_list(
|
|
"ignore-symbols", llvm::cl::desc("ignore symbols"), llvm::cl::Optional,
|
|
llvm::cl::cat(header_checker_category));
|
|
|
|
static llvm::cl::opt<bool> advice_only(
|
|
"advice-only", llvm::cl::desc("Advisory mode only"), llvm::cl::Optional,
|
|
llvm::cl::cat(header_checker_category));
|
|
|
|
static llvm::cl::opt<bool> elf_unreferenced_symbol_errors(
|
|
"elf-unreferenced-symbol-errors",
|
|
llvm::cl::desc("Display erors on removal of elf symbols, unreferenced by"
|
|
"metadata in exported headers."),
|
|
llvm::cl::Optional, llvm::cl::cat(header_checker_category));
|
|
|
|
static llvm::cl::opt<bool> check_all_apis(
|
|
"check-all-apis",
|
|
llvm::cl::desc("All apis, whether referenced or not, by exported symbols in"
|
|
" the dynsym table of a shared library are checked"),
|
|
llvm::cl::Optional, llvm::cl::cat(header_checker_category));
|
|
|
|
static llvm::cl::opt<bool> suppress_local_warnings(
|
|
"suppress_local_warnings", llvm::cl::desc("suppress local warnings"),
|
|
llvm::cl::Optional, llvm::cl::cat(header_checker_category));
|
|
|
|
static llvm::cl::opt<bool> allow_extensions(
|
|
"allow-extensions",
|
|
llvm::cl::desc("Do not return a non zero status on extensions"),
|
|
llvm::cl::Optional, llvm::cl::cat(header_checker_category));
|
|
|
|
static llvm::cl::opt<bool> allow_unreferenced_elf_symbol_changes(
|
|
"allow-unreferenced-elf-symbol-changes",
|
|
llvm::cl::desc("Do not return a non zero status on changes to elf symbols"
|
|
"not referenced by metadata in exported headers"),
|
|
llvm::cl::Optional, llvm::cl::cat(header_checker_category));
|
|
|
|
static llvm::cl::opt<bool> allow_unreferenced_changes(
|
|
"allow-unreferenced-changes",
|
|
llvm::cl::desc("Do not return a non zero status on changes to data"
|
|
" structures which are not directly referenced by exported"
|
|
" APIs."),
|
|
llvm::cl::Optional, llvm::cl::cat(header_checker_category));
|
|
|
|
static llvm::cl::opt<bool> consider_opaque_types_different(
|
|
"consider-opaque-types-different",
|
|
llvm::cl::desc("Consider opaque types with different names as different"
|
|
" .This should not be used while comparing C++ library"
|
|
" ABIs"),
|
|
llvm::cl::Optional, llvm::cl::cat(header_checker_category));
|
|
|
|
|
|
static llvm::cl::opt<abi_util::TextFormatIR> text_format_old(
|
|
"text-format-old", llvm::cl::desc("Specify text format of old abi dump"),
|
|
llvm::cl::values(clEnumValN(abi_util::TextFormatIR::ProtobufTextFormat,
|
|
"ProtobufTextFormat","ProtobufTextFormat"),
|
|
clEnumValEnd),
|
|
llvm::cl::init(abi_util::TextFormatIR::ProtobufTextFormat),
|
|
llvm::cl::cat(header_checker_category));
|
|
|
|
static llvm::cl::opt<abi_util::TextFormatIR> text_format_new(
|
|
"text-format-new", llvm::cl::desc("Specify text format of new abi dump"),
|
|
llvm::cl::values(clEnumValN(abi_util::TextFormatIR::ProtobufTextFormat,
|
|
"ProtobufTextFormat", "ProtobugTextFormat"),
|
|
clEnumValEnd),
|
|
llvm::cl::init(abi_util::TextFormatIR::ProtobufTextFormat),
|
|
llvm::cl::cat(header_checker_category));
|
|
|
|
static llvm::cl::opt<abi_util::TextFormatIR> text_format_diff(
|
|
"text-format-diff", llvm::cl::desc("Specify text format of abi-diff"),
|
|
llvm::cl::values(clEnumValN(abi_util::TextFormatIR::ProtobufTextFormat,
|
|
"ProtobufTextFormat", "ProtobufTextFormat"),
|
|
clEnumValEnd),
|
|
llvm::cl::init(abi_util::TextFormatIR::ProtobufTextFormat),
|
|
llvm::cl::cat(header_checker_category));
|
|
|
|
static std::set<std::string> LoadIgnoredSymbols(std::string &symbol_list_path) {
|
|
std::ifstream symbol_ifstream(symbol_list_path);
|
|
std::set<std::string> ignored_symbols;
|
|
if (!symbol_ifstream) {
|
|
llvm::errs() << "Failed to open file containing symbols to ignore\n";
|
|
::exit(1);
|
|
}
|
|
std::string line = "";
|
|
while (std::getline(symbol_ifstream, line)) {
|
|
ignored_symbols.insert(line);
|
|
}
|
|
return ignored_symbols;
|
|
}
|
|
|
|
static const char kWarn[] = "\033[36;1mwarning: \033[0m";
|
|
static const char kError[] = "\033[31;1merror: \033[0m";
|
|
|
|
bool ShouldEmitWarningMessage(abi_util::CompatibilityStatusIR status) {
|
|
return (!allow_extensions &&
|
|
(status & abi_util::CompatibilityStatusIR::Extension)) ||
|
|
(!allow_unreferenced_changes &&
|
|
(status & abi_util::CompatibilityStatusIR::UnreferencedChanges)) ||
|
|
(!allow_unreferenced_elf_symbol_changes &&
|
|
(status & abi_util::CompatibilityStatusIR::ElfIncompatible)) ||
|
|
(status & abi_util::CompatibilityStatusIR::Incompatible);
|
|
}
|
|
|
|
int main(int argc, const char **argv) {
|
|
llvm::cl::ParseCommandLineOptions(argc, argv, "header-checker");
|
|
std::set<std::string> ignored_symbols;
|
|
if (llvm::sys::fs::exists(ignore_symbol_list)) {
|
|
ignored_symbols = LoadIgnoredSymbols(ignore_symbol_list);
|
|
}
|
|
abi_util::DiffPolicyOptions diff_policy_options(
|
|
consider_opaque_types_different);
|
|
HeaderAbiDiff judge(lib_name, arch, old_dump, new_dump, compatibility_report,
|
|
ignored_symbols, diff_policy_options, check_all_apis,
|
|
text_format_old, text_format_new, text_format_diff);
|
|
|
|
abi_util::CompatibilityStatusIR status = judge.GenerateCompatibilityReport();
|
|
|
|
std::string status_str = "";
|
|
std::string unreferenced_change_str = "";
|
|
std::string error_or_warning_str = kWarn;
|
|
|
|
switch (status) {
|
|
case abi_util::CompatibilityStatusIR::Incompatible:
|
|
error_or_warning_str = kError;
|
|
status_str = "INCOMPATIBLE CHANGES";
|
|
break;
|
|
case abi_util::CompatibilityStatusIR::ElfIncompatible:
|
|
if (elf_unreferenced_symbol_errors) {
|
|
error_or_warning_str = kError;
|
|
}
|
|
status_str = "ELF Symbols not referenced by exported headers removed";
|
|
break;
|
|
default:
|
|
break;
|
|
}
|
|
if (status & abi_util::CompatibilityStatusIR::Extension) {
|
|
if (!allow_extensions) {
|
|
error_or_warning_str = kError;
|
|
}
|
|
status_str = "EXTENDING CHANGES";
|
|
}
|
|
if (status & abi_util::CompatibilityStatusIR::UnreferencedChanges) {
|
|
unreferenced_change_str = ", changes in exported headers, which are";
|
|
unreferenced_change_str += " not directly referenced by exported symbols.";
|
|
unreferenced_change_str += " This MIGHT be an ABI breaking change due to";
|
|
unreferenced_change_str += " internal typecasts.";
|
|
}
|
|
|
|
bool should_emit_warning_message = ShouldEmitWarningMessage(status);
|
|
|
|
if (should_emit_warning_message) {
|
|
llvm::errs() << "******************************************************\n"
|
|
<< error_or_warning_str
|
|
<< "VNDK library: "
|
|
<< lib_name
|
|
<< "'s ABI has "
|
|
<< status_str
|
|
<< unreferenced_change_str
|
|
<< " Please check compatiblity report at : "
|
|
<< compatibility_report << "\n"
|
|
<< "******************************************************\n";
|
|
}
|
|
|
|
if (!advice_only && should_emit_warning_message) {
|
|
return status;
|
|
}
|
|
|
|
return abi_util::CompatibilityStatusIR::Compatible;
|
|
}
|