blob: d0703754e04f2ca9871dd997781f4cfdcca751d0 [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
Chris Lattner6fa6a322008-07-09 05:14:23 +000041sys::IdentifyFileType(const char *magic, unsigned length) {
Reid Spencerf37ce992004-11-14 22:05:32 +000042 assert(magic && "Invalid magic number string");
43 assert(length >=4 && "Invalid magic number length");
Torok Edwin4cdc44c2009-04-25 10:25:12 +000044 switch ((unsigned char)magic[0]) {
Chris Lattner6fa6a322008-07-09 05:14:23 +000045 case 0xDE: // 0x0B17C0DE = BC wraper
46 if (magic[1] == (char)0xC0 && magic[2] == (char)0x17 &&
47 magic[3] == (char)0x0B)
48 return Bitcode_FileType;
49 break;
Chris Lattnerf283a5e2007-05-06 05:32:21 +000050 case 'B':
51 if (magic[1] == 'C' && magic[2] == (char)0xC0 && magic[3] == (char)0xDE)
52 return Bitcode_FileType;
53 break;
Reid Spencer8bb5fd12007-04-04 06:30:26 +000054 case '!':
55 if (length >= 8)
56 if (memcmp(magic,"!<arch>\n",8) == 0)
57 return Archive_FileType;
58 break;
Michael J. Spencer4a295d32010-08-31 06:36:46 +000059
Reid Spencer8bb5fd12007-04-04 06:30:26 +000060 case '\177':
Chris Lattner24eac6c2007-05-03 18:15:56 +000061 if (magic[1] == 'E' && magic[2] == 'L' && magic[3] == 'F') {
Meador Ingeb935cd12012-06-25 14:48:43 +000062 bool Data2MSB = magic[5] == 2;
63 unsigned high = Data2MSB ? 16 : 17;
64 unsigned low = Data2MSB ? 17 : 16;
65 if (length >= 18 && magic[high] == 0)
66 switch (magic[low]) {
Reid Spencer947aa7d2007-04-11 02:02:09 +000067 default: break;
68 case 1: return ELF_Relocatable_FileType;
69 case 2: return ELF_Executable_FileType;
70 case 3: return ELF_SharedObject_FileType;
71 case 4: return ELF_Core_FileType;
72 }
Chris Lattner24eac6c2007-05-03 18:15:56 +000073 }
Reid Spencerf37ce992004-11-14 22:05:32 +000074 break;
75
Chris Lattnerade75922007-04-11 03:15:35 +000076 case 0xCA:
Michael J. Spencer4a295d32010-08-31 06:36:46 +000077 if (magic[1] == char(0xFE) && magic[2] == char(0xBA) &&
Chris Lattnerade75922007-04-11 03:15:35 +000078 magic[3] == char(0xBE)) {
Michael J. Spencer4a295d32010-08-31 06:36:46 +000079 // This is complicated by an overlap with Java class files.
Chris Lattner65215492008-06-26 05:17:18 +000080 // See the Mach-O section in /usr/share/file/magic for details.
Michael J. Spencer4a295d32010-08-31 06:36:46 +000081 if (length >= 8 && magic[7] < 43)
Chris Lattner65215492008-06-26 05:17:18 +000082 // FIXME: Universal Binary of any type.
83 return Mach_O_DynamicallyLinkedSharedLib_FileType;
84 }
85 break;
86
Eric Christopherf0c3af62011-04-22 03:50:19 +000087 // The two magic numbers for mach-o are:
88 // 0xfeedface - 32-bit mach-o
89 // 0xfeedfacf - 64-bit mach-o
Chris Lattner65215492008-06-26 05:17:18 +000090 case 0xFE:
Eric Christopherf0c3af62011-04-22 03:50:19 +000091 case 0xCE:
92 case 0xCF: {
Bill Wendlingfc1fd542008-06-26 08:32:05 +000093 uint16_t type = 0;
Michael J. Spencer4a295d32010-08-31 06:36:46 +000094 if (magic[0] == char(0xFE) && magic[1] == char(0xED) &&
Michael J. Spencerfaebf112011-12-13 23:16:15 +000095 magic[2] == char(0xFA) &&
Eric Christopherf0c3af62011-04-22 03:50:19 +000096 (magic[3] == char(0xCE) || magic[3] == char(0xCF))) {
Chris Lattner65215492008-06-26 05:17:18 +000097 /* Native endian */
98 if (length >= 16) type = magic[14] << 8 | magic[15];
Eric Christopherf0c3af62011-04-22 03:50:19 +000099 } else if ((magic[0] == char(0xCE) || magic[0] == char(0xCF)) &&
100 magic[1] == char(0xFA) && magic[2] == char(0xED) &&
101 magic[3] == char(0xFE)) {
Chris Lattner65215492008-06-26 05:17:18 +0000102 /* Reverse endian */
103 if (length >= 14) type = magic[13] << 8 | magic[12];
Bill Wendlingfc1fd542008-06-26 08:32:05 +0000104 }
Chris Lattner65215492008-06-26 05:17:18 +0000105 switch (type) {
Michael J. Spencer4a295d32010-08-31 06:36:46 +0000106 default: break;
107 case 1: return Mach_O_Object_FileType;
Chris Lattner65215492008-06-26 05:17:18 +0000108 case 2: return Mach_O_Executable_FileType;
109 case 3: return Mach_O_FixedVirtualMemorySharedLib_FileType;
110 case 4: return Mach_O_Core_FileType;
Peter Collingbourneb1a33c42010-11-17 00:43:43 +0000111 case 5: return Mach_O_PreloadExecutable_FileType;
Chris Lattner65215492008-06-26 05:17:18 +0000112 case 6: return Mach_O_DynamicallyLinkedSharedLib_FileType;
113 case 7: return Mach_O_DynamicLinker_FileType;
114 case 8: return Mach_O_Bundle_FileType;
115 case 9: return Mach_O_DynamicallyLinkedSharedLibStub_FileType;
Benjamin Kramer83662342011-09-14 00:39:22 +0000116 case 10: return Mach_O_DSYMCompanion_FileType;
Chris Lattnerade75922007-04-11 03:15:35 +0000117 }
Reid Spencer8bb5fd12007-04-04 06:30:26 +0000118 break;
Bill Wendlingfc1fd542008-06-26 08:32:05 +0000119 }
Reid Spencer8bb5fd12007-04-04 06:30:26 +0000120 case 0xF0: // PowerPC Windows
121 case 0x83: // Alpha 32-bit
122 case 0x84: // Alpha 64-bit
123 case 0x66: // MPS R4000 Windows
124 case 0x50: // mc68K
125 case 0x4c: // 80386 Windows
126 if (magic[1] == 0x01)
127 return COFF_FileType;
128
129 case 0x90: // PA-RISC Windows
130 case 0x68: // mc68K Windows
131 if (magic[1] == 0x02)
132 return COFF_FileType;
Reid Spencerf37ce992004-11-14 22:05:32 +0000133 break;
Eric Christopher539d8d82011-04-03 22:53:19 +0000134
135 case 0x4d: // Possible MS-DOS stub on Windows PE file
136 if (magic[1] == 0x5a) {
137 uint32_t off = *reinterpret_cast<const ulittle32_t *>(magic + 0x3c);
138 // PE/COFF file, either EXE or DLL.
139 if (off < length && memcmp(magic + off, "PE\0\0",4) == 0)
140 return COFF_FileType;
141 }
142 break;
143
Michael J. Spencer7e7d01d2010-09-15 23:04:14 +0000144 case 0x64: // x86-64 Windows.
145 if (magic[1] == char(0x86))
146 return COFF_FileType;
147 break;
Reid Spencerf37ce992004-11-14 22:05:32 +0000148
149 default:
150 break;
151 }
Reid Spencer8bb5fd12007-04-04 06:30:26 +0000152 return Unknown_FileType;
Reid Spencerf37ce992004-11-14 22:05:32 +0000153}
154
Reid Spencerccb23a12004-12-13 03:00:39 +0000155bool
156Path::isArchive() const {
Michael J. Spencer5b082302011-12-13 23:17:12 +0000157 fs::file_magic type;
Michael J. Spencer28f0ed52011-01-15 20:39:36 +0000158 if (fs::identify_magic(str(), type))
159 return false;
Michael J. Spencer5b082302011-12-13 23:17:12 +0000160 return type == fs::file_magic::archive;
Reid Spencerccb23a12004-12-13 03:00:39 +0000161}
162
163bool
164Path::isDynamicLibrary() const {
Michael J. Spencer5b082302011-12-13 23:17:12 +0000165 fs::file_magic type;
Michael J. Spencer28f0ed52011-01-15 20:39:36 +0000166 if (fs::identify_magic(str(), type))
167 return false;
168 switch (type) {
169 default: return false;
Michael J. Spencer5b082302011-12-13 23:17:12 +0000170 case fs::file_magic::macho_fixed_virtual_memory_shared_lib:
171 case fs::file_magic::macho_dynamically_linked_shared_lib:
172 case fs::file_magic::macho_dynamically_linked_shared_lib_stub:
173 case fs::file_magic::elf_shared_object:
174 case fs::file_magic::pecoff_executable: return true;
Michael J. Spencer28f0ed52011-01-15 20:39:36 +0000175 }
Reid Spencerccb23a12004-12-13 03:00:39 +0000176}
177
Michael J. Spencer8a26f812010-09-15 22:45:45 +0000178bool
179Path::isObjectFile() const {
Michael J. Spencer5b082302011-12-13 23:17:12 +0000180 fs::file_magic type;
181 if (fs::identify_magic(str(), type) || type == fs::file_magic::unknown)
Michael J. Spencer28f0ed52011-01-15 20:39:36 +0000182 return false;
183 return true;
Michael J. Spencer8a26f812010-09-15 22:45:45 +0000184}
185
Reid Spencerccb23a12004-12-13 03:00:39 +0000186Path
187Path::FindLibrary(std::string& name) {
188 std::vector<sys::Path> LibPaths;
189 GetSystemLibraryPaths(LibPaths);
190 for (unsigned i = 0; i < LibPaths.size(); ++i) {
191 sys::Path FullPath(LibPaths[i]);
Reid Spencerdd04df02005-07-07 23:21:43 +0000192 FullPath.appendComponent("lib" + name + LTDL_SHLIB_EXT);
Reid Spencerccb23a12004-12-13 03:00:39 +0000193 if (FullPath.isDynamicLibrary())
194 return FullPath;
Reid Spencerdd04df02005-07-07 23:21:43 +0000195 FullPath.eraseSuffix();
Reid Spencerccb23a12004-12-13 03:00:39 +0000196 FullPath.appendSuffix("a");
197 if (FullPath.isArchive())
198 return FullPath;
199 }
200 return sys::Path();
201}
202
Jeffrey Yasskin88cd3582009-12-17 21:02:39 +0000203StringRef Path::GetDLLSuffix() {
Mikhail Glushenkovc8aef4b2010-11-02 20:32:59 +0000204 return &(LTDL_SHLIB_EXT[1]);
Reid Spencer79fc9242004-12-13 18:41:28 +0000205}
206
Dan Gohman552a3c22010-12-01 02:46:41 +0000207void
Mikhail Glushenkovbd6e0322010-11-02 22:18:37 +0000208Path::appendSuffix(StringRef suffix) {
209 if (!suffix.empty()) {
Mikhail Glushenkovbd6e0322010-11-02 22:18:37 +0000210 path.append(".");
211 path.append(suffix);
Mikhail Glushenkovbd6e0322010-11-02 22:18:37 +0000212 }
Mikhail Glushenkovbd6e0322010-11-02 22:18:37 +0000213}
214
215bool
Chris Lattnerf283a5e2007-05-06 05:32:21 +0000216Path::isBitcodeFile() const {
Michael J. Spencer5b082302011-12-13 23:17:12 +0000217 fs::file_magic type;
Michael J. Spencer28f0ed52011-01-15 20:39:36 +0000218 if (fs::identify_magic(str(), type))
Chris Lattnerf283a5e2007-05-06 05:32:21 +0000219 return false;
Michael J. Spencer5b082302011-12-13 23:17:12 +0000220 return type == fs::file_magic::bitcode;
Chris Lattnerf283a5e2007-05-06 05:32:21 +0000221}
222
Jeffrey Yasskin88cd3582009-12-17 21:02:39 +0000223bool Path::hasMagicNumber(StringRef Magic) const {
Chris Lattnerf283a5e2007-05-06 05:32:21 +0000224 std::string actualMagic;
Evan Cheng34cd4a42008-05-05 18:30:58 +0000225 if (getMagicNumber(actualMagic, static_cast<unsigned>(Magic.size())))
Chris Lattnerf283a5e2007-05-06 05:32:21 +0000226 return Magic == actualMagic;
227 return false;
228}
229
Chris Lattnere1b332a2008-02-27 06:17:10 +0000230static void getPathList(const char*path, std::vector<Path>& Paths) {
231 const char* at = path;
232 const char* delim = strchr(at, PathSeparator);
233 Path tmpPath;
234 while (delim != 0) {
235 std::string tmp(at, size_t(delim-at));
236 if (tmpPath.set(tmp))
237 if (tmpPath.canRead())
238 Paths.push_back(tmpPath);
239 at = delim + 1;
240 delim = strchr(at, PathSeparator);
241 }
242
243 if (*at != 0)
244 if (tmpPath.set(std::string(at)))
245 if (tmpPath.canRead())
246 Paths.push_back(tmpPath);
247}
248
Jeffrey Yasskin88cd3582009-12-17 21:02:39 +0000249static StringRef getDirnameCharSep(StringRef path, const char *Sep) {
250 assert(Sep[0] != '\0' && Sep[1] == '\0' &&
251 "Sep must be a 1-character string literal.");
Ted Kremenekcf55c8e2008-04-07 21:53:57 +0000252 if (path.empty())
253 return ".";
Michael J. Spencer4a295d32010-08-31 06:36:46 +0000254
Ted Kremenekcf55c8e2008-04-07 21:53:57 +0000255 // If the path is all slashes, return a single slash.
256 // Otherwise, remove all trailing slashes.
Michael J. Spencer4a295d32010-08-31 06:36:46 +0000257
Evan Cheng34cd4a42008-05-05 18:30:58 +0000258 signed pos = static_cast<signed>(path.size()) - 1;
Michael J. Spencer4a295d32010-08-31 06:36:46 +0000259
Jeffrey Yasskin88cd3582009-12-17 21:02:39 +0000260 while (pos >= 0 && path[pos] == Sep[0])
Ted Kremenekcf55c8e2008-04-07 21:53:57 +0000261 --pos;
Michael J. Spencer4a295d32010-08-31 06:36:46 +0000262
Ted Kremenekcf55c8e2008-04-07 21:53:57 +0000263 if (pos < 0)
Jeffrey Yasskin88cd3582009-12-17 21:02:39 +0000264 return path[0] == Sep[0] ? Sep : ".";
Michael J. Spencer4a295d32010-08-31 06:36:46 +0000265
Ted Kremenekcf55c8e2008-04-07 21:53:57 +0000266 // Any slashes left?
267 signed i = 0;
Michael J. Spencer4a295d32010-08-31 06:36:46 +0000268
Jeffrey Yasskin88cd3582009-12-17 21:02:39 +0000269 while (i < pos && path[i] != Sep[0])
Ted Kremenekcf55c8e2008-04-07 21:53:57 +0000270 ++i;
Michael J. Spencer4a295d32010-08-31 06:36:46 +0000271
Ted Kremenekcf55c8e2008-04-07 21:53:57 +0000272 if (i == pos) // No slashes? Return "."
273 return ".";
Michael J. Spencer4a295d32010-08-31 06:36:46 +0000274
275 // There is at least one slash left. Remove all trailing non-slashes.
Jeffrey Yasskin88cd3582009-12-17 21:02:39 +0000276 while (pos >= 0 && path[pos] != Sep[0])
Ted Kremenekcf55c8e2008-04-07 21:53:57 +0000277 --pos;
Michael J. Spencer4a295d32010-08-31 06:36:46 +0000278
Ted Kremenekcf55c8e2008-04-07 21:53:57 +0000279 // Remove any trailing slashes.
Jeffrey Yasskin88cd3582009-12-17 21:02:39 +0000280 while (pos >= 0 && path[pos] == Sep[0])
Ted Kremenekcf55c8e2008-04-07 21:53:57 +0000281 --pos;
Michael J. Spencer4a295d32010-08-31 06:36:46 +0000282
Ted Kremenekcf55c8e2008-04-07 21:53:57 +0000283 if (pos < 0)
Jeffrey Yasskin88cd3582009-12-17 21:02:39 +0000284 return path[0] == Sep[0] ? Sep : ".";
Michael J. Spencer4a295d32010-08-31 06:36:46 +0000285
Ted Kremenekcf55c8e2008-04-07 21:53:57 +0000286 return path.substr(0, pos+1);
287}
288
Reid Spencerb89a2232004-08-25 06:20:07 +0000289// Include the truly platform-specific parts of this class.
Reid Spencerdafe55f2004-12-24 06:29:17 +0000290#if defined(LLVM_ON_UNIX)
Reid Spencerbccc8ab2005-01-09 23:29:00 +0000291#include "Unix/Path.inc"
Reid Spencerdafe55f2004-12-24 06:29:17 +0000292#endif
293#if defined(LLVM_ON_WIN32)
Michael J. Spencer1f6efa32010-11-29 18:16:10 +0000294#include "Windows/Path.inc"
Reid Spencerdafe55f2004-12-24 06:29:17 +0000295#endif