blob: bf1ae44e0d0170a7856204d57ca86d2ee1ecc038 [file] [log] [blame]
Reid Spencerb89a2232004-08-25 06:20:07 +00001//===-- Path.cpp - Implement OS Path Concept --------------------*- C++ -*-===//
Misha Brukmanf976c852005-04-21 22:55:34 +00002//
Reid Spencerb89a2232004-08-25 06:20:07 +00003// The LLVM Compiler Infrastructure
4//
Chris Lattner4ee451d2007-12-29 20:36:04 +00005// This file is distributed under the University of Illinois Open Source
6// License. See LICENSE.TXT for details.
Misha Brukmanf976c852005-04-21 22:55:34 +00007//
Reid Spencerb89a2232004-08-25 06:20:07 +00008//===----------------------------------------------------------------------===//
9//
10// This header file implements the operating system Path concept.
11//
12//===----------------------------------------------------------------------===//
Reid Spencer8e665952004-08-29 05:24:01 +000013
Michael J. Spencer1f6efa32010-11-29 18:16:10 +000014#include "llvm/Support/Path.h"
Reid Spencer79fc9242004-12-13 18:41:28 +000015#include "llvm/Config/config.h"
Eric Christopher539d8d82011-04-03 22:53:19 +000016#include "llvm/Support/Endian.h"
Chandler Carruthd04a8d42012-12-03 16:50:05 +000017#include "llvm/Support/FileSystem.h"
Alkis Evlogimenos98bc8ed2004-11-14 22:37:42 +000018#include <cassert>
Duncan Sandsf52e32a2008-01-09 19:42:09 +000019#include <cstring>
Chris Lattnerc67dc452006-07-07 18:11:32 +000020#include <ostream>
21using namespace llvm;
Reid Spencer8e665952004-08-29 05:24:01 +000022using namespace sys;
Eric Christopher539d8d82011-04-03 22:53:19 +000023namespace {
24using support::ulittle32_t;
25}
Reid Spencerb89a2232004-08-25 06:20:07 +000026
27//===----------------------------------------------------------------------===//
28//=== WARNING: Implementation here must contain only TRULY operating system
Misha Brukmanf976c852005-04-21 22:55:34 +000029//=== independent code.
Reid Spencerb89a2232004-08-25 06:20:07 +000030//===----------------------------------------------------------------------===//
31
Bill Wendling40db5d42008-05-21 21:20:07 +000032bool Path::operator==(const Path &that) const {
33 return path == that.path;
34}
35
Bill Wendling40db5d42008-05-21 21:20:07 +000036bool Path::operator<(const Path& that) const {
37 return path < that.path;
38}
39
Misha Brukmanf976c852005-04-21 22:55:34 +000040LLVMFileType
Rafael Espindolaf12745f2013-06-10 15:27:39 +000041sys::identifyFileType(StringRef Magic) {
42 unsigned Length = Magic.size();
43 assert(Length >= 4 && "Invalid magic number length");
Rafael Espindola91de80a2013-06-10 14:56:16 +000044 switch ((unsigned char)Magic[0]) {
Chris Lattner6fa6a322008-07-09 05:14:23 +000045 case 0xDE: // 0x0B17C0DE = BC wraper
Rafael Espindola91de80a2013-06-10 14:56:16 +000046 if (Magic[1] == (char)0xC0 && Magic[2] == (char)0x17 &&
47 Magic[3] == (char)0x0B)
Chris Lattner6fa6a322008-07-09 05:14:23 +000048 return Bitcode_FileType;
49 break;
Chris Lattnerf283a5e2007-05-06 05:32:21 +000050 case 'B':
Rafael Espindola91de80a2013-06-10 14:56:16 +000051 if (Magic[1] == 'C' && Magic[2] == (char)0xC0 && Magic[3] == (char)0xDE)
Chris Lattnerf283a5e2007-05-06 05:32:21 +000052 return Bitcode_FileType;
53 break;
Reid Spencer8bb5fd12007-04-04 06:30:26 +000054 case '!':
Rafael Espindola91de80a2013-06-10 14:56:16 +000055 if (Length >= 8)
Rafael Espindolaf12745f2013-06-10 15:27:39 +000056 if (memcmp(Magic.data(),"!<arch>\n",8) == 0)
Reid Spencer8bb5fd12007-04-04 06:30:26 +000057 return Archive_FileType;
58 break;
Michael J. Spencer4a295d32010-08-31 06:36:46 +000059
Reid Spencer8bb5fd12007-04-04 06:30:26 +000060 case '\177':
Rafael Espindolab9724572013-06-10 15:22:18 +000061 if (Length >= 18 && Magic[1] == 'E' && Magic[2] == 'L' &&
62 Magic[3] == 'F') {
Rafael Espindola91de80a2013-06-10 14:56:16 +000063 bool Data2MSB = Magic[5] == 2;
Meador Ingeb935cd12012-06-25 14:48:43 +000064 unsigned high = Data2MSB ? 16 : 17;
65 unsigned low = Data2MSB ? 17 : 16;
Rafael Espindolab9724572013-06-10 15:22:18 +000066 if (Magic[high] == 0)
Rafael Espindola91de80a2013-06-10 14:56:16 +000067 switch (Magic[low]) {
Reid Spencer947aa7d2007-04-11 02:02:09 +000068 default: break;
69 case 1: return ELF_Relocatable_FileType;
70 case 2: return ELF_Executable_FileType;
71 case 3: return ELF_SharedObject_FileType;
72 case 4: return ELF_Core_FileType;
73 }
Chris Lattner24eac6c2007-05-03 18:15:56 +000074 }
Reid Spencerf37ce992004-11-14 22:05:32 +000075 break;
76
Chris Lattnerade75922007-04-11 03:15:35 +000077 case 0xCA:
Rafael Espindola91de80a2013-06-10 14:56:16 +000078 if (Magic[1] == char(0xFE) && Magic[2] == char(0xBA) &&
79 Magic[3] == char(0xBE)) {
Michael J. Spencer4a295d32010-08-31 06:36:46 +000080 // This is complicated by an overlap with Java class files.
Chris Lattner65215492008-06-26 05:17:18 +000081 // See the Mach-O section in /usr/share/file/magic for details.
Rafael Espindola91de80a2013-06-10 14:56:16 +000082 if (Length >= 8 && Magic[7] < 43)
Chris Lattner65215492008-06-26 05:17:18 +000083 // FIXME: Universal Binary of any type.
84 return Mach_O_DynamicallyLinkedSharedLib_FileType;
85 }
86 break;
87
Eric Christopherf0c3af62011-04-22 03:50:19 +000088 // The two magic numbers for mach-o are:
89 // 0xfeedface - 32-bit mach-o
90 // 0xfeedfacf - 64-bit mach-o
Chris Lattner65215492008-06-26 05:17:18 +000091 case 0xFE:
Eric Christopherf0c3af62011-04-22 03:50:19 +000092 case 0xCE:
93 case 0xCF: {
Bill Wendlingfc1fd542008-06-26 08:32:05 +000094 uint16_t type = 0;
Rafael Espindola91de80a2013-06-10 14:56:16 +000095 if (Magic[0] == char(0xFE) && Magic[1] == char(0xED) &&
96 Magic[2] == char(0xFA) &&
97 (Magic[3] == char(0xCE) || Magic[3] == char(0xCF))) {
Chris Lattner65215492008-06-26 05:17:18 +000098 /* Native endian */
Rafael Espindola91de80a2013-06-10 14:56:16 +000099 if (Length >= 16) type = Magic[14] << 8 | Magic[15];
100 } else if ((Magic[0] == char(0xCE) || Magic[0] == char(0xCF)) &&
101 Magic[1] == char(0xFA) && Magic[2] == char(0xED) &&
102 Magic[3] == char(0xFE)) {
Chris Lattner65215492008-06-26 05:17:18 +0000103 /* Reverse endian */
Rafael Espindola91de80a2013-06-10 14:56:16 +0000104 if (Length >= 14) type = Magic[13] << 8 | Magic[12];
Bill Wendlingfc1fd542008-06-26 08:32:05 +0000105 }
Chris Lattner65215492008-06-26 05:17:18 +0000106 switch (type) {
Michael J. Spencer4a295d32010-08-31 06:36:46 +0000107 default: break;
108 case 1: return Mach_O_Object_FileType;
Chris Lattner65215492008-06-26 05:17:18 +0000109 case 2: return Mach_O_Executable_FileType;
110 case 3: return Mach_O_FixedVirtualMemorySharedLib_FileType;
111 case 4: return Mach_O_Core_FileType;
Peter Collingbourneb1a33c42010-11-17 00:43:43 +0000112 case 5: return Mach_O_PreloadExecutable_FileType;
Chris Lattner65215492008-06-26 05:17:18 +0000113 case 6: return Mach_O_DynamicallyLinkedSharedLib_FileType;
114 case 7: return Mach_O_DynamicLinker_FileType;
115 case 8: return Mach_O_Bundle_FileType;
116 case 9: return Mach_O_DynamicallyLinkedSharedLibStub_FileType;
Benjamin Kramer83662342011-09-14 00:39:22 +0000117 case 10: return Mach_O_DSYMCompanion_FileType;
Chris Lattnerade75922007-04-11 03:15:35 +0000118 }
Reid Spencer8bb5fd12007-04-04 06:30:26 +0000119 break;
Bill Wendlingfc1fd542008-06-26 08:32:05 +0000120 }
Reid Spencer8bb5fd12007-04-04 06:30:26 +0000121 case 0xF0: // PowerPC Windows
122 case 0x83: // Alpha 32-bit
123 case 0x84: // Alpha 64-bit
124 case 0x66: // MPS R4000 Windows
125 case 0x50: // mc68K
126 case 0x4c: // 80386 Windows
Rafael Espindola91de80a2013-06-10 14:56:16 +0000127 if (Magic[1] == 0x01)
Reid Spencer8bb5fd12007-04-04 06:30:26 +0000128 return COFF_FileType;
129
130 case 0x90: // PA-RISC Windows
131 case 0x68: // mc68K Windows
Rafael Espindola91de80a2013-06-10 14:56:16 +0000132 if (Magic[1] == 0x02)
Reid Spencer8bb5fd12007-04-04 06:30:26 +0000133 return COFF_FileType;
Reid Spencerf37ce992004-11-14 22:05:32 +0000134 break;
Eric Christopher539d8d82011-04-03 22:53:19 +0000135
136 case 0x4d: // Possible MS-DOS stub on Windows PE file
Rafael Espindola91de80a2013-06-10 14:56:16 +0000137 if (Magic[1] == 0x5a) {
138 uint32_t off =
Rafael Espindolaf12745f2013-06-10 15:27:39 +0000139 *reinterpret_cast<const ulittle32_t *>(Magic.data() + 0x3c);
Eric Christopher539d8d82011-04-03 22:53:19 +0000140 // PE/COFF file, either EXE or DLL.
Rafael Espindolaf12745f2013-06-10 15:27:39 +0000141 if (off < Length && memcmp(Magic.data() + off, "PE\0\0",4) == 0)
Eric Christopher539d8d82011-04-03 22:53:19 +0000142 return COFF_FileType;
143 }
144 break;
145
Michael J. Spencer7e7d01d2010-09-15 23:04:14 +0000146 case 0x64: // x86-64 Windows.
Rafael Espindola91de80a2013-06-10 14:56:16 +0000147 if (Magic[1] == char(0x86))
Michael J. Spencer7e7d01d2010-09-15 23:04:14 +0000148 return COFF_FileType;
149 break;
Reid Spencerf37ce992004-11-14 22:05:32 +0000150
151 default:
152 break;
153 }
Reid Spencer8bb5fd12007-04-04 06:30:26 +0000154 return Unknown_FileType;
Reid Spencerf37ce992004-11-14 22:05:32 +0000155}
156
Reid Spencerccb23a12004-12-13 03:00:39 +0000157bool
158Path::isArchive() const {
Michael J. Spencer5b082302011-12-13 23:17:12 +0000159 fs::file_magic type;
Michael J. Spencer28f0ed52011-01-15 20:39:36 +0000160 if (fs::identify_magic(str(), type))
161 return false;
Michael J. Spencer5b082302011-12-13 23:17:12 +0000162 return type == fs::file_magic::archive;
Reid Spencerccb23a12004-12-13 03:00:39 +0000163}
164
165bool
166Path::isDynamicLibrary() const {
Michael J. Spencer5b082302011-12-13 23:17:12 +0000167 fs::file_magic type;
Michael J. Spencer28f0ed52011-01-15 20:39:36 +0000168 if (fs::identify_magic(str(), type))
169 return false;
170 switch (type) {
171 default: return false;
Michael J. Spencer5b082302011-12-13 23:17:12 +0000172 case fs::file_magic::macho_fixed_virtual_memory_shared_lib:
173 case fs::file_magic::macho_dynamically_linked_shared_lib:
174 case fs::file_magic::macho_dynamically_linked_shared_lib_stub:
175 case fs::file_magic::elf_shared_object:
176 case fs::file_magic::pecoff_executable: return true;
Michael J. Spencer28f0ed52011-01-15 20:39:36 +0000177 }
Reid Spencerccb23a12004-12-13 03:00:39 +0000178}
179
Michael J. Spencer8a26f812010-09-15 22:45:45 +0000180bool
181Path::isObjectFile() const {
Michael J. Spencer5b082302011-12-13 23:17:12 +0000182 fs::file_magic type;
183 if (fs::identify_magic(str(), type) || type == fs::file_magic::unknown)
Michael J. Spencer28f0ed52011-01-15 20:39:36 +0000184 return false;
185 return true;
Michael J. Spencer8a26f812010-09-15 22:45:45 +0000186}
187
Reid Spencerccb23a12004-12-13 03:00:39 +0000188Path
189Path::FindLibrary(std::string& name) {
190 std::vector<sys::Path> LibPaths;
191 GetSystemLibraryPaths(LibPaths);
192 for (unsigned i = 0; i < LibPaths.size(); ++i) {
193 sys::Path FullPath(LibPaths[i]);
Reid Spencerdd04df02005-07-07 23:21:43 +0000194 FullPath.appendComponent("lib" + name + LTDL_SHLIB_EXT);
Reid Spencerccb23a12004-12-13 03:00:39 +0000195 if (FullPath.isDynamicLibrary())
196 return FullPath;
Reid Spencerdd04df02005-07-07 23:21:43 +0000197 FullPath.eraseSuffix();
Reid Spencerccb23a12004-12-13 03:00:39 +0000198 FullPath.appendSuffix("a");
199 if (FullPath.isArchive())
200 return FullPath;
201 }
202 return sys::Path();
203}
204
Jeffrey Yasskin88cd3582009-12-17 21:02:39 +0000205StringRef Path::GetDLLSuffix() {
Mikhail Glushenkovc8aef4b2010-11-02 20:32:59 +0000206 return &(LTDL_SHLIB_EXT[1]);
Reid Spencer79fc9242004-12-13 18:41:28 +0000207}
208
Dan Gohman552a3c22010-12-01 02:46:41 +0000209void
Mikhail Glushenkovbd6e0322010-11-02 22:18:37 +0000210Path::appendSuffix(StringRef suffix) {
211 if (!suffix.empty()) {
Mikhail Glushenkovbd6e0322010-11-02 22:18:37 +0000212 path.append(".");
213 path.append(suffix);
Mikhail Glushenkovbd6e0322010-11-02 22:18:37 +0000214 }
Mikhail Glushenkovbd6e0322010-11-02 22:18:37 +0000215}
216
217bool
Chris Lattnerf283a5e2007-05-06 05:32:21 +0000218Path::isBitcodeFile() const {
Michael J. Spencer5b082302011-12-13 23:17:12 +0000219 fs::file_magic type;
Michael J. Spencer28f0ed52011-01-15 20:39:36 +0000220 if (fs::identify_magic(str(), type))
Chris Lattnerf283a5e2007-05-06 05:32:21 +0000221 return false;
Michael J. Spencer5b082302011-12-13 23:17:12 +0000222 return type == fs::file_magic::bitcode;
Chris Lattnerf283a5e2007-05-06 05:32:21 +0000223}
224
Jeffrey Yasskin88cd3582009-12-17 21:02:39 +0000225bool Path::hasMagicNumber(StringRef Magic) const {
Chris Lattnerf283a5e2007-05-06 05:32:21 +0000226 std::string actualMagic;
Evan Cheng34cd4a42008-05-05 18:30:58 +0000227 if (getMagicNumber(actualMagic, static_cast<unsigned>(Magic.size())))
Chris Lattnerf283a5e2007-05-06 05:32:21 +0000228 return Magic == actualMagic;
229 return false;
230}
231
Chris Lattnere1b332a2008-02-27 06:17:10 +0000232static void getPathList(const char*path, std::vector<Path>& Paths) {
233 const char* at = path;
234 const char* delim = strchr(at, PathSeparator);
235 Path tmpPath;
236 while (delim != 0) {
237 std::string tmp(at, size_t(delim-at));
238 if (tmpPath.set(tmp))
239 if (tmpPath.canRead())
240 Paths.push_back(tmpPath);
241 at = delim + 1;
242 delim = strchr(at, PathSeparator);
243 }
244
245 if (*at != 0)
246 if (tmpPath.set(std::string(at)))
247 if (tmpPath.canRead())
248 Paths.push_back(tmpPath);
249}
250
Jeffrey Yasskin88cd3582009-12-17 21:02:39 +0000251static StringRef getDirnameCharSep(StringRef path, const char *Sep) {
252 assert(Sep[0] != '\0' && Sep[1] == '\0' &&
253 "Sep must be a 1-character string literal.");
Ted Kremenekcf55c8e2008-04-07 21:53:57 +0000254 if (path.empty())
255 return ".";
Michael J. Spencer4a295d32010-08-31 06:36:46 +0000256
Ted Kremenekcf55c8e2008-04-07 21:53:57 +0000257 // If the path is all slashes, return a single slash.
258 // Otherwise, remove all trailing slashes.
Michael J. Spencer4a295d32010-08-31 06:36:46 +0000259
Evan Cheng34cd4a42008-05-05 18:30:58 +0000260 signed pos = static_cast<signed>(path.size()) - 1;
Michael J. Spencer4a295d32010-08-31 06:36:46 +0000261
Jeffrey Yasskin88cd3582009-12-17 21:02:39 +0000262 while (pos >= 0 && path[pos] == Sep[0])
Ted Kremenekcf55c8e2008-04-07 21:53:57 +0000263 --pos;
Michael J. Spencer4a295d32010-08-31 06:36:46 +0000264
Ted Kremenekcf55c8e2008-04-07 21:53:57 +0000265 if (pos < 0)
Jeffrey Yasskin88cd3582009-12-17 21:02:39 +0000266 return path[0] == Sep[0] ? Sep : ".";
Michael J. Spencer4a295d32010-08-31 06:36:46 +0000267
Ted Kremenekcf55c8e2008-04-07 21:53:57 +0000268 // Any slashes left?
269 signed i = 0;
Michael J. Spencer4a295d32010-08-31 06:36:46 +0000270
Jeffrey Yasskin88cd3582009-12-17 21:02:39 +0000271 while (i < pos && path[i] != Sep[0])
Ted Kremenekcf55c8e2008-04-07 21:53:57 +0000272 ++i;
Michael J. Spencer4a295d32010-08-31 06:36:46 +0000273
Ted Kremenekcf55c8e2008-04-07 21:53:57 +0000274 if (i == pos) // No slashes? Return "."
275 return ".";
Michael J. Spencer4a295d32010-08-31 06:36:46 +0000276
277 // There is at least one slash left. Remove all trailing non-slashes.
Jeffrey Yasskin88cd3582009-12-17 21:02:39 +0000278 while (pos >= 0 && path[pos] != Sep[0])
Ted Kremenekcf55c8e2008-04-07 21:53:57 +0000279 --pos;
Michael J. Spencer4a295d32010-08-31 06:36:46 +0000280
Ted Kremenekcf55c8e2008-04-07 21:53:57 +0000281 // Remove any trailing slashes.
Jeffrey Yasskin88cd3582009-12-17 21:02:39 +0000282 while (pos >= 0 && path[pos] == Sep[0])
Ted Kremenekcf55c8e2008-04-07 21:53:57 +0000283 --pos;
Michael J. Spencer4a295d32010-08-31 06:36:46 +0000284
Ted Kremenekcf55c8e2008-04-07 21:53:57 +0000285 if (pos < 0)
Jeffrey Yasskin88cd3582009-12-17 21:02:39 +0000286 return path[0] == Sep[0] ? Sep : ".";
Michael J. Spencer4a295d32010-08-31 06:36:46 +0000287
Ted Kremenekcf55c8e2008-04-07 21:53:57 +0000288 return path.substr(0, pos+1);
289}
290
Reid Spencerb89a2232004-08-25 06:20:07 +0000291// Include the truly platform-specific parts of this class.
Reid Spencerdafe55f2004-12-24 06:29:17 +0000292#if defined(LLVM_ON_UNIX)
Reid Spencerbccc8ab2005-01-09 23:29:00 +0000293#include "Unix/Path.inc"
Reid Spencerdafe55f2004-12-24 06:29:17 +0000294#endif
295#if defined(LLVM_ON_WIN32)
Michael J. Spencer1f6efa32010-11-29 18:16:10 +0000296#include "Windows/Path.inc"
Reid Spencerdafe55f2004-12-24 06:29:17 +0000297#endif