Fix PathMappingList for relative and empty paths after recent FileSpec normalization changes

[clayborg]

Summary

PathMappingList was broken for relative and empty paths after normalization changes in FileSpec. There were also no tests for PathMappingList so I added those.

Changes include:

• Change PathMappingList::ReverseRemapPath() to take FileSpec objects instead of ConstString. The only client of this was doing work to convert to and from ConstString objects for no reason.
• Normalize all paths prefix and replacements that are added to the PathMappingList vector so they match the paths that have been already normalized in the debug info
• Unify code in the two forms of PathMappingList::RemapPath() so only one contains the actual functionality. Prior to this, there were two versions of this code.
• Use FileSpec::AppendPathComponent() and remove a long standing TODO so paths are correctly appended to each other.
• Correctly handle the case where someone maps "" to something else. This allows all paths to be prefixed with the replacement.
• Added tests for absolute, relative and empty paths.

[zturner]

source/Target/PathMappingList.cpp

76

Slightly more idiomatic to say emplace_back(NormalizePath(path), NormalizePath(replacement));

177

I don't think the std::move is necessary here. Since the result of GetPath() is already a temporary (rvalue), the move assignment operator will already be invoked even without std::move.

185

llvm::StringRef path_ref(path); should be fine, no need to explicitly specify the pointer and size.

186–187

How about llvm::StringRef second = it.second.GetStringRef();

187

Can you invert this conditional and continue; if it's false?

187

It looks like after this check, the first second.size() characters of path_ref are ignored. So it sounds like you can write this as:

if (!path_ref.consume_front(second))
  continue;

Then further down you can delete the line that calls substr.

188

llvm::StringRef first = it.first.GetStringRef();

[clayborg]

Fix issues found by Zach.

[clayborg]

Marked things as done.

[labath]

Although it may not seem that way from the number of comments, the change looks good to me. The main thing is the moving of the test file, as that will fail in the cmake build. And it also looks like some code can be simplified if my assumption about not converting "" to "." is true.

Thank you for adding the test for this class.

source/Target/PathMappingList.cpp

44

s/GetCString/GetStringRef

101

s/insert/emplace

161

SetString(remapped)

191–194

Is this really true? Judging by the test you've had to remove in r332633, we shouldn't end up converting "" to ".".

unittests/Utility/PathMappingListTest.cpp

1

This file should go to unittests/Target/PathMappingListTest.cpp to match where the class-under-test lives. (Also, please update the name in the header.)

39

s/GetCString/GetStringRef (whole file)

42

It's better to use EXPECT_EQ(expected, actual) for equality comparison, as that will print out a more useful error message when things fail.

86

How does this work for relative paths? I take it foo.c should be remapped to /new/foo.c ? Can you add a test for that?

[clayborg]

I will make the fixes and also test out mapping "" to "." as suggested.

source/Target/PathMappingList.cpp

194

When I thought about it, I chose to not convert to "." for path remapping. I think people would expect if the remap "" to "/prefix" that "/prefix" would be prepended to each path no matter what it is. Of course users could just specify "/" if they wish for a prefix. I could see this going either way. Let me know what you think.

unittests/Utility/PathMappingListTest.cpp

86

It doesn't work. If "foo.c" would map to "/new/foo.c", we can unmap it correctly since it would unmap to "/foo.c". Both "foo.c" and "/foo.c" would map to to "/new/foo.c" and then we can only unmap the latter correctly.

This might bode well for saying that "" should map to "." actually. Then we won't run into this situation. I will test things out with "" mapping to "." and see how things go.

[clayborg]

• Fixed Pavel's issues
• If user specifies "" as the first directory in PathMappingList, it will match "."
• User can specify "/" as the first directory to remap all absolute paths
• Fixed FileSpec::IsAbsolute() and added tests for issues I discovered when adding tests for relative paths in PathMappingListTests
• Modified tests in PathMappingListTests to use a help function which simplifies code
• Added more tests to things that shouldn't get remapped

[labath]

looks good. I don't know if anyone else has an opinion on how should we treat "" for mapping purposes, but treating it as "." seems fine to me.

unittests/Utility/FileSpecTest.cpp

300 ↗

