You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
201 lines
4.4 KiB
201 lines
4.4 KiB
// SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
|
|
// -*- Mode: C++ -*-
|
|
//
|
|
// Copyright (C) 2013-2020 Red Hat, Inc.
|
|
//
|
|
// Author: Dodji Seketeli
|
|
|
|
/// @file
|
|
///
|
|
/// This file contains the declarations of the entry points to
|
|
/// de-serialize an instance of @ref abigail::corpus from a file in
|
|
/// elf format, containing dwarf information.
|
|
|
|
#ifndef __ABG_DWARF_READER_H__
|
|
#define __ABG_DWARF_READER_H__
|
|
|
|
#include <ostream>
|
|
#include <elfutils/libdwfl.h>
|
|
#include "abg-corpus.h"
|
|
#include "abg-suppression.h"
|
|
|
|
namespace abigail
|
|
{
|
|
|
|
/// The namespace for the DWARF reader.
|
|
namespace dwarf_reader
|
|
{
|
|
|
|
using namespace abigail::ir;
|
|
|
|
/// The status of the @ref read_corpus_from_elf() call.
|
|
enum status
|
|
{
|
|
/// The status is in an unknown state
|
|
STATUS_UNKNOWN = 0,
|
|
|
|
/// This status is for when the call went OK.
|
|
STATUS_OK = 1,
|
|
|
|
/// This status is for when the debug info could not be read.
|
|
STATUS_DEBUG_INFO_NOT_FOUND = 1 << 1,
|
|
|
|
/// This status is for when the alternate debug info could not be
|
|
/// found.
|
|
STATUS_ALT_DEBUG_INFO_NOT_FOUND = 1 << 2,
|
|
|
|
/// This status is for when the symbols of the ELF binaries could
|
|
/// not be read.
|
|
STATUS_NO_SYMBOLS_FOUND = 1 << 3,
|
|
};
|
|
|
|
string
|
|
status_to_diagnostic_string(status s);
|
|
|
|
status
|
|
operator|(status, status);
|
|
|
|
status
|
|
operator&(status, status);
|
|
|
|
status&
|
|
operator|=(status&, status);
|
|
|
|
status&
|
|
operator&=(status&, status);
|
|
|
|
/// The kind of ELF file we are looking at.
|
|
enum elf_type
|
|
{
|
|
/// A normal executable binary
|
|
ELF_TYPE_EXEC,
|
|
/// A Position Independant Executable binary
|
|
ELF_TYPE_PI_EXEC,
|
|
/// A dynamic shared object, a.k.a shared library binrary.
|
|
ELF_TYPE_DSO,
|
|
/// A relocatalbe binary.
|
|
ELF_TYPE_RELOCATABLE,
|
|
/// An unknown kind of binary.
|
|
ELF_TYPE_UNKNOWN
|
|
};
|
|
|
|
class read_context;
|
|
|
|
/// A convenience typedef for a smart pointer to a
|
|
/// dwarf_reader::read_context.
|
|
typedef shared_ptr<read_context> read_context_sptr;
|
|
|
|
read_context_sptr
|
|
create_read_context(const std::string& elf_path,
|
|
const vector<char**>& debug_info_root_paths,
|
|
ir::environment* environment,
|
|
bool read_all_types = false,
|
|
bool linux_kernel_mode = false);
|
|
|
|
const string&
|
|
read_context_get_path(const read_context&);
|
|
|
|
void
|
|
reset_read_context(read_context_sptr &ctxt,
|
|
const std::string& elf_path,
|
|
const vector<char**>& debug_info_root_paths,
|
|
ir::environment* environment,
|
|
bool read_all_types = false,
|
|
bool linux_kernel_mode = false);
|
|
|
|
void
|
|
add_read_context_suppressions(read_context& ctxt,
|
|
const suppr::suppressions_type& supprs);
|
|
|
|
void
|
|
set_read_context_corpus_group(read_context& ctxt, corpus_group_sptr& group);
|
|
|
|
corpus_sptr
|
|
read_corpus_from_elf(read_context& ctxt, status& stat);
|
|
|
|
corpus_sptr
|
|
read_corpus_from_elf(const std::string& elf_path,
|
|
const vector<char**>& debug_info_root_paths,
|
|
ir::environment* environment,
|
|
bool load_all_types,
|
|
status&);
|
|
|
|
corpus_sptr
|
|
read_and_add_corpus_to_group_from_elf(read_context&, corpus_group&, status&);
|
|
|
|
bool
|
|
lookup_symbol_from_elf(const environment* env,
|
|
const string& elf_path,
|
|
const string& symbol_name,
|
|
bool demangle,
|
|
vector<elf_symbol_sptr>& symbols);
|
|
|
|
bool
|
|
lookup_public_function_symbol_from_elf(const environment* env,
|
|
const string& path,
|
|
const string& symname,
|
|
vector<elf_symbol_sptr>& func_syms);
|
|
|
|
bool
|
|
refers_to_alt_debug_info(const read_context& ctxt,
|
|
string& alt_di_path);
|
|
|
|
status
|
|
has_alt_debug_info(read_context& ctxt,
|
|
bool& has_alt_di,
|
|
string& alt_debug_info_path);
|
|
|
|
status
|
|
has_alt_debug_info(const string& elf_path,
|
|
char** debug_info_root_path,
|
|
bool& has_alt_di,
|
|
string& alt_debug_info_path);
|
|
|
|
bool
|
|
get_soname_of_elf_file(const string& path, string& soname);
|
|
|
|
bool
|
|
get_type_of_elf_file(const string& path, elf_type& type);
|
|
|
|
|
|
void
|
|
set_debug_info_root_path(read_context& ctxt,
|
|
char** path);
|
|
|
|
char**
|
|
get_debug_info_root_path(read_context& ctxt,
|
|
char**& path);
|
|
|
|
bool
|
|
get_show_stats(read_context& ctxt);
|
|
|
|
void
|
|
set_show_stats(read_context& ctxt,
|
|
bool f);
|
|
|
|
void
|
|
set_drop_undefined_syms(read_context& ctxt,
|
|
bool f);
|
|
|
|
void
|
|
set_merge_translation_units(read_context& ctxt,
|
|
bool f);
|
|
|
|
void
|
|
set_do_log(read_context& ctxt, bool f);
|
|
|
|
void
|
|
set_environment(read_context& ctxt,
|
|
ir::environment*);
|
|
|
|
const environment_sptr&
|
|
get_environment(const read_context& ctxt);
|
|
|
|
environment_sptr&
|
|
get_environment(read_context& ctxt);
|
|
}// end namespace dwarf_reader
|
|
|
|
}// end namespace abigail
|
|
|
|
#endif //__ABG_DWARF_READER_H__
|