tools/dsymutil/dsymutil.h

   1 //===- tools/dsymutil/dsymutil.h - dsymutil high-level functionality ------===//
   2 //
   3 //                             The LLVM Linker
   4 //
   5 // This file is distributed under the University of Illinois Open Source
   6 // License. See LICENSE.TXT for details.
   7 //
   8 //===----------------------------------------------------------------------===//
   9 ///
  10 /// \file
  11 ///
  12 /// This file contains the class declaration for the code that parses STABS
  13 /// debug maps that are embedded in the binaries symbol tables.
  14 ///
  15 //===----------------------------------------------------------------------===//
  16 #ifndef LLVM_TOOLS_DSYMUTIL_DSYMUTIL_H
  17 #define LLVM_TOOLS_DSYMUTIL_DSYMUTIL_H
  18
  19 #include "DebugMap.h"
  20 #include "llvm/ADT/StringRef.h"
  21 #include "llvm/Support/ErrorOr.h"
  22 #include <memory>
  23
  24 namespace llvm {
  25 namespace dsymutil {
  26
  27 struct LinkOptions {
  28   bool Verbose;  ///< Verbosity
  29   bool NoOutput; ///< Skip emitting output
  30   bool NoODR;    ///< Do not unique types according to ODR
  31   std::string PrependPath; //< -oso-prepend-path
  32
  33   LinkOptions() : Verbose(false), NoOutput(false) {}
  34 };
  35
  36 /// \brief Extract the DebugMaps from the given file.
  37 /// The file has to be a MachO object file. Multiple debug maps can be
  38 /// returned when the file is universal (aka fat) binary.
  39 llvm::ErrorOr<std::vector<std::unique_ptr<DebugMap>>>
  40 parseDebugMap(StringRef InputFile, ArrayRef<std::string> Archs,
  41               StringRef PrependPath, bool Verbose, bool InputIsYAML);
  42
  43 /// \brief Dump the symbol table
  44 bool dumpStab(StringRef InputFile, ArrayRef<std::string> Archs,
  45               StringRef PrependPath = "");
  46
  47 /// \brief Link the Dwarf debuginfo as directed by the passed DebugMap
  48 /// \p DM into a DwarfFile named \p OutputFilename.
  49 /// \returns false if the link failed.
  50 bool linkDwarf(StringRef OutputFilename, const DebugMap &DM,
  51                const LinkOptions &Options);
  52
  53 /// \brief Exit the dsymutil process, cleaning up every temporary
  54 /// files that we created.
  55 LLVM_ATTRIBUTE_NORETURN void exitDsymutil(int ExitStatus);
  56
  57 void warn(const Twine &Warning, const Twine &Context);
  58 bool error(const Twine &Error, const Twine &Context);
  59 }
  60 }
  61 #endif // LLVM_TOOLS_DSYMUTIL_DSYMUTIL_H