1 //===- llvm/unittest/Support/Path.cpp - Path tests ------------------------===//
3 // The LLVM Compiler Infrastructure
5 // This file is distributed under the University of Illinois Open Source
6 // License. See LICENSE.TXT for details.
8 //===----------------------------------------------------------------------===//
10 #include "llvm/Support/Path.h"
11 #include "llvm/Support/ErrorHandling.h"
12 #include "llvm/Support/FileSystem.h"
13 #include "llvm/Support/MemoryBuffer.h"
14 #include "llvm/Support/raw_ostream.h"
15 #include "gtest/gtest.h"
22 using namespace llvm::sys;
24 #define ASSERT_NO_ERROR(x) \
25 if (error_code ASSERT_NO_ERROR_ec = x) { \
26 SmallString<128> MessageStorage; \
27 raw_svector_ostream Message(MessageStorage); \
28 Message << #x ": did not return errc::success.\n" \
29 << "error number: " << ASSERT_NO_ERROR_ec.value() << "\n" \
30 << "error message: " << ASSERT_NO_ERROR_ec.message() << "\n"; \
31 GTEST_FATAL_FAILURE_(MessageStorage.c_str()); \
36 TEST(is_separator, Works) {
37 EXPECT_TRUE(path::is_separator('/'));
38 EXPECT_FALSE(path::is_separator('\0'));
39 EXPECT_FALSE(path::is_separator('-'));
40 EXPECT_FALSE(path::is_separator(' '));
43 EXPECT_TRUE(path::is_separator('\\'));
45 EXPECT_FALSE(path::is_separator('\\'));
50 SmallVector<StringRef, 40> paths;
53 paths.push_back("..");
54 paths.push_back("foo");
56 paths.push_back("/foo");
57 paths.push_back("foo/");
58 paths.push_back("/foo/");
59 paths.push_back("foo/bar");
60 paths.push_back("/foo/bar");
61 paths.push_back("//net");
62 paths.push_back("//net/foo");
63 paths.push_back("///foo///");
64 paths.push_back("///foo///bar");
65 paths.push_back("/.");
66 paths.push_back("./");
67 paths.push_back("/..");
68 paths.push_back("../");
69 paths.push_back("foo/.");
70 paths.push_back("foo/..");
71 paths.push_back("foo/./");
72 paths.push_back("foo/./bar");
73 paths.push_back("foo/..");
74 paths.push_back("foo/../");
75 paths.push_back("foo/../bar");
76 paths.push_back("c:");
77 paths.push_back("c:/");
78 paths.push_back("c:foo");
79 paths.push_back("c:/foo");
80 paths.push_back("c:foo/");
81 paths.push_back("c:/foo/");
82 paths.push_back("c:/foo/bar");
83 paths.push_back("prn:");
84 paths.push_back("c:\\");
85 paths.push_back("c:foo");
86 paths.push_back("c:\\foo");
87 paths.push_back("c:foo\\");
88 paths.push_back("c:\\foo\\");
89 paths.push_back("c:\\foo/");
90 paths.push_back("c:/foo\\bar");
92 for (SmallVector<StringRef, 40>::const_iterator i = paths.begin(),
96 for (sys::path::const_iterator ci = sys::path::begin(*i),
97 ce = sys::path::end(*i);
100 ASSERT_FALSE(ci->empty());
103 #if 0 // Valgrind is whining about this.
104 outs() << " Reverse Iteration: [";
105 for (sys::path::reverse_iterator ci = sys::path::rbegin(*i),
106 ce = sys::path::rend(*i);
109 outs() << *ci << ',';
114 path::has_root_path(*i);
116 path::has_root_name(*i);
118 path::has_root_directory(*i);
119 path::root_directory(*i);
120 path::has_parent_path(*i);
121 path::parent_path(*i);
122 path::has_filename(*i);
126 path::has_extension(*i);
128 path::is_absolute(*i);
129 path::is_relative(*i);
131 SmallString<128> temp_store;
133 ASSERT_NO_ERROR(fs::make_absolute(temp_store));
135 path::remove_filename(temp_store);
138 path::replace_extension(temp_store, "ext");
139 StringRef filename(temp_store.begin(), temp_store.size()), stem, ext;
140 stem = path::stem(filename);
141 ext = path::extension(filename);
142 EXPECT_EQ(*(--sys::path::end(filename)), (stem + ext).str());
144 path::native(*i, temp_store);
148 TEST(Support, RelativePathIterator) {
149 SmallString<64> Path(StringRef("c/d/e/foo.txt"));
150 typedef SmallVector<StringRef, 4> PathComponents;
151 PathComponents ExpectedPathComponents;
152 PathComponents ActualPathComponents;
154 StringRef(Path).split(ExpectedPathComponents, "/");
156 for (path::const_iterator I = path::begin(Path), E = path::end(Path); I != E;
158 ActualPathComponents.push_back(*I);
161 ASSERT_EQ(ExpectedPathComponents.size(), ActualPathComponents.size());
163 for (size_t i = 0; i <ExpectedPathComponents.size(); ++i) {
164 EXPECT_EQ(ExpectedPathComponents[i].str(), ActualPathComponents[i].str());
168 TEST(Support, AbsolutePathIterator) {
169 SmallString<64> Path(StringRef("/c/d/e/foo.txt"));
170 typedef SmallVector<StringRef, 4> PathComponents;
171 PathComponents ExpectedPathComponents;
172 PathComponents ActualPathComponents;
174 StringRef(Path).split(ExpectedPathComponents, "/");
176 // The root path will also be a component when iterating
177 ExpectedPathComponents[0] = "/";
179 for (path::const_iterator I = path::begin(Path), E = path::end(Path); I != E;
181 ActualPathComponents.push_back(*I);
184 ASSERT_EQ(ExpectedPathComponents.size(), ActualPathComponents.size());
186 for (size_t i = 0; i <ExpectedPathComponents.size(); ++i) {
187 EXPECT_EQ(ExpectedPathComponents[i].str(), ActualPathComponents[i].str());
192 TEST(Support, AbsolutePathIteratorWin32) {
193 SmallString<64> Path(StringRef("c:\\c\\e\\foo.txt"));
194 typedef SmallVector<StringRef, 4> PathComponents;
195 PathComponents ExpectedPathComponents;
196 PathComponents ActualPathComponents;
198 StringRef(Path).split(ExpectedPathComponents, "\\");
200 // The root path (which comes after the drive name) will also be a component
202 ExpectedPathComponents.insert(ExpectedPathComponents.begin()+1, "\\");
204 for (path::const_iterator I = path::begin(Path), E = path::end(Path); I != E;
206 ActualPathComponents.push_back(*I);
209 ASSERT_EQ(ExpectedPathComponents.size(), ActualPathComponents.size());
211 for (size_t i = 0; i <ExpectedPathComponents.size(); ++i) {
212 EXPECT_EQ(ExpectedPathComponents[i].str(), ActualPathComponents[i].str());
215 #endif // LLVM_ON_WIN32
217 TEST(Support, AbsolutePathIteratorEnd) {
218 // Trailing slashes are converted to '.' unless they are part of the root path.
219 SmallVector<StringRef, 4> Paths;
220 Paths.push_back("/foo/");
221 Paths.push_back("/foo//");
222 Paths.push_back("//net//");
224 Paths.push_back("c:\\\\");
227 for (StringRef Path : Paths) {
228 StringRef LastComponent = *--path::end(Path);
229 EXPECT_EQ(".", LastComponent);
232 SmallVector<StringRef, 3> RootPaths;
233 RootPaths.push_back("/");
234 RootPaths.push_back("//net/");
236 RootPaths.push_back("c:\\");
239 for (StringRef Path : RootPaths) {
240 StringRef LastComponent = *--path::end(Path);
241 EXPECT_EQ(1u, LastComponent.size());
242 EXPECT_TRUE(path::is_separator(LastComponent[0]));
246 TEST(Support, HomeDirectory) {
248 // This test only makes sense on Unix if $HOME is set.
249 if (::getenv("HOME")) {
251 SmallString<128> HomeDir;
252 EXPECT_TRUE(path::home_directory(HomeDir));
253 EXPECT_FALSE(HomeDir.empty());
259 class FileSystemTest : public testing::Test {
261 /// Unique temporary directory in which all created filesystem entities must
262 /// be placed. It is recursively removed at the end of each test.
263 SmallString<128> TestDirectory;
265 virtual void SetUp() {
267 fs::createUniqueDirectory("file-system-test", TestDirectory));
268 // We don't care about this specific file.
269 errs() << "Test Directory: " << TestDirectory << '\n';
273 virtual void TearDown() {
274 ASSERT_NO_ERROR(fs::remove(TestDirectory.str()));
278 TEST_F(FileSystemTest, Unique) {
279 // Create a temp file.
281 SmallString<64> TempPath;
283 fs::createTemporaryFile("prefix", "temp", FileDescriptor, TempPath));
285 // The same file should return an identical unique id.
287 ASSERT_NO_ERROR(fs::getUniqueID(Twine(TempPath), F1));
288 ASSERT_NO_ERROR(fs::getUniqueID(Twine(TempPath), F2));
291 // Different files should return different unique ids.
293 SmallString<64> TempPath2;
295 fs::createTemporaryFile("prefix", "temp", FileDescriptor2, TempPath2));
298 ASSERT_NO_ERROR(fs::getUniqueID(Twine(TempPath2), D));
300 ::close(FileDescriptor2);
302 ASSERT_NO_ERROR(fs::remove(Twine(TempPath2)));
304 // Two paths representing the same file on disk should still provide the
305 // same unique id. We can test this by making a hard link.
306 ASSERT_NO_ERROR(fs::create_link(Twine(TempPath), Twine(TempPath2)));
308 ASSERT_NO_ERROR(fs::getUniqueID(Twine(TempPath2), D2));
311 ::close(FileDescriptor);
313 SmallString<128> Dir1;
315 fs::createUniqueDirectory("dir1", Dir1));
316 ASSERT_NO_ERROR(fs::getUniqueID(Dir1.c_str(), F1));
317 ASSERT_NO_ERROR(fs::getUniqueID(Dir1.c_str(), F2));
320 SmallString<128> Dir2;
322 fs::createUniqueDirectory("dir2", Dir2));
323 ASSERT_NO_ERROR(fs::getUniqueID(Dir2.c_str(), F2));
327 TEST_F(FileSystemTest, TempFiles) {
328 // Create a temp file.
330 SmallString<64> TempPath;
332 fs::createTemporaryFile("prefix", "temp", FileDescriptor, TempPath));
334 // Make sure it exists.
336 ASSERT_NO_ERROR(sys::fs::exists(Twine(TempPath), TempFileExists));
337 EXPECT_TRUE(TempFileExists);
339 // Create another temp tile.
341 SmallString<64> TempPath2;
342 ASSERT_NO_ERROR(fs::createTemporaryFile("prefix", "temp", FD2, TempPath2));
343 ASSERT_TRUE(TempPath2.endswith(".temp"));
344 ASSERT_NE(TempPath.str(), TempPath2.str());
346 fs::file_status A, B;
347 ASSERT_NO_ERROR(fs::status(Twine(TempPath), A));
348 ASSERT_NO_ERROR(fs::status(Twine(TempPath2), B));
349 EXPECT_FALSE(fs::equivalent(A, B));
354 ASSERT_NO_ERROR(fs::remove(Twine(TempPath2)));
355 ASSERT_NO_ERROR(fs::remove(Twine(TempPath2)));
356 ASSERT_EQ(fs::remove(Twine(TempPath2), false),
357 std::errc::no_such_file_or_directory);
359 error_code EC = fs::status(TempPath2.c_str(), B);
360 EXPECT_EQ(EC, std::errc::no_such_file_or_directory);
361 EXPECT_EQ(B.type(), fs::file_type::file_not_found);
363 // Make sure Temp2 doesn't exist.
364 ASSERT_NO_ERROR(fs::exists(Twine(TempPath2), TempFileExists));
365 EXPECT_FALSE(TempFileExists);
367 SmallString<64> TempPath3;
368 ASSERT_NO_ERROR(fs::createTemporaryFile("prefix", "", TempPath3));
369 ASSERT_FALSE(TempPath3.endswith("."));
371 // Create a hard link to Temp1.
372 ASSERT_NO_ERROR(fs::create_link(Twine(TempPath), Twine(TempPath2)));
374 ASSERT_NO_ERROR(fs::equivalent(Twine(TempPath), Twine(TempPath2), equal));
376 ASSERT_NO_ERROR(fs::status(Twine(TempPath), A));
377 ASSERT_NO_ERROR(fs::status(Twine(TempPath2), B));
378 EXPECT_TRUE(fs::equivalent(A, B));
381 ::close(FileDescriptor);
382 ASSERT_NO_ERROR(fs::remove(Twine(TempPath)));
384 // Remove the hard link.
385 ASSERT_NO_ERROR(fs::remove(Twine(TempPath2)));
387 // Make sure Temp1 doesn't exist.
388 ASSERT_NO_ERROR(fs::exists(Twine(TempPath), TempFileExists));
389 EXPECT_FALSE(TempFileExists);
392 // Path name > 260 chars should get an error.
393 const char *Path270 =
394 "abcdefghijklmnopqrstuvwxyz9abcdefghijklmnopqrstuvwxyz8"
395 "abcdefghijklmnopqrstuvwxyz7abcdefghijklmnopqrstuvwxyz6"
396 "abcdefghijklmnopqrstuvwxyz5abcdefghijklmnopqrstuvwxyz4"
397 "abcdefghijklmnopqrstuvwxyz3abcdefghijklmnopqrstuvwxyz2"
398 "abcdefghijklmnopqrstuvwxyz1abcdefghijklmnopqrstuvwxyz0";
399 EXPECT_EQ(fs::createUniqueFile(Twine(Path270), FileDescriptor, TempPath),
400 std::errc::no_such_file_or_directory);
404 TEST_F(FileSystemTest, CreateDir) {
405 ASSERT_NO_ERROR(fs::create_directory(Twine(TestDirectory) + "foo"));
406 ASSERT_NO_ERROR(fs::create_directory(Twine(TestDirectory) + "foo"));
407 ASSERT_EQ(fs::create_directory(Twine(TestDirectory) + "foo", false),
408 std::errc::file_exists);
409 ASSERT_NO_ERROR(fs::remove(Twine(TestDirectory) + "foo"));
412 TEST_F(FileSystemTest, DirectoryIteration) {
414 for (fs::directory_iterator i(".", ec), e; i != e; i.increment(ec))
417 // Create a known hierarchy to recurse over.
419 fs::create_directories(Twine(TestDirectory) + "/recursive/a0/aa1"));
421 fs::create_directories(Twine(TestDirectory) + "/recursive/a0/ab1"));
422 ASSERT_NO_ERROR(fs::create_directories(Twine(TestDirectory) +
423 "/recursive/dontlookhere/da1"));
425 fs::create_directories(Twine(TestDirectory) + "/recursive/z0/za1"));
427 fs::create_directories(Twine(TestDirectory) + "/recursive/pop/p1"));
428 typedef std::vector<std::string> v_t;
430 for (fs::recursive_directory_iterator i(Twine(TestDirectory)
431 + "/recursive", ec), e; i != e; i.increment(ec)){
433 if (path::filename(i->path()) == "p1") {
435 // FIXME: recursive_directory_iterator should be more robust.
438 if (path::filename(i->path()) == "dontlookhere")
440 visited.push_back(path::filename(i->path()));
442 v_t::const_iterator a0 = std::find(visited.begin(), visited.end(), "a0");
443 v_t::const_iterator aa1 = std::find(visited.begin(), visited.end(), "aa1");
444 v_t::const_iterator ab1 = std::find(visited.begin(), visited.end(), "ab1");
445 v_t::const_iterator dontlookhere = std::find(visited.begin(), visited.end(),
447 v_t::const_iterator da1 = std::find(visited.begin(), visited.end(), "da1");
448 v_t::const_iterator z0 = std::find(visited.begin(), visited.end(), "z0");
449 v_t::const_iterator za1 = std::find(visited.begin(), visited.end(), "za1");
450 v_t::const_iterator pop = std::find(visited.begin(), visited.end(), "pop");
451 v_t::const_iterator p1 = std::find(visited.begin(), visited.end(), "p1");
453 // Make sure that each path was visited correctly.
454 ASSERT_NE(a0, visited.end());
455 ASSERT_NE(aa1, visited.end());
456 ASSERT_NE(ab1, visited.end());
457 ASSERT_NE(dontlookhere, visited.end());
458 ASSERT_EQ(da1, visited.end()); // Not visited.
459 ASSERT_NE(z0, visited.end());
460 ASSERT_NE(za1, visited.end());
461 ASSERT_NE(pop, visited.end());
462 ASSERT_EQ(p1, visited.end()); // Not visited.
464 // Make sure that parents were visited before children. No other ordering
465 // guarantees can be made across siblings.
470 ASSERT_NO_ERROR(fs::remove(Twine(TestDirectory) + "/recursive/a0/aa1"));
471 ASSERT_NO_ERROR(fs::remove(Twine(TestDirectory) + "/recursive/a0/ab1"));
472 ASSERT_NO_ERROR(fs::remove(Twine(TestDirectory) + "/recursive/a0"));
474 fs::remove(Twine(TestDirectory) + "/recursive/dontlookhere/da1"));
475 ASSERT_NO_ERROR(fs::remove(Twine(TestDirectory) + "/recursive/dontlookhere"));
476 ASSERT_NO_ERROR(fs::remove(Twine(TestDirectory) + "/recursive/pop/p1"));
477 ASSERT_NO_ERROR(fs::remove(Twine(TestDirectory) + "/recursive/pop"));
478 ASSERT_NO_ERROR(fs::remove(Twine(TestDirectory) + "/recursive/z0/za1"));
479 ASSERT_NO_ERROR(fs::remove(Twine(TestDirectory) + "/recursive/z0"));
480 ASSERT_NO_ERROR(fs::remove(Twine(TestDirectory) + "/recursive"));
483 const char archive[] = "!<arch>\x0A";
484 const char bitcode[] = "\xde\xc0\x17\x0b";
485 const char coff_object[] = "\x00\x00......";
486 const char coff_import_library[] = "\x00\x00\xff\xff....";
487 const char elf_relocatable[] = { 0x7f, 'E', 'L', 'F', 1, 2, 1, 0, 0,
488 0, 0, 0, 0, 0, 0, 0, 0, 1 };
489 const char macho_universal_binary[] = "\xca\xfe\xba\xbe...\0x00";
490 const char macho_object[] = "\xfe\xed\xfa\xce..........\x00\x01";
491 const char macho_executable[] = "\xfe\xed\xfa\xce..........\x00\x02";
492 const char macho_fixed_virtual_memory_shared_lib[] =
493 "\xfe\xed\xfa\xce..........\x00\x03";
494 const char macho_core[] = "\xfe\xed\xfa\xce..........\x00\x04";
495 const char macho_preload_executable[] = "\xfe\xed\xfa\xce..........\x00\x05";
496 const char macho_dynamically_linked_shared_lib[] =
497 "\xfe\xed\xfa\xce..........\x00\x06";
498 const char macho_dynamic_linker[] = "\xfe\xed\xfa\xce..........\x00\x07";
499 const char macho_bundle[] = "\xfe\xed\xfa\xce..........\x00\x08";
500 const char macho_dsym_companion[] = "\xfe\xed\xfa\xce..........\x00\x0a";
501 const char windows_resource[] = "\x00\x00\x00\x00\x020\x00\x00\x00\xff";
503 TEST_F(FileSystemTest, Magic) {
505 const char *filename;
506 const char *magic_str;
507 size_t magic_str_len;
508 fs::file_magic magic;
510 #define DEFINE(magic) \
511 { #magic, magic, sizeof(magic), fs::file_magic::magic }
515 DEFINE(coff_import_library),
516 DEFINE(elf_relocatable),
517 DEFINE(macho_universal_binary),
518 DEFINE(macho_object),
519 DEFINE(macho_executable),
520 DEFINE(macho_fixed_virtual_memory_shared_lib),
522 DEFINE(macho_preload_executable),
523 DEFINE(macho_dynamically_linked_shared_lib),
524 DEFINE(macho_dynamic_linker),
525 DEFINE(macho_bundle),
526 DEFINE(macho_dsym_companion),
527 DEFINE(windows_resource)
531 // Create some files filled with magic.
532 for (type *i = types, *e = types + (sizeof(types) / sizeof(type)); i != e;
534 SmallString<128> file_pathname(TestDirectory);
535 path::append(file_pathname, i->filename);
537 raw_fd_ostream file(file_pathname.c_str(), ErrMsg, sys::fs::F_None);
538 ASSERT_FALSE(file.has_error());
539 StringRef magic(i->magic_str, i->magic_str_len);
543 ASSERT_NO_ERROR(fs::has_magic(file_pathname.c_str(), magic, res));
545 EXPECT_EQ(i->magic, fs::identify_magic(magic));
546 ASSERT_NO_ERROR(fs::remove(Twine(file_pathname)));
551 TEST_F(FileSystemTest, CarriageReturn) {
552 SmallString<128> FilePathname(TestDirectory);
554 path::append(FilePathname, "test");
557 raw_fd_ostream File(FilePathname.c_str(), ErrMsg, sys::fs::F_Text);
558 EXPECT_EQ(ErrMsg, "");
562 std::unique_ptr<MemoryBuffer> Buf;
563 MemoryBuffer::getFile(FilePathname.c_str(), Buf);
564 EXPECT_EQ(Buf->getBuffer(), "\r\n");
568 raw_fd_ostream File(FilePathname.c_str(), ErrMsg, sys::fs::F_None);
569 EXPECT_EQ(ErrMsg, "");
573 std::unique_ptr<MemoryBuffer> Buf;
574 MemoryBuffer::getFile(FilePathname.c_str(), Buf);
575 EXPECT_EQ(Buf->getBuffer(), "\n");
577 ASSERT_NO_ERROR(fs::remove(Twine(FilePathname)));
581 TEST_F(FileSystemTest, FileMapping) {
582 // Create a temp file.
584 SmallString<64> TempPath;
586 fs::createTemporaryFile("prefix", "temp", FileDescriptor, TempPath));
587 // Map in temp file and add some content
589 StringRef Val("hello there");
591 fs::mapped_file_region mfr(FileDescriptor,
593 fs::mapped_file_region::readwrite,
598 std::copy(Val.begin(), Val.end(), mfr.data());
599 // Explicitly add a 0.
600 mfr.data()[Val.size()] = 0;
604 // Map it back in read-only
605 fs::mapped_file_region mfr(Twine(TempPath),
606 fs::mapped_file_region::readonly,
613 EXPECT_EQ(StringRef(mfr.const_data()), Val);
617 fs::mapped_file_region m(Twine(TempPath),
618 fs::mapped_file_region::readonly,
623 const char *Data = m.const_data();
624 fs::mapped_file_region mfrrv(std::move(m));
625 EXPECT_EQ(mfrrv.const_data(), Data);
628 TEST(Support, NormalizePath) {
629 #if defined(LLVM_ON_WIN32)
630 #define EXPECT_PATH_IS(path__, windows__, not_windows__) \
631 EXPECT_EQ(path__, windows__);
633 #define EXPECT_PATH_IS(path__, windows__, not_windows__) \
634 EXPECT_EQ(path__, not_windows__);
637 SmallString<64> Path1("a");
638 SmallString<64> Path2("a/b");
639 SmallString<64> Path3("a\\b");
640 SmallString<64> Path4("a\\\\b");
641 SmallString<64> Path5("\\a");
642 SmallString<64> Path6("a\\");
644 ASSERT_NO_ERROR(fs::normalize_separators(Path1));
645 EXPECT_PATH_IS(Path1, "a", "a");
647 ASSERT_NO_ERROR(fs::normalize_separators(Path2));
648 EXPECT_PATH_IS(Path2, "a/b", "a/b");
650 ASSERT_NO_ERROR(fs::normalize_separators(Path3));
651 EXPECT_PATH_IS(Path3, "a\\b", "a/b");
653 ASSERT_NO_ERROR(fs::normalize_separators(Path4));
654 EXPECT_PATH_IS(Path4, "a\\\\b", "a\\\\b");
656 ASSERT_NO_ERROR(fs::normalize_separators(Path5));
657 EXPECT_PATH_IS(Path5, "\\a", "/a");
659 ASSERT_NO_ERROR(fs::normalize_separators(Path6));
660 EXPECT_PATH_IS(Path6, "a\\", "a/");
662 #undef EXPECT_PATH_IS
664 } // anonymous namespace