abg-elf-based-reader.cc

Go to the documentation of this file.

// SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
// -*- Mode: C++ -*-
//
// Copyright (C) 2022-2025 Red Hat, Inc.
//
// Author: Dodji Seketeli
 
/// @file
///
/// This file contains the definitions of the entry points of the
/// generic interface for ELF-based front-ends.  The generic interface
/// for ELF-based front-ends is named @ref elf_based_reader.  Examples
/// of front-ends that implement that interface are @ref
/// abigail::dwarf_reader::reader and abigail::ctf_raeder::reader.
 
#include "abg-internal.h"
 
// <headers defining libabigail's API go under here>
ABG_BEGIN_EXPORT_DECLARATIONS
 
#include "abg-elf-based-reader.h"
 
ABG_END_EXPORT_DECLARATIONS
// </headers defining libabigail's API>
namespace abigail
{
 
/// The private data of the @ref elf_based_reader type.
struct elf_based_reader::priv
{
 
  void
  initialize()
  {
  }
 
  priv()
  {
    initialize();
  }
}; // end struct elf_based_reader::priv
 
/// Constructor of the @erf elf_based_reader type.
///
/// @param elf_path the path the ELF file to read.
///
/// @param debug_info_root_paths a vector of paths to look into for
/// split debug info files.
///
/// @param env the environment used by the reader.
elf_based_reader::elf_based_reader(const std::string& elf_path,
                   const vector<char**>& debug_info_root_paths,
                   environment& env)
  : elf::reader(elf_path, debug_info_root_paths, env),
    priv_(new priv)
{
  priv_->initialize();
}
 
/// Destructor of the reader.
elf_based_reader::~elf_based_reader()
{delete priv_;}
 
/// (re)Initialize) the resources used by the current reader.
///
/// This frees the resources of the current reader and gets it ready
/// to read data from another ELF file.
///
/// @param elf_path the path to the new ELF file to consider.
///
/// @param debug_info_root_paths a vector of paths to look into for
/// split debug info files.
void
elf_based_reader::initialize(const std::string& elf_path,
                 const vector<char**>& debug_info_root_paths)
{
  elf::reader::initialize(elf_path, debug_info_root_paths);
  priv_->initialize();
}
 
/// (re)Initialize the resources used by the current reader.
///
/// This invokes fe_iface::initialize as wel as the virtual pure
/// elf_based_reader::initialize() interface.
///
/// @param corpus_path path to the corpus to be built.
void
elf_based_reader::initialize(const std::string& corpus_path)
{
  fe_iface::initialize(corpus_path);
  vector<char**> v;
  initialize(corpus_path, v, /*load_all_type=*/false,
         /*linux_kernel_mode=*/false);
}
 
/// Read an ABI corpus and add it to a given corpus group.
///
/// @param group the corpus group to consider.  The new corpus is
/// added to this group.
///
/// @param status output parameter.  This is the status of the
/// creation of the current ABI corpus.  It's set by this function iff
/// a non-nil @ref corpus_sptr is returned.
///
/// @return the resulting ABI corpus.
ir::corpus_sptr
elf_based_reader::read_and_add_corpus_to_group(ir::corpus_group& group,
                           fe_iface::status& status)
{
  ir::corpus_sptr corp = read_corpus(status);
  group.add_corpus(corp);
  return corp;
}
 
} // end namespace abigail