1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
|
//===-- PathMappingList.h ---------------------------------------*- 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
//
//===----------------------------------------------------------------------===//
#ifndef LLDB_TARGET_PATHMAPPINGLIST_H
#define LLDB_TARGET_PATHMAPPINGLIST_H
#include <map>
#include <vector>
#include "lldb/Utility/ConstString.h"
#include "lldb/Utility/Status.h"
namespace lldb_private {
class PathMappingList {
public:
typedef void (*ChangedCallback)(const PathMappingList &path_list,
void *baton);
// Constructors and Destructors
PathMappingList();
PathMappingList(ChangedCallback callback, void *callback_baton);
PathMappingList(const PathMappingList &rhs);
~PathMappingList();
const PathMappingList &operator=(const PathMappingList &rhs);
void Append(ConstString path, ConstString replacement,
bool notify);
void Append(const PathMappingList &rhs, bool notify);
void Clear(bool notify);
// By default, dump all pairs.
void Dump(Stream *s, int pair_index = -1);
bool IsEmpty() const { return m_pairs.empty(); }
size_t GetSize() const { return m_pairs.size(); }
bool GetPathsAtIndex(uint32_t idx, ConstString &path,
ConstString &new_path) const;
void Insert(ConstString path, ConstString replacement,
uint32_t insert_idx, bool notify);
bool Remove(size_t index, bool notify);
bool Remove(ConstString path, bool notify);
bool Replace(ConstString path, ConstString replacement,
bool notify);
bool Replace(ConstString path, ConstString replacement,
uint32_t index, bool notify);
bool RemapPath(ConstString path, ConstString &new_path) const;
/// Remaps a source file given \a path into \a new_path.
///
/// Remaps \a path if any source remappings match. This function
/// does NOT stat the file system so it can be used in tight loops
/// where debug info is being parsed.
///
/// \param[in] path
/// The original source file path to try and remap.
///
/// \param[in] only_if_exists
/// If \b true, besides matching \p path with the remapping rules, this
/// tries to check with the filesystem that the remapped file exists. If
/// no valid file is found, \b None is returned. This might be expensive,
/// specially on a network.
///
/// If \b false, then the existence of the returned remapping is not
/// checked.
///
/// \return
/// The remapped filespec that may or may not exist on disk.
llvm::Optional<FileSpec> RemapPath(llvm::StringRef path,
bool only_if_exists = false) const;
bool RemapPath(const char *, std::string &) const = delete;
bool ReverseRemapPath(const FileSpec &file, FileSpec &fixed) const;
/// Finds a source file given a file spec using the path remappings.
///
/// Tries to resolve \a orig_spec by checking the path remappings.
/// It makes sure the file exists by checking with the file system,
/// so this call can be expensive if the remappings are on a network
/// or are even on the local file system, so use this function
/// sparingly (not in a tight debug info parsing loop).
///
/// \param[in] orig_spec
/// The original source file path to try and remap.
///
/// \return
/// The newly remapped filespec that is guaranteed to exist.
llvm::Optional<FileSpec> FindFile(const FileSpec &orig_spec) const;
uint32_t FindIndexForPath(ConstString path) const;
uint32_t GetModificationID() const { return m_mod_id; }
protected:
typedef std::pair<ConstString, ConstString> pair;
typedef std::vector<pair> collection;
typedef collection::iterator iterator;
typedef collection::const_iterator const_iterator;
iterator FindIteratorForPath(ConstString path);
const_iterator FindIteratorForPath(ConstString path) const;
collection m_pairs;
ChangedCallback m_callback = nullptr;
void *m_callback_baton = nullptr;
uint32_t m_mod_id = 0; // Incremented anytime anything is added or removed.
};
} // namespace lldb_private
#endif // LLDB_TARGET_PATHMAPPINGLIST_H
|
