Files
clang-p2996/lldb/source/Plugins/DynamicLoader/Linux-DYLD/AuxVector.h
Stephen Wilson 2103e25e19 Initial support for a DynamicLoader plugin on Linux.
This patch is enough to have shared objects recognized by LLDB.  We can handle
position independent executables.  We can handle dynamically loaded modules
brought in via dlopen.

The DYLDRendezvous class provides an interface to a structure present in the
address space of ELF-based processes.  This structure provides the address of a
function which is called by the linker each time a shared object is loaded and
unloaded (thus a breakpoint at that address will let LLDB intercept such
events), a list of entries describing the currently loaded shared objects, plus
a few other things.

On Linux, processes are brought up with an auxiliary vector on the stack.  One
element in this vector contains the (possibly dynamic) entry address of the
process.  One does not need to walk the stack to find this information as it is
also available under /proc/<pid>/auxv.  The new AuxVector class provides a
convenient read-only view of this auxiliary vector information.  We use the
dynamic entry address and the address as specified in the object file to compute
the actual load address of the inferior image.  This strategy works for both
normal executables and PIE's.

llvm-svn: 123592
2011-01-16 19:45:39 +00:00

98 lines
2.7 KiB
C++

//===-- AuxVector.h ---------------------------------------------*- C++ -*-===//
//
// The LLVM Compiler Infrastructure
//
// This file is distributed under the University of Illinois Open Source
// License. See LICENSE.TXT for details.
//
//===----------------------------------------------------------------------===//
#ifndef liblldb_AuxVector_H_
#define liblldb_AuxVector_H_
// C Includes
// C++ Includes
#include <vector>
// Other libraries and framework includes
#include "lldb/lldb-forward-rtti.h"
namespace lldb_private {
class DataExtractor;
}
/// @class AuxVector
/// @brief Represents a processes auxiliary vector.
///
/// When a process is loaded on Linux a vector of values is placed onto the
/// stack communicating operating system specific information. On construction
/// this class locates and parses this information and provides a simple
/// read-only interface to the entries found.
class AuxVector {
public:
AuxVector(lldb_private::Process *process);
struct Entry {
uint64_t type;
uint64_t value;
Entry() : type(0), value(0) { }
};
/// Constants describing the type of entry.
enum EntryType {
AT_NULL = 0, ///< End of auxv.
AT_IGNORE = 1, ///< Ignore entry.
AT_EXECFD = 2, ///< File descriptor of program.
AT_PHDR = 3, ///< Program headers.
AT_PHENT = 4, ///< Size of program header.
AT_PHNUM = 5, ///< Number of program headers.
AT_PAGESZ = 6, ///< Page size.
AT_BASE = 7, ///< Interpreter base address.
AT_FLAGS = 8, ///< Flags.
AT_ENTRY = 9, ///< Program entry point.
AT_NOTELF = 10, ///< Set if program is not an ELF.
AT_UID = 11, ///< UID.
AT_EUID = 12, ///< Effective UID.
AT_GID = 13, ///< GID.
AT_EGID = 14, ///< Effective GID.
AT_CLKTCK = 17 ///< Clock frequency (e.g. times(2)).
};
private:
typedef std::vector<Entry> EntryVector;
public:
typedef EntryVector::const_iterator iterator;
iterator begin() const { return m_auxv.begin(); }
iterator end() const { return m_auxv.end(); }
iterator
FindEntry(EntryType type) const;
static const char *
GetEntryName(const Entry &entry) {
return GetEntryName(static_cast<EntryType>(entry.type));
}
static const char *
GetEntryName(EntryType type);
void
DumpToLog(lldb::LogSP log) const;
private:
lldb_private::Process *m_process;
EntryVector m_auxv;
lldb::DataBufferSP
GetAuxvData();
void
ParseAuxv(lldb_private::DataExtractor &data);
};
#endif