| //===- llvm/Object/BuildID.h - Build ID -------------------------*- C++ -*-===// |
| // |
| // Part of the LLVM Project, under the Apache License v2.0 with LLVM Exceptions. |
| // See https://llvm.org/LICENSE.txt for license information. |
| // SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception |
| // |
| //===----------------------------------------------------------------------===// |
| /// |
| /// \file |
| /// This file declares a library for handling Build IDs and using them to find |
| /// debug info. |
| /// |
| //===----------------------------------------------------------------------===// |
| |
| #ifndef LLVM_DEBUGINFO_OBJECT_BUILDID_H |
| #define LLVM_DEBUGINFO_OBJECT_BUILDID_H |
| |
| #include "llvm/ADT/ArrayRef.h" |
| #include "llvm/ADT/SmallVector.h" |
| |
| namespace llvm { |
| namespace object { |
| |
| /// A build ID in binary form. |
| typedef SmallVector<uint8_t, 10> BuildID; |
| |
| /// A reference to a BuildID in binary form. |
| typedef ArrayRef<uint8_t> BuildIDRef; |
| |
| class ObjectFile; |
| |
| /// Parses a build ID from a hex string. |
| BuildID parseBuildID(StringRef Str); |
| |
| /// Returns the build ID, if any, contained in the given object file. |
| BuildIDRef getBuildID(const ObjectFile *Obj); |
| |
| /// BuildIDFetcher searches local cache directories for debug info. |
| class BuildIDFetcher { |
| public: |
| BuildIDFetcher(std::vector<std::string> DebugFileDirectories) |
| : DebugFileDirectories(std::move(DebugFileDirectories)) {} |
| virtual ~BuildIDFetcher() = default; |
| |
| /// Returns the path to the debug file with the given build ID. |
| virtual std::optional<std::string> fetch(BuildIDRef BuildID) const; |
| |
| private: |
| const std::vector<std::string> DebugFileDirectories; |
| }; |
| |
| } // namespace object |
| } // namespace llvm |
| |
| #endif // LLVM_DEBUGINFO_OBJECT_BUILDID_H |