(On Diff #147587)

In tests like these, it's good to add something like SCOPED_TRACE(path) or similar. That way, when a test fails you will see which path caused the failure instead of just a generic "spec.IsRelative() is true" message.

include/lldb/Target/PathMappingList.h

public:
   ///
   /// @return
   ///     /b true if \a path was successfully located and \a new_path
   ///     is filled in with a new source path, \b false otherwise.
   //------------------------------------------------------------------
   bool RemapPath(llvm::StringRef path, std::string &new_path) const;
   bool RemapPath(const char *, std::string &) const = delete;
 
-  bool ReverseRemapPath(const ConstString &path, ConstString &new_path) const;
+  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

lldb.xcodeproj/project.pbxproj

/* Begin PBXBuildFile section */
     26474CC918D0CB5B0073DEBA /* RegisterContextMemory.cpp in Sources */ = {isa = PBXBuildFile; fileRef = 26474CC218D0CB5B0073DEBA /* RegisterContextMemory.cpp */; };
     26474CCB18D0CB5B0073DEBA /* RegisterContextPOSIX_mips64.cpp in Sources */ = {isa = PBXBuildFile; fileRef = 26474CC418D0CB5B0073DEBA /* RegisterContextPOSIX_mips64.cpp */; };
     26474CCD18D0CB5B0073DEBA /* RegisterContextPOSIX_x86.cpp in Sources */ = {isa = PBXBuildFile; fileRef = 26474CC618D0CB5B0073DEBA /* RegisterContextPOSIX_x86.cpp */; };
     26491E3E15E1DB9F00CBFFC2 /* OptionValueRegex.cpp in Sources */ = {isa = PBXBuildFile; fileRef = 26491E3D15E1DB9F00CBFFC2 /* OptionValueRegex.cpp */; };
     264A12FC1372522000875C42 /* EmulateInstructionARM64.cpp in Sources */ = {isa = PBXBuildFile; fileRef = 264A12FA1372522000875C42 /* EmulateInstructionARM64.cpp */; };
     264A58EE1A7DBCAD00A6B1B0 /* OptionValueFormatEntity.cpp in Sources */ = {isa = PBXBuildFile; fileRef = 264A58ED1A7DBCAD00A6B1B0 /* OptionValueFormatEntity.cpp */; };
     264A97BF133918BC0017F0BE /* PlatformRemoteGDBServer.cpp in Sources */ = {isa = PBXBuildFile; fileRef = 264A97BD133918BC0017F0BE /* PlatformRemoteGDBServer.cpp */; };
     264D8D5013661BD7003A368F /* UnwindAssembly.cpp in Sources */ = {isa = PBXBuildFile; fileRef = 264D8D4F13661BD7003A368F /* UnwindAssembly.cpp */; };
+    264FA56720A608F900134FA2 /* PathMappingListTest.cpp in Sources */ = {isa = PBXBuildFile; fileRef = 264FA56620A608F900134FA2 /* PathMappingListTest.cpp */; };
     265192C61BA8E905002F08F6 /* CompilerDecl.cpp in Sources */ = {isa = PBXBuildFile; fileRef = 265192C51BA8E905002F08F6 /* CompilerDecl.cpp */; };
     265205A813D3E3F700132FE2 /* RegisterContextKDP_arm.cpp in Sources */ = {isa = PBXBuildFile; fileRef = 265205A213D3E3F700132FE2 /* RegisterContextKDP_arm.cpp */; };
     265205AA13D3E3F700132FE2 /* RegisterContextKDP_i386.cpp in Sources */ = {isa = PBXBuildFile; fileRef = 265205A413D3E3F700132FE2 /* RegisterContextKDP_i386.cpp */; };
     265205AC13D3E3F700132FE2 /* RegisterContextKDP_x86_64.cpp in Sources */ = {isa = PBXBuildFile; fileRef = 265205A613D3E3F700132FE2 /* RegisterContextKDP_x86_64.cpp */; };
     2654A6801E54D59400DA1013 /* ModuleCache.cpp in Sources */ = {isa = PBXBuildFile; fileRef = 2654A67F1E54D59400DA1013 /* ModuleCache.cpp */; };
     2654A6831E54D5E200DA1013 /* RegisterNumber.cpp in Sources */ = {isa = PBXBuildFile; fileRef = 2654A6821E54D5E200DA1013 /* RegisterNumber.cpp */; };
     2654A68D1E552D1500DA1013 /* PseudoTerminal.cpp in Sources */ = {isa = PBXBuildFile; fileRef = 2654A68C1E552D1500DA1013 /* PseudoTerminal.cpp */; };
     2654A6901E552ED500DA1013 /* VASprintf.cpp in Sources */ = {isa = PBXBuildFile; fileRef = 2654A68F1E552ED500DA1013 /* VASprintf.cpp */; };
/* Begin PBXFileReference section */
     264A58EB1A7DBC8C00A6B1B0 /* OptionValueFormatEntity.h */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.h; name = OptionValueFormatEntity.h; path = include/lldb/Interpreter/OptionValueFormatEntity.h; sourceTree = "<group>"; };
     264A58ED1A7DBCAD00A6B1B0 /* OptionValueFormatEntity.cpp */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.cpp.cpp; name = OptionValueFormatEntity.cpp; path = source/Interpreter/OptionValueFormatEntity.cpp; sourceTree = "<group>"; };
     264A97BD133918BC0017F0BE /* PlatformRemoteGDBServer.cpp */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.cpp.cpp; name = PlatformRemoteGDBServer.cpp; path = "gdb-server/PlatformRemoteGDBServer.cpp"; sourceTree = "<group>"; };
     264A97BE133918BC0017F0BE /* PlatformRemoteGDBServer.h */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.h; name = PlatformRemoteGDBServer.h; path = "gdb-server/PlatformRemoteGDBServer.h"; sourceTree = "<group>"; };
     264AD83711095BA600E0B039 /* CommandObjectLog.cpp */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.cpp.cpp; name = CommandObjectLog.cpp; path = source/Commands/CommandObjectLog.cpp; sourceTree = "<group>"; };
     264AD83911095BBD00E0B039 /* CommandObjectLog.h */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.h; name = CommandObjectLog.h; path = source/Commands/CommandObjectLog.h; sourceTree = "<group>"; };
     264D8D4E13661BCC003A368F /* UnwindAssembly.h */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.c.h; name = UnwindAssembly.h; path = include/lldb/Target/UnwindAssembly.h; sourceTree = "<group>"; };
     264D8D4F13661BD7003A368F /* UnwindAssembly.cpp */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.cpp.cpp; name = UnwindAssembly.cpp; path = source/Target/UnwindAssembly.cpp; sourceTree = "<group>"; };
