1//===- llvm/Support/Unix/Path.inc - Unix Path Implementation ----*- C++ -*-===//
2//
3// Part of the LLVM Project, under the Apache License v2.0 with LLVM Exceptions.
4// See https://llvm.org/LICENSE.txt for license information.
5// SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
6//
7//===----------------------------------------------------------------------===//
8//
9// This file implements the Unix specific implementation of the Path API.
10//
11//===----------------------------------------------------------------------===//
12
13//===----------------------------------------------------------------------===//
14//=== WARNING: Implementation here must contain only generic UNIX code that
15//===          is guaranteed to work on *all* UNIX variants.
16//===----------------------------------------------------------------------===//
17
18#include "Unix.h"
19#include <limits.h>
20#include <stdio.h>
21#if HAVE_SYS_STAT_H
22#include <sys/stat.h>
23#endif
24#if HAVE_FCNTL_H
25#include <fcntl.h>
26#endif
27#ifdef HAVE_UNISTD_H
28#include <unistd.h>
29#endif
30#ifdef HAVE_SYS_MMAN_H
31#include <sys/mman.h>
32#endif
33
34#include <dirent.h>
35#include <pwd.h>
36
37#ifdef __APPLE__
38#include <mach-o/dyld.h>
39#include <sys/attr.h>
40#include <copyfile.h>
41#elif defined(__DragonFly__)
42#include <sys/mount.h>
43#endif
44
45// Both stdio.h and cstdio are included via different paths and
46// stdcxx's cstdio doesn't include stdio.h, so it doesn't #undef the macros
47// either.
48#undef ferror
49#undef feof
50
51// For GNU Hurd
52#if defined(__GNU__) && !defined(PATH_MAX)
53# define PATH_MAX 4096
54# define MAXPATHLEN 4096
55#endif
56
57#include <sys/types.h>
58#if !defined(__APPLE__) && !defined(__OpenBSD__) && !defined(__FreeBSD__) &&   \
59    !defined(__linux__) && !defined(__FreeBSD_kernel__) && !defined(_AIX)
60#include <sys/statvfs.h>
61#define STATVFS statvfs
62#define FSTATVFS fstatvfs
63#define STATVFS_F_FRSIZE(vfs) vfs.f_frsize
64#else
65#if defined(__OpenBSD__) || defined(__FreeBSD__)
66#include <sys/mount.h>
67#include <sys/param.h>
68#elif defined(__linux__)
69#if defined(HAVE_LINUX_MAGIC_H)
70#include <linux/magic.h>
71#else
72#if defined(HAVE_LINUX_NFS_FS_H)
73#include <linux/nfs_fs.h>
74#endif
75#if defined(HAVE_LINUX_SMB_H)
76#include <linux/smb.h>
77#endif
78#endif
79#include <sys/vfs.h>
80#elif defined(_AIX)
81#include <sys/statfs.h>
82
83// <sys/vmount.h> depends on `uint` to be a typedef from <sys/types.h> to
84// `uint_t`; however, <sys/types.h> does not always declare `uint`. We provide
85// the typedef prior to including <sys/vmount.h> to work around this issue.
86typedef uint_t uint;
87#include <sys/vmount.h>
88#else
89#include <sys/mount.h>
90#endif
91#define STATVFS statfs
92#define FSTATVFS fstatfs
93#define STATVFS_F_FRSIZE(vfs) static_cast<uint64_t>(vfs.f_bsize)
94#endif
95
96#if defined(__NetBSD__) || defined(__DragonFly__) || defined(__GNU__)
97#define STATVFS_F_FLAG(vfs) (vfs).f_flag
98#else
99#define STATVFS_F_FLAG(vfs) (vfs).f_flags
100#endif
101
102using namespace llvm;
103
104namespace llvm {
105namespace sys  {
106namespace fs {
107
108const file_t kInvalidFile = -1;
109
110#if defined(__FreeBSD__) || defined(__NetBSD__) || defined(__OpenBSD__) ||     \
111    defined(__minix) || defined(__FreeBSD_kernel__) || defined(__linux__) ||   \
112    defined(__CYGWIN__) || defined(__DragonFly__) || defined(_AIX) || defined(__GNU__)
113static int
114test_dir(char ret[PATH_MAX], const char *dir, const char *bin)
115{
116  struct stat sb;
117  char fullpath[PATH_MAX];
118
119  int chars = snprintf(fullpath, PATH_MAX, "%s/%s", dir, bin);
120  // We cannot write PATH_MAX characters because the string will be terminated
121  // with a null character. Fail if truncation happened.
122  if (chars >= PATH_MAX)
123    return 1;
124  if (!realpath(fullpath, ret))
125    return 1;
126  if (stat(fullpath, &sb) != 0)
127    return 1;
128
129  return 0;
130}
131
132static char *
133getprogpath(char ret[PATH_MAX], const char *bin)
134{
135  /* First approach: absolute path. */
136  if (bin[0] == '/') {
137    if (test_dir(ret, "/", bin) == 0)
138      return ret;
139    return nullptr;
140  }
141
142  /* Second approach: relative path. */
143  if (strchr(bin, '/')) {
144    char cwd[PATH_MAX];
145    if (!getcwd(cwd, PATH_MAX))
146      return nullptr;
147    if (test_dir(ret, cwd, bin) == 0)
148      return ret;
149    return nullptr;
150  }
151
152  /* Third approach: $PATH */
153  char *pv;
154  if ((pv = getenv("PATH")) == nullptr)
155    return nullptr;
156  char *s = strdup(pv);
157  if (!s)
158    return nullptr;
159  char *state;
160  for (char *t = strtok_r(s, ":", &state); t != nullptr;
161       t = strtok_r(nullptr, ":", &state)) {
162    if (test_dir(ret, t, bin) == 0) {
163      free(s);
164      return ret;
165    }
166  }
167  free(s);
168  return nullptr;
169}
170#endif // __FreeBSD__ || __NetBSD__ || __FreeBSD_kernel__
171
172/// GetMainExecutable - Return the path to the main executable, given the
173/// value of argv[0] from program startup.
174std::string getMainExecutable(const char *argv0, void *MainAddr) {
175#if defined(__APPLE__)
176  // On OS X the executable path is saved to the stack by dyld. Reading it
177  // from there is much faster than calling dladdr, especially for large
178  // binaries with symbols.
179  char exe_path[MAXPATHLEN];
180  uint32_t size = sizeof(exe_path);
181  if (_NSGetExecutablePath(exe_path, &size) == 0) {
182    char link_path[MAXPATHLEN];
183    if (realpath(exe_path, link_path))
184      return link_path;
185  }
186#elif defined(__FreeBSD__) || defined(__NetBSD__) || defined(__OpenBSD__) ||   \
187    defined(__minix) || defined(__DragonFly__) ||                              \
188    defined(__FreeBSD_kernel__) || defined(_AIX)
189  StringRef curproc("/proc/curproc/file");
190  char exe_path[PATH_MAX];
191  // /proc is not mounted by default under FreeBSD, but gives more accurate
192  // information than argv[0] when it is.
193  if (sys::fs::exists(curproc)) {
194    ssize_t len = readlink(curproc.str().c_str(), exe_path, sizeof(exe_path));
195    if (len > 0) {
196      // Null terminate the string for realpath. readlink never null
197      // terminates its output.
198      len = std::min(len, ssize_t(sizeof(exe_path) - 1));
199      exe_path[len] = '\0';
200      return exe_path;
201    }
202  }
203  // If we don't have procfs mounted, fall back to argv[0]
204  if (getprogpath(exe_path, argv0) != NULL)
205    return exe_path;
206#elif defined(__linux__) || defined(__CYGWIN__)
207  char exe_path[MAXPATHLEN];
208  StringRef aPath("/proc/self/exe");
209  if (sys::fs::exists(aPath)) {
210    // /proc is not always mounted under Linux (chroot for example).
211    ssize_t len = readlink(aPath.str().c_str(), exe_path, sizeof(exe_path));
212    if (len < 0)
213      return "";
214
215    // Null terminate the string for realpath. readlink never null
216    // terminates its output.
217    len = std::min(len, ssize_t(sizeof(exe_path) - 1));
218    exe_path[len] = '\0';
219
220    // On Linux, /proc/self/exe always looks through symlinks. However, on
221    // GNU/Hurd, /proc/self/exe is a symlink to the path that was used to start
222    // the program, and not the eventual binary file. Therefore, call realpath
223    // so this behaves the same on all platforms.
224#if _POSIX_VERSION >= 200112 || defined(__GLIBC__)
225    char *real_path = realpath(exe_path, NULL);
226    std::string ret = std::string(real_path);
227    free(real_path);
228    return ret;
229#else
230    char real_path[MAXPATHLEN];
231    realpath(exe_path, real_path);
232    return std::string(real_path);
233#endif
234  } else {
235    // Fall back to the classical detection.
236    if (getprogpath(exe_path, argv0))
237      return exe_path;
238  }
239#elif defined(HAVE_DLFCN_H) && defined(HAVE_DLADDR)
240  // Use dladdr to get executable path if available.
241  Dl_info DLInfo;
242  int err = dladdr(MainAddr, &DLInfo);
243  if (err == 0)
244    return "";
245
246  // If the filename is a symlink, we need to resolve and return the location of
247  // the actual executable.
248  char link_path[MAXPATHLEN];
249  if (realpath(DLInfo.dli_fname, link_path))
250    return link_path;
251#else
252#error GetMainExecutable is not implemented on this host yet.
253#endif
254  return "";
255}
256
257TimePoint<> basic_file_status::getLastAccessedTime() const {
258  return toTimePoint(fs_st_atime, fs_st_atime_nsec);
259}
260
261TimePoint<> basic_file_status::getLastModificationTime() const {
262  return toTimePoint(fs_st_mtime, fs_st_mtime_nsec);
263}
264
265UniqueID file_status::getUniqueID() const {
266  return UniqueID(fs_st_dev, fs_st_ino);
267}
268
269uint32_t file_status::getLinkCount() const {
270  return fs_st_nlinks;
271}
272
273ErrorOr<space_info> disk_space(const Twine &Path) {
274  struct STATVFS Vfs;
275  if (::STATVFS(const_cast<char *>(Path.str().c_str()), &Vfs))
276    return std::error_code(errno, std::generic_category());
277  auto FrSize = STATVFS_F_FRSIZE(Vfs);
278  space_info SpaceInfo;
279  SpaceInfo.capacity = static_cast<uint64_t>(Vfs.f_blocks) * FrSize;
280  SpaceInfo.free = static_cast<uint64_t>(Vfs.f_bfree) * FrSize;
281  SpaceInfo.available = static_cast<uint64_t>(Vfs.f_bavail) * FrSize;
282  return SpaceInfo;
283}
284
285std::error_code current_path(SmallVectorImpl<char> &result) {
286  result.clear();
287
288  const char *pwd = ::getenv("PWD");
289  llvm::sys::fs::file_status PWDStatus, DotStatus;
290  if (pwd && llvm::sys::path::is_absolute(pwd) &&
291      !llvm::sys::fs::status(pwd, PWDStatus) &&
292      !llvm::sys::fs::status(".", DotStatus) &&
293      PWDStatus.getUniqueID() == DotStatus.getUniqueID()) {
294    result.append(pwd, pwd + strlen(pwd));
295    return std::error_code();
296  }
297
298#ifdef MAXPATHLEN
299  result.reserve(MAXPATHLEN);
300#else
301// For GNU Hurd
302  result.reserve(1024);
303#endif
304
305  while (true) {
306    if (::getcwd(result.data(), result.capacity()) == nullptr) {
307      // See if there was a real error.
308      if (errno != ENOMEM)
309        return std::error_code(errno, std::generic_category());
310      // Otherwise there just wasn't enough space.
311      result.reserve(result.capacity() * 2);
312    } else
313      break;
314  }
315
316  result.set_size(strlen(result.data()));
317  return std::error_code();
318}
319
320std::error_code set_current_path(const Twine &path) {
321  SmallString<128> path_storage;
322  StringRef p = path.toNullTerminatedStringRef(path_storage);
323
324  if (::chdir(p.begin()) == -1)
325    return std::error_code(errno, std::generic_category());
326
327  return std::error_code();
328}
329
330std::error_code create_directory(const Twine &path, bool IgnoreExisting,
331                                 perms Perms) {
332  SmallString<128> path_storage;
333  StringRef p = path.toNullTerminatedStringRef(path_storage);
334
335  if (::mkdir(p.begin(), Perms) == -1) {
336    if (errno != EEXIST || !IgnoreExisting)
337      return std::error_code(errno, std::generic_category());
338  }
339
340  return std::error_code();
341}
342
343// Note that we are using symbolic link because hard links are not supported by
344// all filesystems (SMB doesn't).
345std::error_code create_link(const Twine &to, const Twine &from) {
346  // Get arguments.
347  SmallString<128> from_storage;
348  SmallString<128> to_storage;
349  StringRef f = from.toNullTerminatedStringRef(from_storage);
350  StringRef t = to.toNullTerminatedStringRef(to_storage);
351
352  if (::symlink(t.begin(), f.begin()) == -1)
353    return std::error_code(errno, std::generic_category());
354
355  return std::error_code();
356}
357
358std::error_code create_hard_link(const Twine &to, const Twine &from) {
359  // Get arguments.
360  SmallString<128> from_storage;
361  SmallString<128> to_storage;
362  StringRef f = from.toNullTerminatedStringRef(from_storage);
363  StringRef t = to.toNullTerminatedStringRef(to_storage);
364
365  if (::link(t.begin(), f.begin()) == -1)
366    return std::error_code(errno, std::generic_category());
367
368  return std::error_code();
369}
370
371std::error_code remove(const Twine &path, bool IgnoreNonExisting) {
372  SmallString<128> path_storage;
373  StringRef p = path.toNullTerminatedStringRef(path_storage);
374
375  struct stat buf;
376  if (lstat(p.begin(), &buf) != 0) {
377    if (errno != ENOENT || !IgnoreNonExisting)
378      return std::error_code(errno, std::generic_category());
379    return std::error_code();
380  }
381
382  // Note: this check catches strange situations. In all cases, LLVM should
383  // only be involved in the creation and deletion of regular files.  This
384  // check ensures that what we're trying to erase is a regular file. It
385  // effectively prevents LLVM from erasing things like /dev/null, any block
386  // special file, or other things that aren't "regular" files.
387  if (!S_ISREG(buf.st_mode) && !S_ISDIR(buf.st_mode) && !S_ISLNK(buf.st_mode))
388    return make_error_code(errc::operation_not_permitted);
389
390  if (::remove(p.begin()) == -1) {
391    if (errno != ENOENT || !IgnoreNonExisting)
392      return std::error_code(errno, std::generic_category());
393  }
394
395  return std::error_code();
396}
397
398static bool is_local_impl(struct STATVFS &Vfs) {
399#if defined(__linux__) || defined(__GNU__)
400#ifndef NFS_SUPER_MAGIC
401#define NFS_SUPER_MAGIC 0x6969
402#endif
403#ifndef SMB_SUPER_MAGIC
404#define SMB_SUPER_MAGIC 0x517B
405#endif
406#ifndef CIFS_MAGIC_NUMBER
407#define CIFS_MAGIC_NUMBER 0xFF534D42
408#endif
409#ifdef __GNU__
410  switch ((uint32_t)Vfs.__f_type) {
411#else
412  switch ((uint32_t)Vfs.f_type) {
413#endif
414  case NFS_SUPER_MAGIC:
415  case SMB_SUPER_MAGIC:
416  case CIFS_MAGIC_NUMBER:
417    return false;
418  default:
419    return true;
420  }
421#elif defined(__CYGWIN__)
422  // Cygwin doesn't expose this information; would need to use Win32 API.
423  return false;
424#elif defined(__Fuchsia__)
425  // Fuchsia doesn't yet support remote filesystem mounts.
426  return true;
427#elif defined(__EMSCRIPTEN__)
428  // Emscripten doesn't currently support remote filesystem mounts.
429  return true;
430#elif defined(__HAIKU__)
431  // Haiku doesn't expose this information.
432  return false;
433#elif defined(__sun)
434  // statvfs::f_basetype contains a null-terminated FSType name of the mounted target
435  StringRef fstype(Vfs.f_basetype);
436  // NFS is the only non-local fstype??
437  return !fstype.equals("nfs");
438#elif defined(_AIX)
439  // Call mntctl; try more than twice in case of timing issues with a concurrent
440  // mount.
441  int Ret;
442  size_t BufSize = 2048u;
443  std::unique_ptr<char[]> Buf;
444  int Tries = 3;
445  while (Tries--) {
446    Buf = llvm::make_unique<char[]>(BufSize);
447    Ret = mntctl(MCTL_QUERY, BufSize, Buf.get());
448    if (Ret != 0)
449      break;
450    BufSize = *reinterpret_cast<unsigned int *>(Buf.get());
451    Buf.reset();
452  }
453
454  if (Ret == -1)
455    // There was an error; "remote" is the conservative answer.
456    return false;
457
458  // Look for the correct vmount entry.
459  char *CurObjPtr = Buf.get();
460  while (Ret--) {
461    struct vmount *Vp = reinterpret_cast<struct vmount *>(CurObjPtr);
462    static_assert(sizeof(Vfs.f_fsid) == sizeof(Vp->vmt_fsid),
463                  "fsid length mismatch");
464    if (memcmp(&Vfs.f_fsid, &Vp->vmt_fsid, sizeof Vfs.f_fsid) == 0)
465      return (Vp->vmt_flags & MNT_REMOTE) == 0;
466
467    CurObjPtr += Vp->vmt_length;
468  }
469
470  // vmount entry not found; "remote" is the conservative answer.
471  return false;
472#else
473  return !!(STATVFS_F_FLAG(Vfs) & MNT_LOCAL);
474#endif
475}
476
477std::error_code is_local(const Twine &Path, bool &Result) {
478  struct STATVFS Vfs;
479  if (::STATVFS(const_cast<char *>(Path.str().c_str()), &Vfs))
480    return std::error_code(errno, std::generic_category());
481
482  Result = is_local_impl(Vfs);
483  return std::error_code();
484}
485
486std::error_code is_local(int FD, bool &Result) {
487  struct STATVFS Vfs;
488  if (::FSTATVFS(FD, &Vfs))
489    return std::error_code(errno, std::generic_category());
490
491  Result = is_local_impl(Vfs);
492  return std::error_code();
493}
494
495std::error_code rename(const Twine &from, const Twine &to) {
496  // Get arguments.
497  SmallString<128> from_storage;
498  SmallString<128> to_storage;
499  StringRef f = from.toNullTerminatedStringRef(from_storage);
500  StringRef t = to.toNullTerminatedStringRef(to_storage);
501
502  if (::rename(f.begin(), t.begin()) == -1)
503    return std::error_code(errno, std::generic_category());
504
505  return std::error_code();
506}
507
508std::error_code resize_file(int FD, uint64_t Size) {
509#if defined(HAVE_POSIX_FALLOCATE)
510  // If we have posix_fallocate use it. Unlike ftruncate it always allocates
511  // space, so we get an error if the disk is full.
512  if (int Err = ::posix_fallocate(FD, 0, Size)) {
513#ifdef _AIX
514    constexpr int NotSupportedError = ENOTSUP;
515#else
516    constexpr int NotSupportedError = EOPNOTSUPP;
517#endif
518    if (Err != EINVAL && Err != NotSupportedError)
519      return std::error_code(Err, std::generic_category());
520  }
521#endif
522  // Use ftruncate as a fallback. It may or may not allocate space. At least on
523  // OS X with HFS+ it does.
524  if (::ftruncate(FD, Size) == -1)
525    return std::error_code(errno, std::generic_category());
526
527  return std::error_code();
528}
529
530static int convertAccessMode(AccessMode Mode) {
531  switch (Mode) {
532  case AccessMode::Exist:
533    return F_OK;
534  case AccessMode::Write:
535    return W_OK;
536  case AccessMode::Execute:
537    return R_OK | X_OK; // scripts also need R_OK.
538  }
539  llvm_unreachable("invalid enum");
540}
541
542std::error_code access(const Twine &Path, AccessMode Mode) {
543  SmallString<128> PathStorage;
544  StringRef P = Path.toNullTerminatedStringRef(PathStorage);
545
546  if (::access(P.begin(), convertAccessMode(Mode)) == -1)
547    return std::error_code(errno, std::generic_category());
548
549  if (Mode == AccessMode::Execute) {
550    // Don't say that directories are executable.
551    struct stat buf;
552    if (0 != stat(P.begin(), &buf))
553      return errc::permission_denied;
554    if (!S_ISREG(buf.st_mode))
555      return errc::permission_denied;
556  }
557
558  return std::error_code();
559}
560
561bool can_execute(const Twine &Path) {
562  return !access(Path, AccessMode::Execute);
563}
564
565bool equivalent(file_status A, file_status B) {
566  assert(status_known(A) && status_known(B));
567  return A.fs_st_dev == B.fs_st_dev &&
568         A.fs_st_ino == B.fs_st_ino;
569}
570
571std::error_code equivalent(const Twine &A, const Twine &B, bool &result) {
572  file_status fsA, fsB;
573  if (std::error_code ec = status(A, fsA))
574    return ec;
575  if (std::error_code ec = status(B, fsB))
576    return ec;
577  result = equivalent(fsA, fsB);
578  return std::error_code();
579}
580
581static void expandTildeExpr(SmallVectorImpl<char> &Path) {
582  StringRef PathStr(Path.begin(), Path.size());
583  if (PathStr.empty() || !PathStr.startswith("~"))
584    return;
585
586  PathStr = PathStr.drop_front();
587  StringRef Expr =
588      PathStr.take_until([](char c) { return path::is_separator(c); });
589  StringRef Remainder = PathStr.substr(Expr.size() + 1);
590  SmallString<128> Storage;
591  if (Expr.empty()) {
592    // This is just ~/..., resolve it to the current user's home dir.
593    if (!path::home_directory(Storage)) {
594      // For some reason we couldn't get the home directory.  Just exit.
595      return;
596    }
597
598    // Overwrite the first character and insert the rest.
599    Path[0] = Storage[0];
600    Path.insert(Path.begin() + 1, Storage.begin() + 1, Storage.end());
601    return;
602  }
603
604  // This is a string of the form ~username/, look up this user's entry in the
605  // password database.
606  struct passwd *Entry = nullptr;
607  std::string User = Expr.str();
608  Entry = ::getpwnam(User.c_str());
609
610  if (!Entry) {
611    // Unable to look up the entry, just return back the original path.
612    return;
613  }
614
615  Storage = Remainder;
616  Path.clear();
617  Path.append(Entry->pw_dir, Entry->pw_dir + strlen(Entry->pw_dir));
618  llvm::sys::path::append(Path, Storage);
619}
620
621
622void expand_tilde(const Twine &path, SmallVectorImpl<char> &dest) {
623  dest.clear();
624  if (path.isTriviallyEmpty())
625    return;
626
627  path.toVector(dest);
628  expandTildeExpr(dest);
629
630  return;
631}
632
633static file_type typeForMode(mode_t Mode) {
634  if (S_ISDIR(Mode))
635    return file_type::directory_file;
636  else if (S_ISREG(Mode))
637    return file_type::regular_file;
638  else if (S_ISBLK(Mode))
639    return file_type::block_file;
640  else if (S_ISCHR(Mode))
641    return file_type::character_file;
642  else if (S_ISFIFO(Mode))
643    return file_type::fifo_file;
644  else if (S_ISSOCK(Mode))
645    return file_type::socket_file;
646  else if (S_ISLNK(Mode))
647    return file_type::symlink_file;
648  return file_type::type_unknown;
649}
650
651static std::error_code fillStatus(int StatRet, const struct stat &Status,
652                                  file_status &Result) {
653  if (StatRet != 0) {
654    std::error_code EC(errno, std::generic_category());
655    if (EC == errc::no_such_file_or_directory)
656      Result = file_status(file_type::file_not_found);
657    else
658      Result = file_status(file_type::status_error);
659    return EC;
660  }
661
662  uint32_t atime_nsec, mtime_nsec;
663#if defined(HAVE_STRUCT_STAT_ST_MTIMESPEC_TV_NSEC)
664  atime_nsec = Status.st_atimespec.tv_nsec;
665  mtime_nsec = Status.st_mtimespec.tv_nsec;
666#elif defined(HAVE_STRUCT_STAT_ST_MTIM_TV_NSEC)
667  atime_nsec = Status.st_atim.tv_nsec;
668  mtime_nsec = Status.st_mtim.tv_nsec;
669#else
670  atime_nsec = mtime_nsec = 0;
671#endif
672
673  perms Perms = static_cast<perms>(Status.st_mode) & all_perms;
674  Result = file_status(typeForMode(Status.st_mode), Perms, Status.st_dev,
675                       Status.st_nlink, Status.st_ino,
676                       Status.st_atime, atime_nsec, Status.st_mtime, mtime_nsec,
677                       Status.st_uid, Status.st_gid, Status.st_size);
678
679  return std::error_code();
680}
681
682std::error_code status(const Twine &Path, file_status &Result, bool Follow) {
683  SmallString<128> PathStorage;
684  StringRef P = Path.toNullTerminatedStringRef(PathStorage);
685
686  struct stat Status;
687  int StatRet = (Follow ? ::stat : ::lstat)(P.begin(), &Status);
688  return fillStatus(StatRet, Status, Result);
689}
690
691std::error_code status(int FD, file_status &Result) {
692  struct stat Status;
693  int StatRet = ::fstat(FD, &Status);
694  return fillStatus(StatRet, Status, Result);
695}
696
697std::error_code setPermissions(const Twine &Path, perms Permissions) {
698  SmallString<128> PathStorage;
699  StringRef P = Path.toNullTerminatedStringRef(PathStorage);
700
701  if (::chmod(P.begin(), Permissions))
702    return std::error_code(errno, std::generic_category());
703  return std::error_code();
704}
705
706std::error_code setLastAccessAndModificationTime(int FD, TimePoint<> AccessTime,
707                                                 TimePoint<> ModificationTime) {
708#if defined(HAVE_FUTIMENS)
709  timespec Times[2];
710  Times[0] = sys::toTimeSpec(AccessTime);
711  Times[1] = sys::toTimeSpec(ModificationTime);
712  if (::futimens(FD, Times))
713    return std::error_code(errno, std::generic_category());
714  return std::error_code();
715#elif defined(HAVE_FUTIMES)
716  timeval Times[2];
717  Times[0] = sys::toTimeVal(
718      std::chrono::time_point_cast<std::chrono::microseconds>(AccessTime));
719  Times[1] =
720      sys::toTimeVal(std::chrono::time_point_cast<std::chrono::microseconds>(
721          ModificationTime));
722  if (::futimes(FD, Times))
723    return std::error_code(errno, std::generic_category());
724  return std::error_code();
725#else
726#warning Missing futimes() and futimens()
727  return make_error_code(errc::function_not_supported);
728#endif
729}
730
731std::error_code mapped_file_region::init(int FD, uint64_t Offset,
732                                         mapmode Mode) {
733  assert(Size != 0);
734
735  int flags = (Mode == readwrite) ? MAP_SHARED : MAP_PRIVATE;
736  int prot = (Mode == readonly) ? PROT_READ : (PROT_READ | PROT_WRITE);
737#if defined(__APPLE__)
738  //----------------------------------------------------------------------
739  // Newer versions of MacOSX have a flag that will allow us to read from
740  // binaries whose code signature is invalid without crashing by using
741  // the MAP_RESILIENT_CODESIGN flag. Also if a file from removable media
742  // is mapped we can avoid crashing and return zeroes to any pages we try
743  // to read if the media becomes unavailable by using the
744  // MAP_RESILIENT_MEDIA flag.  These flags are only usable when mapping
745  // with PROT_READ, so take care not to specify them otherwise.
746  //----------------------------------------------------------------------
747  if (Mode == readonly) {
748#if defined(MAP_RESILIENT_CODESIGN)
749    flags |= MAP_RESILIENT_CODESIGN;
750#endif
751#if defined(MAP_RESILIENT_MEDIA)
752    flags |= MAP_RESILIENT_MEDIA;
753#endif
754  }
755#endif // #if defined (__APPLE__)
756
757  Mapping = ::mmap(nullptr, Size, prot, flags, FD, Offset);
758  if (Mapping == MAP_FAILED)
759    return std::error_code(errno, std::generic_category());
760  return std::error_code();
761}
762
763mapped_file_region::mapped_file_region(int fd, mapmode mode, size_t length,
764                                       uint64_t offset, std::error_code &ec)
765    : Size(length), Mapping(), Mode(mode) {
766  (void)Mode;
767  ec = init(fd, offset, mode);
768  if (ec)
769    Mapping = nullptr;
770}
771
772mapped_file_region::~mapped_file_region() {
773  if (Mapping)
774    ::munmap(Mapping, Size);
775}
776
777size_t mapped_file_region::size() const {
778  assert(Mapping && "Mapping failed but used anyway!");
779  return Size;
780}
781
782char *mapped_file_region::data() const {
783  assert(Mapping && "Mapping failed but used anyway!");
784  return reinterpret_cast<char*>(Mapping);
785}
786
787const char *mapped_file_region::const_data() const {
788  assert(Mapping && "Mapping failed but used anyway!");
789  return reinterpret_cast<const char*>(Mapping);
790}
791
792int mapped_file_region::alignment() {
793  return Process::getPageSizeEstimate();
794}
795
796std::error_code detail::directory_iterator_construct(detail::DirIterState &it,
797                                                     StringRef path,
798                                                     bool follow_symlinks) {
799  SmallString<128> path_null(path);
800  DIR *directory = ::opendir(path_null.c_str());
801  if (!directory)
802    return std::error_code(errno, std::generic_category());
803
804  it.IterationHandle = reinterpret_cast<intptr_t>(directory);
805  // Add something for replace_filename to replace.
806  path::append(path_null, ".");
807  it.CurrentEntry = directory_entry(path_null.str(), follow_symlinks);
808  return directory_iterator_increment(it);
809}
810
811std::error_code detail::directory_iterator_destruct(detail::DirIterState &it) {
812  if (it.IterationHandle)
813    ::closedir(reinterpret_cast<DIR *>(it.IterationHandle));
814  it.IterationHandle = 0;
815  it.CurrentEntry = directory_entry();
816  return std::error_code();
817}
818
819static file_type direntType(dirent* Entry) {
820  // Most platforms provide the file type in the dirent: Linux/BSD/Mac.
821  // The DTTOIF macro lets us reuse our status -> type conversion.
822#if defined(_DIRENT_HAVE_D_TYPE) && defined(DTTOIF)
823  return typeForMode(DTTOIF(Entry->d_type));
824#else
825  // Other platforms such as Solaris require a stat() to get the type.
826  return file_type::type_unknown;
827#endif
828}
829
830std::error_code detail::directory_iterator_increment(detail::DirIterState &It) {
831  errno = 0;
832  dirent *CurDir = ::readdir(reinterpret_cast<DIR *>(It.IterationHandle));
833  if (CurDir == nullptr && errno != 0) {
834    return std::error_code(errno, std::generic_category());
835  } else if (CurDir != nullptr) {
836    StringRef Name(CurDir->d_name);
837    if ((Name.size() == 1 && Name[0] == '.') ||
838        (Name.size() == 2 && Name[0] == '.' && Name[1] == '.'))
839      return directory_iterator_increment(It);
840    It.CurrentEntry.replace_filename(Name, direntType(CurDir));
841  } else
842    return directory_iterator_destruct(It);
843
844  return std::error_code();
845}
846
847ErrorOr<basic_file_status> directory_entry::status() const {
848  file_status s;
849  if (auto EC = fs::status(Path, s, FollowSymlinks))
850    return EC;
851  return s;
852}
853
854#if !defined(F_GETPATH)
855static bool hasProcSelfFD() {
856  // If we have a /proc filesystem mounted, we can quickly establish the
857  // real name of the file with readlink
858  static const bool Result = (::access("/proc/self/fd", R_OK) == 0);
859  return Result;
860}
861#endif
862
863static int nativeOpenFlags(CreationDisposition Disp, OpenFlags Flags,
864                           FileAccess Access) {
865  int Result = 0;
866  if (Access == FA_Read)
867    Result |= O_RDONLY;
868  else if (Access == FA_Write)
869    Result |= O_WRONLY;
870  else if (Access == (FA_Read | FA_Write))
871    Result |= O_RDWR;
872
873  // This is for compatibility with old code that assumed F_Append implied
874  // would open an existing file.  See Windows/Path.inc for a longer comment.
875  if (Flags & F_Append)
876    Disp = CD_OpenAlways;
877
878  if (Disp == CD_CreateNew) {
879    Result |= O_CREAT; // Create if it doesn't exist.
880    Result |= O_EXCL;  // Fail if it does.
881  } else if (Disp == CD_CreateAlways) {
882    Result |= O_CREAT; // Create if it doesn't exist.
883    Result |= O_TRUNC; // Truncate if it does.
884  } else if (Disp == CD_OpenAlways) {
885    Result |= O_CREAT; // Create if it doesn't exist.
886  } else if (Disp == CD_OpenExisting) {
887    // Nothing special, just don't add O_CREAT and we get these semantics.
888  }
889
890  if (Flags & F_Append)
891    Result |= O_APPEND;
892
893#ifdef O_CLOEXEC
894  if (!(Flags & OF_ChildInherit))
895    Result |= O_CLOEXEC;
896#endif
897
898  return Result;
899}
900
901std::error_code openFile(const Twine &Name, int &ResultFD,
902                         CreationDisposition Disp, FileAccess Access,
903                         OpenFlags Flags, unsigned Mode) {
904  int OpenFlags = nativeOpenFlags(Disp, Flags, Access);
905
906  SmallString<128> Storage;
907  StringRef P = Name.toNullTerminatedStringRef(Storage);
908  // Call ::open in a lambda to avoid overload resolution in RetryAfterSignal
909  // when open is overloaded, such as in Bionic.
910  auto Open = [&]() { return ::open(P.begin(), OpenFlags, Mode); };
911  if ((ResultFD = sys::RetryAfterSignal(-1, Open)) < 0)
912    return std::error_code(errno, std::generic_category());
913#ifndef O_CLOEXEC
914  if (!(Flags & OF_ChildInherit)) {
915    int r = fcntl(ResultFD, F_SETFD, FD_CLOEXEC);
916    (void)r;
917    assert(r == 0 && "fcntl(F_SETFD, FD_CLOEXEC) failed");
918  }
919#endif
920  return std::error_code();
921}
922
923Expected<int> openNativeFile(const Twine &Name, CreationDisposition Disp,
924                             FileAccess Access, OpenFlags Flags,
925                             unsigned Mode) {
926
927  int FD;
928  std::error_code EC = openFile(Name, FD, Disp, Access, Flags, Mode);
929  if (EC)
930    return errorCodeToError(EC);
931  return FD;
932}
933
934std::error_code openFileForRead(const Twine &Name, int &ResultFD,
935                                OpenFlags Flags,
936                                SmallVectorImpl<char> *RealPath) {
937  std::error_code EC =
938      openFile(Name, ResultFD, CD_OpenExisting, FA_Read, Flags, 0666);
939  if (EC)
940    return EC;
941
942  // Attempt to get the real name of the file, if the user asked
943  if(!RealPath)
944    return std::error_code();
945  RealPath->clear();
946#if defined(F_GETPATH)
947  // When F_GETPATH is availble, it is the quickest way to get
948  // the real path name.
949  char Buffer[MAXPATHLEN];
950  if (::fcntl(ResultFD, F_GETPATH, Buffer) != -1)
951    RealPath->append(Buffer, Buffer + strlen(Buffer));
952#else
953  char Buffer[PATH_MAX];
954  if (hasProcSelfFD()) {
955    char ProcPath[64];
956    snprintf(ProcPath, sizeof(ProcPath), "/proc/self/fd/%d", ResultFD);
957    ssize_t CharCount = ::readlink(ProcPath, Buffer, sizeof(Buffer));
958    if (CharCount > 0)
959      RealPath->append(Buffer, Buffer + CharCount);
960  } else {
961    SmallString<128> Storage;
962    StringRef P = Name.toNullTerminatedStringRef(Storage);
963
964    // Use ::realpath to get the real path name
965    if (::realpath(P.begin(), Buffer) != nullptr)
966      RealPath->append(Buffer, Buffer + strlen(Buffer));
967  }
968#endif
969  return std::error_code();
970}
971
972Expected<file_t> openNativeFileForRead(const Twine &Name, OpenFlags Flags,
973                                       SmallVectorImpl<char> *RealPath) {
974  file_t ResultFD;
975  std::error_code EC = openFileForRead(Name, ResultFD, Flags, RealPath);
976  if (EC)
977    return errorCodeToError(EC);
978  return ResultFD;
979}
980
981void closeFile(file_t &F) {
982  ::close(F);
983  F = kInvalidFile;
984}
985
986template <typename T>
987static std::error_code remove_directories_impl(const T &Entry,
988                                               bool IgnoreErrors) {
989  std::error_code EC;
990  directory_iterator Begin(Entry, EC, false);
991  directory_iterator End;
992  while (Begin != End) {
993    auto &Item = *Begin;
994    ErrorOr<basic_file_status> st = Item.status();
995    if (!st && !IgnoreErrors)
996      return st.getError();
997
998    if (is_directory(*st)) {
999      EC = remove_directories_impl(Item, IgnoreErrors);
1000      if (EC && !IgnoreErrors)
1001        return EC;
1002    }
1003
1004    EC = fs::remove(Item.path(), true);
1005    if (EC && !IgnoreErrors)
1006      return EC;
1007
1008    Begin.increment(EC);
1009    if (EC && !IgnoreErrors)
1010      return EC;
1011  }
1012  return std::error_code();
1013}
1014
1015std::error_code remove_directories(const Twine &path, bool IgnoreErrors) {
1016  auto EC = remove_directories_impl(path, IgnoreErrors);
1017  if (EC && !IgnoreErrors)
1018    return EC;
1019  EC = fs::remove(path, true);
1020  if (EC && !IgnoreErrors)
1021    return EC;
1022  return std::error_code();
1023}
1024
1025std::error_code real_path(const Twine &path, SmallVectorImpl<char> &dest,
1026                          bool expand_tilde) {
1027  dest.clear();
1028  if (path.isTriviallyEmpty())
1029    return std::error_code();
1030
1031  if (expand_tilde) {
1032    SmallString<128> Storage;
1033    path.toVector(Storage);
1034    expandTildeExpr(Storage);
1035    return real_path(Storage, dest, false);
1036  }
1037
1038  SmallString<128> Storage;
1039  StringRef P = path.toNullTerminatedStringRef(Storage);
1040  char Buffer[PATH_MAX];
1041  if (::realpath(P.begin(), Buffer) == nullptr)
1042    return std::error_code(errno, std::generic_category());
1043  dest.append(Buffer, Buffer + strlen(Buffer));
1044  return std::error_code();
1045}
1046
1047} // end namespace fs
1048
1049namespace path {
1050
1051bool home_directory(SmallVectorImpl<char> &result) {
1052  char *RequestedDir = getenv("HOME");
1053  if (!RequestedDir) {
1054    struct passwd *pw = getpwuid(getuid());
1055    if (pw && pw->pw_dir)
1056      RequestedDir = pw->pw_dir;
1057  }
1058  if (!RequestedDir)
1059    return false;
1060
1061  result.clear();
1062  result.append(RequestedDir, RequestedDir + strlen(RequestedDir));
1063  return true;
1064}
1065
1066static bool getDarwinConfDir(bool TempDir, SmallVectorImpl<char> &Result) {
1067  #if defined(_CS_DARWIN_USER_TEMP_DIR) && defined(_CS_DARWIN_USER_CACHE_DIR)
1068  // On Darwin, use DARWIN_USER_TEMP_DIR or DARWIN_USER_CACHE_DIR.
1069  // macros defined in <unistd.h> on darwin >= 9
1070  int ConfName = TempDir ? _CS_DARWIN_USER_TEMP_DIR
1071                         : _CS_DARWIN_USER_CACHE_DIR;
1072  size_t ConfLen = confstr(ConfName, nullptr, 0);
1073  if (ConfLen > 0) {
1074    do {
1075      Result.resize(ConfLen);
1076      ConfLen = confstr(ConfName, Result.data(), Result.size());
1077    } while (ConfLen > 0 && ConfLen != Result.size());
1078
1079    if (ConfLen > 0) {
1080      assert(Result.back() == 0);
1081      Result.pop_back();
1082      return true;
1083    }
1084
1085    Result.clear();
1086  }
1087  #endif
1088  return false;
1089}
1090
1091static const char *getEnvTempDir() {
1092  // Check whether the temporary directory is specified by an environment
1093  // variable.
1094  const char *EnvironmentVariables[] = {"TMPDIR", "TMP", "TEMP", "TEMPDIR"};
1095  for (const char *Env : EnvironmentVariables) {
1096    if (const char *Dir = std::getenv(Env))
1097      return Dir;
1098  }
1099
1100  return nullptr;
1101}
1102
1103static const char *getDefaultTempDir(bool ErasedOnReboot) {
1104#ifdef P_tmpdir
1105  if ((bool)P_tmpdir)
1106    return P_tmpdir;
1107#endif
1108
1109  if (ErasedOnReboot)
1110    return "/tmp";
1111  return "/var/tmp";
1112}
1113
1114void system_temp_directory(bool ErasedOnReboot, SmallVectorImpl<char> &Result) {
1115  Result.clear();
1116
1117  if (ErasedOnReboot) {
1118    // There is no env variable for the cache directory.
1119    if (const char *RequestedDir = getEnvTempDir()) {
1120      Result.append(RequestedDir, RequestedDir + strlen(RequestedDir));
1121      return;
1122    }
1123  }
1124
1125  if (getDarwinConfDir(ErasedOnReboot, Result))
1126    return;
1127
1128  const char *RequestedDir = getDefaultTempDir(ErasedOnReboot);
1129  Result.append(RequestedDir, RequestedDir + strlen(RequestedDir));
1130}
1131
1132} // end namespace path
1133
1134namespace fs {
1135
1136#ifdef __APPLE__
1137/// This implementation tries to perform an APFS CoW clone of the file,
1138/// which can be much faster and uses less space.
1139/// Unfortunately fcopyfile(3) does not support COPYFILE_CLONE, so the
1140/// file descriptor variant of this function still uses the default
1141/// implementation.
1142std::error_code copy_file(const Twine &From, const Twine &To) {
1143  uint32_t Flag = COPYFILE_DATA;
1144#if __has_builtin(__builtin_available)
1145  if (__builtin_available(macos 10.12, *)) {
1146    bool IsSymlink;
1147    if (std::error_code Error = is_symlink_file(From, IsSymlink))
1148      return Error;
1149    // COPYFILE_CLONE clones the symlink instead of following it
1150    // and returns EEXISTS if the target file already exists.
1151    if (!IsSymlink && !exists(To))
1152      Flag = COPYFILE_CLONE;
1153  }
1154#endif
1155  int Status =
1156      copyfile(From.str().c_str(), To.str().c_str(), /* State */ NULL, Flag);
1157
1158  if (Status == 0)
1159    return std::error_code();
1160  return std::error_code(errno, std::generic_category());
1161}
1162#endif // __APPLE__
1163
1164} // end namespace fs
1165
1166} // end namespace sys
1167} // end namespace llvm
1168