bfd_support.h

Go to the documentation of this file.

#ifndef BFD_SUPPORT_H
#define BFD_SUPPORT_H

#include "config.h"
#include "utility.h"
#include "op_types.h"
#include "locate_images.h"

#include <bfd.h>
#include <stdint.h>

#include <string>
#include <map>

class op_bfd_symbol;

struct bfd_info {
    bfd_info() : abfd(0), nr_syms(0), synth_syms(0), image_bfd_info(0) {}

    ~bfd_info();

    void close();

    bool valid() const { return abfd; }

    bool has_debug_info() const;

    void get_symbols();

    bfd * abfd;
    scoped_array<asymbol *> syms;
    size_t nr_syms;

    void set_image_bfd_info(bfd_info * ibfd) { image_bfd_info = ibfd; }
    bfd_info * get_image_bfd_info(void) const { return image_bfd_info; }

private:
    bool get_synth_symbols();

    asymbol * synth_syms;

    bfd_info * image_bfd_info;

#if SYNTHESIZE_SYMBOLS

    void translate_debuginfo_syms(asymbol ** dbg_syms, long nr_dbg_syms);

    std::map<bfd_vma, bfd_vma> section_vma_maps;

#endif

};


/*
 * find_separate_debug_file - return true if a valid separate debug file found
 * @param ibfd binary file
 * @param dir_in directory holding the binary file
 * @param global_in
 * @param filename path to valid debug file
 *
 * Search order for debug file and use first one found:
 * 1) dir_in directory
 * 2) dir_in/.debug directory
 * 3) global_in/dir_in directory
 *
 * Newer binutils and Linux distributions (e.g. Fedora) allow the
 * creation of debug files that are separate from the binary. The
 * debugging information is stripped out of the binary file, placed in
 * this separate file, and a link to the new file is placed in the
 * binary. The debug files hold the information needed by the debugger
 * (and OProfile) to map machine instructions back to source code.
 */
extern bool
find_separate_debug_file(bfd * ibfd, 
                         std::string const & filepath_in,
                         std::string & debug_filename,
                         extra_images const & extra);

bfd * open_bfd(std::string const & file);

bfd * fdopen_bfd(std::string const & file, int fd);

bfd * spu_open_bfd(std::string const name, int fd, uint64_t offset_to_spu_elf);

bool interesting_symbol(asymbol * sym);

bool boring_symbol(op_bfd_symbol const & first, op_bfd_symbol const & second);

struct linenr_info {
    bool found;
    std::string filename;
    unsigned int line;
};

linenr_info const
find_nearest_line(bfd_info const & ibfd, op_bfd_symbol const & sym,
                  bfd_vma offset, bool anon_obj);

#endif /* !BFD_SUPPORT_H */