+    264FA56620A608F900134FA2 /* PathMappingListTest.cpp */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.cpp.cpp; path = PathMappingListTest.cpp; sourceTree = "<group>"; };
     265192C41BA8E8F8002F08F6 /* CompilerDecl.h */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.c.h; name = CompilerDecl.h; path = include/lldb/Symbol/CompilerDecl.h; sourceTree = "<group>"; };
     265192C51BA8E905002F08F6 /* CompilerDecl.cpp */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.cpp.cpp; name = CompilerDecl.cpp; path = source/Symbol/CompilerDecl.cpp; sourceTree = "<group>"; };
     265205A213D3E3F700132FE2 /* RegisterContextKDP_arm.cpp */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.cpp.cpp; path = RegisterContextKDP_arm.cpp; sourceTree = "<group>"; };
     265205A313D3E3F700132FE2 /* RegisterContextKDP_arm.h */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.h; path = RegisterContextKDP_arm.h; sourceTree = "<group>"; };
     265205A413D3E3F700132FE2 /* RegisterContextKDP_i386.cpp */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.cpp.cpp; path = RegisterContextKDP_i386.cpp; sourceTree = "<group>"; };
     265205A513D3E3F700132FE2 /* RegisterContextKDP_i386.h */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.h; path = RegisterContextKDP_i386.h; sourceTree = "<group>"; };
     265205A613D3E3F700132FE2 /* RegisterContextKDP_x86_64.cpp */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.cpp.cpp; path = RegisterContextKDP_x86_64.cpp; sourceTree = "<group>"; };
     265205A713D3E3F700132FE2 /* RegisterContextKDP_x86_64.h */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.h; path = RegisterContextKDP_x86_64.h; sourceTree = "<group>"; };
