1//===-- sanitizer_file.h ---------------------------------------*- C++ -*-===// 2// 3// The LLVM Compiler Infrastructure 4// 5// This file is distributed under the University of Illinois Open Source 6// License. See LICENSE.TXT for details. 7// 8//===---------------------------------------------------------------------===// 9// 10// This file is shared between run-time libraries of sanitizers. 11// It declares filesystem-related interfaces. This is separate from 12// sanitizer_common.h so that it's simpler to disable all the filesystem 13// support code for a port that doesn't use it. 14// 15//===---------------------------------------------------------------------===// 16#ifndef SANITIZER_FILE_H 17#define SANITIZER_FILE_H 18 19#include "sanitizer_interface_internal.h" 20#include "sanitizer_internal_defs.h" 21#include "sanitizer_libc.h" 22#include "sanitizer_mutex.h" 23 24namespace __sanitizer { 25 26struct ReportFile { 27 void Write(const char *buffer, uptr length); 28 bool SupportsColors(); 29 void SetReportPath(const char *path); 30 31 // Don't use fields directly. They are only declared public to allow 32 // aggregate initialization. 33 34 // Protects fields below. 35 StaticSpinMutex *mu; 36 // Opened file descriptor. Defaults to stderr. It may be equal to 37 // kInvalidFd, in which case new file will be opened when necessary. 38 fd_t fd; 39 // Path prefix of report file, set via __sanitizer_set_report_path. 40 char path_prefix[kMaxPathLength]; 41 // Full path to report, obtained as <path_prefix>.PID 42 char full_path[kMaxPathLength]; 43 // PID of the process that opened fd. If a fork() occurs, 44 // the PID of child will be different from fd_pid. 45 uptr fd_pid; 46 47 private: 48 void ReopenIfNecessary(); 49}; 50extern ReportFile report_file; 51 52enum FileAccessMode { 53 RdOnly, 54 WrOnly, 55 RdWr 56}; 57 58// Returns kInvalidFd on error. 59fd_t OpenFile(const char *filename, FileAccessMode mode, 60 error_t *errno_p = nullptr); 61void CloseFile(fd_t); 62 63// Return true on success, false on error. 64bool ReadFromFile(fd_t fd, void *buff, uptr buff_size, 65 uptr *bytes_read = nullptr, error_t *error_p = nullptr); 66bool WriteToFile(fd_t fd, const void *buff, uptr buff_size, 67 uptr *bytes_written = nullptr, error_t *error_p = nullptr); 68 69// Scoped file handle closer. 70struct FileCloser { 71 explicit FileCloser(fd_t fd) : fd(fd) {} 72 ~FileCloser() { CloseFile(fd); } 73 fd_t fd; 74}; 75 76bool SupportsColoredOutput(fd_t fd); 77 78// OS 79const char *GetPwd(); 80bool FileExists(const char *filename); 81char *FindPathToBinary(const char *name); 82bool IsPathSeparator(const char c); 83bool IsAbsolutePath(const char *path); 84// Starts a subprocess and returs its pid. 85// If *_fd parameters are not kInvalidFd their corresponding input/output 86// streams will be redirect to the file. The files will always be closed 87// in parent process even in case of an error. 88// The child process will close all fds after STDERR_FILENO 89// before passing control to a program. 90pid_t StartSubprocess(const char *filename, const char *const argv[], 91 fd_t stdin_fd = kInvalidFd, fd_t stdout_fd = kInvalidFd, 92 fd_t stderr_fd = kInvalidFd); 93// Checks if specified process is still running 94bool IsProcessRunning(pid_t pid); 95// Waits for the process to finish and returns its exit code. 96// Returns -1 in case of an error. 97int WaitForProcess(pid_t pid); 98 99// Maps given file to virtual memory, and returns pointer to it 100// (or NULL if mapping fails). Stores the size of mmaped region 101// in '*buff_size'. 102void *MapFileToMemory(const char *file_name, uptr *buff_size); 103void *MapWritableFileToMemory(void *addr, uptr size, fd_t fd, OFF_T offset); 104 105} // namespace __sanitizer 106 107#endif // SANITIZER_FILE_H 108