Files
llvm-tms34010/llvm/include/llvm/Object/BuildID.h
T
Daniel Thornburgh 9812948d22 [Object] Refactor build ID parsing into Object lib.
This makes parsing for build IDs in the markup filter slightly more
permissive, in line with fromHex.

It also removes the distinction between missing build ID and empty build
ID; empty build IDs aren't a useful concept, since their purpose is to
uniquely identify a binary. This removes a layer of indirection wherever
build IDs are obtained.

Reviewed By: jhenderson

Differential Revision: https://reviews.llvm.org/D147485
2023-04-05 11:25:26 -07:00

56 lines
1.6 KiB
C++

//===- 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