/* Begin PBXGroup section */
     2321F9421BDD343A00BA9A93 /* Utility */ = {
       isa = PBXGroup;
       children = (
         7F94D7172040A13A006EE3EA /* CleanUpTest.cpp */,
         23E2E5161D903689006F38BB /* ArchSpecTest.cpp */,
         9A3D43C81F3150D200EB767C /* ConstStringTest.cpp */,
         23CB14FD1D66CD2400EDDDE1 /* FileSpecTest.cpp */,
         9A3D43C71F3150D200EB767C /* LogTest.cpp */,
+        264FA56620A608F900134FA2 /* PathMappingListTest.cpp */,
         9A3D43CB1F3150D200EB767C /* NameMatchesTest.cpp */,
         9A3D43C61F3150D200EB767C /* StatusTest.cpp */,
         9A3D43CA1F3150D200EB767C /* StructuredDataTest.cpp */,
         9A3D43C91F3150D200EB767C /* TildeExpressionResolverTest.cpp */,
         9A3D43CC1F3150D200EB767C /* TimeoutTest.cpp */,
         9A3D43C51F3150D200EB767C /* TimerTest.cpp */,
         9A3D43C41F3150D200EB767C /* VASprintfTest.cpp */,
         2321F9431BDD346100BA9A93 /* CMakeLists.txt */,
23CB15321D66DA9300EDDDE1 /* Sources */ = {
       buildActionMask = 2147483647;
       files = (
         9A3D43D91F3151C400EB767C /* StatusTest.cpp in Sources */,
         23CB15331D66DA9300EDDDE1 /* GoParserTest.cpp in Sources */,
         9A2057281F3B8DDB00F6C293 /* TestELFHeader.cpp in Sources */,
         23CB15341D66DA9300EDDDE1 /* CPlusPlusLanguageTest.cpp in Sources */,
         9A2057381F3B8E7E00F6C293 /* FileSystemTest.cpp in Sources */,
         9A2057201F3B8D2500F6C293 /* UnixSignalsTest.cpp in Sources */,
+        264FA56720A608F900134FA2 /* PathMappingListTest.cpp in Sources */,
         AFAFD80A1E57E1B90017A14F /* ModuleCacheTest.cpp in Sources */,
         9A3D43DA1F3151C400EB767C /* StructuredDataTest.cpp in Sources */,
         9A2057121F3B824B00F6C293 /* SymbolFileDWARFTests.cpp in Sources */,
         9A20573A1F3B8E7E00F6C293 /* MainLoopTest.cpp in Sources */,
         23CB15351D66DA9300EDDDE1 /* UriParserTest.cpp in Sources */,
         8C3BD9A01EF5D1FF0016C343 /* JSONTest.cpp in Sources */,
         23CB15361D66DA9300EDDDE1 /* FileSpecTest.cpp in Sources */,
         23E2E5251D90373D006F38BB /* ArchSpecTest.cpp in Sources */,

source/Target/PathMappingList.cpp

 //===-- PathMappingList.cpp -------------------------------------*- C++ -*-===//
 //
 //                     The LLVM Compiler Infrastructure
 //
 // This file is distributed under the University of Illinois Open Source
 // License. See LICENSE.TXT for details.
 //
 //===----------------------------------------------------------------------===//
 
 // C Includes
 // C++ Includes
 #include <climits>
 #include <cstring>
 
 // Other libraries and framework includes
 // Project includes
+#include "lldb/lldb-private-enumerations.h"
 #include "lldb/Host/PosixApi.h"
 #include "lldb/Target/PathMappingList.h"
 #include "lldb/Utility/FileSpec.h"
 #include "lldb/Utility/Status.h"
 #include "lldb/Utility/Stream.h"
 
 using namespace lldb;
 using namespace lldb_private;
 
+namespace {
+  // We must normalize our path pairs that we store because if we don't then
+  // things won't always work. We found a case where if we did:
+  // (lldb) settings set target.source-map . /tmp
+  // We would store a path pairs of "." and "/tmp" as raw strings. If the debug
+  // info contains "./foo/bar.c", the path will get normalized to "foo/bar.c".
+  // When PathMappingList::RemapPath() is called, it expects the path to start
+  // with the raw path pair, which doesn't work anymore because the paths have
+  // been normalized when the debug info was loaded. So we need to store
+  // nomalized path pairs to ensure things match up.
+  ConstString NormalizePath(const ConstString &path) {
+    // Don't change nothing into ".", nothing will remap all files to the
+    // other path
+    if (!path)
+      return path;
+    // If we use "path" to construct a FileSpec, it will normalize the path for
+    // us. We then grab the string and turn it back into a ConstString.
+    return ConstString(FileSpec(path.GetCString(), false).GetPath());
+  }
+}
 //----------------------------------------------------------------------
 // PathMappingList constructor
 //----------------------------------------------------------------------
 PathMappingList::PathMappingList()
     : m_pairs(), m_callback(nullptr), m_callback_baton(nullptr), m_mod_id(0) {}
 
 PathMappingList::PathMappingList(ChangedCallback callback, void *callback_baton)
     : m_pairs(), m_callback(callback), m_callback_baton(callback_baton),
const PathMappingList &PathMappingList::operator=(const PathMappingList &rhs) {
   return *this;
 }
 
 PathMappingList::~PathMappingList() = default;
 
 void PathMappingList::Append(const ConstString &path,
                              const ConstString &replacement, bool notify) {
   ++m_mod_id;
-  m_pairs.push_back(pair(path, replacement));
+  m_pairs.emplace_back(pair(NormalizePath(path), NormalizePath(replacement)));
   if (notify && m_callback)
     m_callback(*this, m_callback_baton);
 }
 
 void PathMappingList::Append(const PathMappingList &rhs, bool notify) {
   ++m_mod_id;
   if (!rhs.m_pairs.empty()) {
     const_iterator pos, end = rhs.m_pairs.end();
     for (pos = rhs.m_pairs.begin(); pos != end; ++pos)
       m_pairs.push_back(*pos);
     if (notify && m_callback)
       m_callback(*this, m_callback_baton);
   }
 }
 
 void PathMappingList::Insert(const ConstString &path,
                              const ConstString &replacement, uint32_t index,
                              bool notify) {
   ++m_mod_id;
   iterator insert_iter;
   if (index >= m_pairs.size())
     insert_iter = m_pairs.end();
   else
     insert_iter = m_pairs.begin() + index;
-  m_pairs.insert(insert_iter, pair(path, replacement));
+  m_pairs.insert(insert_iter, pair(NormalizePath(path),
+                                   NormalizePath(replacement)));
   if (notify && m_callback)
     m_callback(*this, m_callback_baton);
 }
 
 bool PathMappingList::Replace(const ConstString &path,
                               const ConstString &replacement, uint32_t index,
                               bool notify) {
   if (index >= m_pairs.size())
     return false;
   ++m_mod_id;
-  m_pairs[index] = pair(path, replacement);
+  m_pairs[index] = pair(NormalizePath(path), NormalizePath(replacement));
   if (notify && m_callback)
     m_callback(*this, m_callback_baton);
   return true;
 }
 
 bool PathMappingList::Remove(size_t index, bool notify) {
   if (index >= m_pairs.size())
     return false;
if (!m_pairs.empty())
     ++m_mod_id;
   m_pairs.clear();
   if (notify && m_callback)
     m_callback(*this, m_callback_baton);
 }
 
 bool PathMappingList::RemapPath(const ConstString &path,
                                 ConstString &new_path) const {
-  const char *path_cstr = path.GetCString();
-  // CLEANUP: Convert this function to use StringRefs internally instead
-  // of raw c-strings.
-  if (!path_cstr)
-    return false;
-
-  const_iterator pos, end = m_pairs.end();
-  for (pos = m_pairs.begin(); pos != end; ++pos) {
-    const size_t prefixLen = pos->first.GetLength();
-
-    if (::strncmp(pos->first.GetCString(), path_cstr, prefixLen) == 0) {
-      std::string new_path_str(pos->second.GetCString());
-      new_path_str.append(path.GetCString() + prefixLen);
-      new_path.SetCString(new_path_str.c_str());
-      return true;
-    }
-  }
+  std::string remapped;
+  if (RemapPath(path.GetStringRef(), remapped)) {
+    new_path.SetCStringWithLength(remapped.c_str(), remapped.size());
   return false;
 }
 
 bool PathMappingList::RemapPath(llvm::StringRef path,
                                 std::string &new_path) const {
   if (m_pairs.empty() || path.empty())
     return false;
   
-  const_iterator pos, end = m_pairs.end();
-  for (pos = m_pairs.begin(); pos != end; ++pos) {
-    if (!path.consume_front(pos->first.GetStringRef()))
+  for (const auto &it : m_pairs) {
+    if (!path.consume_front(it.first.GetStringRef()))
       continue;
-
-    new_path = pos->second.GetStringRef();
-    new_path.append(path);
+    FileSpec remapped(it.second.GetStringRef(), false);
+    remapped.AppendPathComponent(path);
+    new_path = remapped.GetPath();
     return true;
   }
   return false;
 }
 
-bool PathMappingList::ReverseRemapPath(const ConstString &path,
-                                       ConstString &new_path) const {
-  const char *path_cstr = path.GetCString();
-  if (!path_cstr)
-    return false;
-
+bool PathMappingList::ReverseRemapPath(const FileSpec &file, FileSpec &fixed) const {
+  std::string path = file.GetPath();
+  llvm::StringRef path_ref(path);
   for (const auto &it : m_pairs) {
-    // FIXME: This should be using FileSpec API's to do the path appending.
-    const size_t prefixLen = it.second.GetLength();
-    if (::strncmp(it.second.GetCString(), path_cstr, prefixLen) == 0) {
-      std::string new_path_str(it.first.GetCString());
-      new_path_str.append(path.GetCString() + prefixLen);
-      new_path.SetCString(new_path_str.c_str());
-      return true;
+    if (!path_ref.consume_front(it.second.GetStringRef()))
+      continue;
+    llvm::StringRef first(it.first.GetStringRef());
+    if (first.empty()) {
+      // If our original path was "", then the new path is just the suffix.
+      // If we call fixed.SetFile("", false) we will end up with "." as the
+      // path and any path we appended would end up being relative.
+      fixed.SetFile(path_ref, false);
+    } else {
+      fixed.SetFile(first, false);
+      fixed.AppendPathComponent(path_ref);
     }
+    return true;
   }
   return false;
 }
 
 bool PathMappingList::FindFile(const FileSpec &orig_spec,
                                FileSpec &new_spec) const {
   if (!m_pairs.empty()) {
     char orig_path[PATH_MAX];
bool PathMappingList::GetPathsAtIndex(uint32_t idx, ConstString &path,
   if (idx < m_pairs.size()) {
     path = m_pairs[idx].first;
     new_path = m_pairs[idx].second;
     return true;
   }
   return false;
 }
 
-uint32_t PathMappingList::FindIndexForPath(const ConstString &path) const {
+uint32_t PathMappingList::FindIndexForPath(const ConstString &orig_path) const {
+  const ConstString path = NormalizePath(orig_path);
   const_iterator pos;
   const_iterator begin = m_pairs.begin();
   const_iterator end = m_pairs.end();
 
   for (pos = begin; pos != end; ++pos) {
     if (pos->first == path)
       return std::distance(begin, pos);
   }
   return UINT32_MAX;
 }

source/Target/Target.cpp

 BreakpointSP Target::CreateBreakpoint(const FileSpecList *containingModules,
                                       const FileSpec &file, uint32_t line_no,
                                       lldb::addr_t offset,
                                       LazyBool check_inlines,
                                       LazyBool skip_prologue, bool internal,
                                       bool hardware,
                                       LazyBool move_to_nearest_code) {
   FileSpec remapped_file;
-  ConstString remapped_path;
-  if (GetSourcePathMap().ReverseRemapPath(ConstString(file.GetPath().c_str()),
-                                          remapped_path))
-    remapped_file.SetFile(remapped_path.AsCString(), false);
-  else
+  if (!GetSourcePathMap().ReverseRemapPath(file, remapped_file))
     remapped_file = file;
 
   if (check_inlines == eLazyBoolCalculate) {
     const InlineStrategy inline_strategy = GetInlineStrategy();
     switch (inline_strategy) {
     case eInlineBreakpointsNever:
       check_inlines = eLazyBoolNo;
       break;

unittests/Utility/CMakeLists.txt

 add_lldb_unittest(UtilityTests
   ArgsTest.cpp
   ArchSpecTest.cpp
   CleanUpTest.cpp
   ConstStringTest.cpp
   EnvironmentTest.cpp
   FileSpecTest.cpp
   JSONTest.cpp
   LogTest.cpp
   NameMatchesTest.cpp
+  PathMappingListTest.cpp
   StatusTest.cpp
   StringExtractorTest.cpp
   StructuredDataTest.cpp
   TildeExpressionResolverTest.cpp
   TimeoutTest.cpp
   TimerTest.cpp
   UriParserTest.cpp
   VASprintfTest.cpp

unittests/Utility/PathMappingListTest.cpp

+//===-- NameMatchesTest.cpp -------------------------------------*- C++ -*-===//
+//
+//                     The LLVM Compiler Infrastructure
+//
+// This file is distributed under the University of Illinois Open Source
+// License. See LICENSE.TXT for details.
+//
+//===----------------------------------------------------------------------===//
+
+#include "lldb/Target/PathMappingList.h"
+#include "lldb/Utility/FileSpec.h"
+#include "gtest/gtest.h"
+#include <utility>
+
+using namespace lldb_private;
+
+namespace {
+  struct Matches {
+    ConstString original;
+    ConstString remapped;
+    Matches(const char *o, const char *r) : original(o),
+        remapped(r) {}
+  };
+}
+
+TEST(PathMappingListTest, RelativeTests) {
+  PathMappingList map;
+  map.Append(ConstString("."), ConstString("/tmp"), false);
+  Matches tests[] = {
+    {".", "/tmp"},
+    {"./", "/tmp"},
+    {"./////", "/tmp"},
+    {"./foo.c", "/tmp/foo.c"},
+    {"./bar/foo.c", "/tmp/bar/foo.c"}
+  };
+  ConstString actual_remapped;
+  EXPECT_FALSE(map.RemapPath(ConstString("/foo"), actual_remapped));
+  for (const auto &m: tests) {
+    FileSpec orig_spec(m.original.GetCString(), false);
+    std::string orig_normalized = orig_spec.GetPath();
+    EXPECT_TRUE(map.RemapPath(m.original, actual_remapped));
+    EXPECT_TRUE(actual_remapped == m.remapped);
+    FileSpec remapped_spec(m.remapped.GetCString(), false);
+    FileSpec unmapped_spec;
+    EXPECT_TRUE(map.ReverseRemapPath(remapped_spec, unmapped_spec));
+    std::string unmapped_path = unmapped_spec.GetPath();
+    EXPECT_TRUE(unmapped_path == orig_normalized);
+  }
+}
+
+TEST(PathMappingListTest, AbsoluteTests) {
+  PathMappingList map;
+  map.Append(ConstString("/old"), ConstString("/new"), false);
+  Matches tests[] = {
+    {"/old", "/new"},
+    {"/old/", "/new"},
+    {"/old/foo/.", "/new/foo"},
+    {"/old/foo.c", "/new/foo.c"},
+    {"/old/foo.c/.", "/new/foo.c"},
+    {"/old/./foo.c", "/new/foo.c"},
+  };
+  ConstString actual_remapped;
+  // Make sure that the path
+  for (const auto &m: tests) {
+    FileSpec orig_spec(m.original.GetCString(), false);
+    std::string orig_normalized = orig_spec.GetPath();
+    EXPECT_TRUE(map.RemapPath(m.original, actual_remapped));
+    EXPECT_TRUE(actual_remapped == m.remapped);
+    FileSpec remapped_spec(m.remapped.GetCString(), false);
+    FileSpec unmapped_spec;
+    EXPECT_TRUE(map.ReverseRemapPath(remapped_spec, unmapped_spec));
+    std::string unmapped_path = unmapped_spec.GetPath();
+    EXPECT_TRUE(unmapped_path == orig_normalized);
+  }
+}
+
+TEST(PathMappingListTest, RemapEverything) {
+  PathMappingList map;
+  map.Append(ConstString(""), ConstString("/new"), false);
+  Matches tests[] = {
+    {"/old", "/new/old"},
+    {"/old/", "/new/old"},
+    {"/old/foo/.", "/new/old/foo"},
+    {"/old/foo.c", "/new/old/foo.c"},
+    {"/old/foo.c/.", "/new/old/foo.c"},
+    {"/old/./foo.c", "/new/old/foo.c"},
+  };
+  ConstString actual_remapped;
+  // Make sure that the path
+  for (const auto &m: tests) {
+    FileSpec orig_spec(m.original.GetCString(), false);
+    std::string orig_normalized = orig_spec.GetPath();
+    EXPECT_TRUE(map.RemapPath(m.original, actual_remapped));
+    EXPECT_TRUE(actual_remapped == m.remapped);
+    FileSpec remapped_spec(m.remapped.GetCString(), false);
+    FileSpec unmapped_spec;
+    EXPECT_TRUE(map.ReverseRemapPath(remapped_spec, unmapped_spec));
+    std::string unmapped_path = unmapped_spec.GetPath();
+    EXPECT_TRUE(unmapped_path == orig_normalized);
+  }
+}