/Users/buildslave/jenkins/workspace/coverage/llvm-project/lldb/include/lldb/Utility/UUID.h
Line | Count | Source (jump to first uncovered line) |
1 | | //===-- UUID.h --------------------------------------------------*- C++ -*-===// |
2 | | // |
3 | | // Part of the LLVM Project, under the Apache License v2.0 with LLVM Exceptions. |
4 | | // See https://llvm.org/LICENSE.txt for license information. |
5 | | // SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception |
6 | | // |
7 | | //===----------------------------------------------------------------------===// |
8 | | |
9 | | #ifndef LLDB_UTILITY_UUID_H |
10 | | #define LLDB_UTILITY_UUID_H |
11 | | |
12 | | #include "llvm/ADT/ArrayRef.h" |
13 | | #include "llvm/ADT/StringRef.h" |
14 | | #include "llvm/Support/Endian.h" |
15 | | #include <cstddef> |
16 | | #include <cstdint> |
17 | | #include <string> |
18 | | |
19 | | namespace lldb_private { |
20 | | |
21 | | class Stream; |
22 | | |
23 | | class UUID { |
24 | | // Represents UUID's of various sizes. In all cases, a uuid of all zeros is |
25 | | // treated as an "Invalid UUID" marker, and the UUID created from such data |
26 | | // will return false for IsValid. |
27 | | public: |
28 | 3.41M | UUID() = default; |
29 | | |
30 | | /// Creates a uuid from the data pointed to by the bytes argument. |
31 | 2.85M | UUID(llvm::ArrayRef<uint8_t> bytes) : m_bytes(bytes.begin(), bytes.end()) { |
32 | 2.85M | if (llvm::all_of(m_bytes, [](uint8_t b) 2.85M { return b == 0; })) { |
33 | 15 | Clear(); |
34 | 15 | } |
35 | 2.85M | } |
36 | | |
37 | | // Reference: |
38 | | // https://crashpad.chromium.org/doxygen/structcrashpad_1_1CodeViewRecordPDB70.html |
39 | | struct CvRecordPdb70 { |
40 | | struct { |
41 | | llvm::support::ulittle32_t Data1; |
42 | | llvm::support::ulittle16_t Data2; |
43 | | llvm::support::ulittle16_t Data3; |
44 | | uint8_t Data4[8]; |
45 | | } Uuid; |
46 | | llvm::support::ulittle32_t Age; |
47 | | // char PDBFileName[]; |
48 | | }; |
49 | | |
50 | | /// Create a UUID from CvRecordPdb70. |
51 | | UUID(CvRecordPdb70 debug_info); |
52 | | |
53 | | /// Creates a UUID from the data pointed to by the bytes argument. |
54 | 2.73M | UUID(const void *bytes, uint32_t num_bytes) { |
55 | 2.73M | if (!bytes) |
56 | 0 | return; |
57 | 2.73M | *this |
58 | 2.73M | = UUID(llvm::ArrayRef<uint8_t>(reinterpret_cast<const uint8_t *>(bytes), |
59 | 2.73M | num_bytes)); |
60 | 2.73M | } |
61 | | |
62 | 113k | void Clear() { m_bytes.clear(); } |
63 | | |
64 | | void Dump(Stream &s) const; |
65 | | |
66 | 114k | llvm::ArrayRef<uint8_t> GetBytes() const { return m_bytes; } |
67 | | |
68 | 440k | explicit operator bool() const { return IsValid(); } |
69 | 28.2M | bool IsValid() const { return !m_bytes.empty(); } |
70 | | |
71 | | std::string GetAsString(llvm::StringRef separator = "-") const; |
72 | | |
73 | | bool SetFromStringRef(llvm::StringRef str); |
74 | | |
75 | | /// Decode as many UUID bytes as possible from the C string \a cstr. |
76 | | /// |
77 | | /// \param[in] str |
78 | | /// An llvm::StringRef that points at a UUID string value (no leading |
79 | | /// spaces). The string must contain only hex characters and optionally |
80 | | /// can contain the '-' sepearators. |
81 | | /// |
82 | | /// \param[in] uuid_bytes |
83 | | /// A buffer of bytes that will contain a full or partially decoded UUID. |
84 | | /// |
85 | | /// \return |
86 | | /// The original string, with all decoded bytes removed. |
87 | | static llvm::StringRef |
88 | | DecodeUUIDBytesFromString(llvm::StringRef str, |
89 | | llvm::SmallVectorImpl<uint8_t> &uuid_bytes); |
90 | | |
91 | | private: |
92 | | // GNU ld generates 20-byte build-ids. Size chosen to avoid heap allocations |
93 | | // for this case. |
94 | | llvm::SmallVector<uint8_t, 20> m_bytes; |
95 | | |
96 | 19.0M | friend bool operator==(const UUID &LHS, const UUID &RHS) { |
97 | 19.0M | return LHS.m_bytes == RHS.m_bytes; |
98 | 19.0M | } |
99 | 206k | friend bool operator!=(const UUID &LHS, const UUID &RHS) { |
100 | 206k | return !(LHS == RHS); |
101 | 206k | } |
102 | 4 | friend bool operator<(const UUID &LHS, const UUID &RHS) { |
103 | 4 | return LHS.m_bytes < RHS.m_bytes; |
104 | 4 | } |
105 | 0 | friend bool operator<=(const UUID &LHS, const UUID &RHS) { |
106 | 0 | return !(RHS < LHS); |
107 | 0 | } |
108 | | friend bool operator>(const UUID &LHS, const UUID &RHS) { return RHS < LHS; } |
109 | 0 | friend bool operator>=(const UUID &LHS, const UUID &RHS) { |
110 | 0 | return !(LHS < RHS); |
111 | 0 | } |
112 | | }; |
113 | | } // namespace lldb_private |
114 | | |
115 | | #endif // LLDB_UTILITY_UUID_H |