mirror of
https://github.com/c64scene-ar/llvm-6502.git
synced 2024-09-30 04:56:49 +00:00
31e081ed96
The goal of this tool is to replicate Darwin's dsymutil functionality based on LLVM. dsymutil is a DWARF linker. Darwin's linker (ld64) does not link the debug information, it leaves it in the object files in relocatable form, but embbeds a `debug map` into the executable that describes where to find the debug information and how to relocate it. When releasing/archiving a binary, dsymutil is called to link all the DWARF information into a `dsym bundle` that can distributed/stored along with the binary. With this commit, the LLVM based dsymutil is just able to parse the STABS debug maps embedded by ld64 in linked binaries (and not all of them, for example archives aren't supported yet). Note that the tool directory is called dsymutil, but the executable is currently called llvm-dsymutil. This discrepancy will disappear once the tool will be feature complete. At this point the executable will be renamed to dsymutil, but until then you do not want it to override the system one. Differential Revision: http://reviews.llvm.org/D6242 git-svn-id: https://llvm.org/svn/llvm-project/llvm/trunk@224134 91177308-0d34-0410-b5e6-96231b3b80d8
38 lines
1.2 KiB
C++
38 lines
1.2 KiB
C++
//===- tools/dsymutil/dsymutil.h - dsymutil high-level functionality ------===//
|
|
//
|
|
// The LLVM Linker
|
|
//
|
|
// This file is distributed under the University of Illinois Open Source
|
|
// License. See LICENSE.TXT for details.
|
|
//
|
|
//===----------------------------------------------------------------------===//
|
|
///
|
|
/// \file
|
|
///
|
|
/// This file contains the class declaration for the code that parses STABS
|
|
/// debug maps that are embedded in the binaries symbol tables.
|
|
///
|
|
//===----------------------------------------------------------------------===//
|
|
#ifndef LLVM_TOOLS_DSYMUTIL_DSYMUTIL_H
|
|
#define LLVM_TOOLS_DSYMUTIL_DSYMUTIL_H
|
|
|
|
#include "DebugMap.h"
|
|
#include "llvm/ADT/StringRef.h"
|
|
#include "llvm/Support/ErrorOr.h"
|
|
#include <memory>
|
|
|
|
namespace llvm {
|
|
namespace dsymutil {
|
|
/// \brief Extract the DebugMap from the given file.
|
|
/// The file has to be a MachO object file.
|
|
llvm::ErrorOr<std::unique_ptr<DebugMap>>
|
|
parseDebugMap(StringRef InputFile, StringRef PrependPath = "");
|
|
|
|
/// \brief Link the Dwarf debuginfo as directed by the passed DebugMap
|
|
/// \p DM into a DwarfFile named \p OutputFilename.
|
|
/// \returns false if the link failed.
|
|
bool linkDwarf(StringRef OutputFilename, const DebugMap &DM);
|
|
}
|
|
}
|
|
#endif // LLVM_TOOLS_DSYMUTIL_DSYMUTIL_H
|