1 //===- FuzzerIO.h - Internal header for IO utils ----------------*- 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 // IO interface. 9 //===----------------------------------------------------------------------===// 10 11 #ifndef LLVM_FUZZER_IO_H 12 #define LLVM_FUZZER_IO_H 13 14 #include "FuzzerDefs.h" 15 16 namespace fuzzer { 17 18 long GetEpoch(const std::string &Path); 19 20 Unit FileToVector(const std::string &Path, size_t MaxSize = 0, 21 bool ExitOnError = true); 22 23 std::string FileToString(const std::string &Path); 24 25 void CopyFileToErr(const std::string &Path); 26 27 void WriteToFile(const uint8_t *Data, size_t Size, const std::string &Path); 28 // Write Data.c_str() to the file without terminating null character. 29 void WriteToFile(const std::string &Data, const std::string &Path); 30 void WriteToFile(const Unit &U, const std::string &Path); 31 32 void AppendToFile(const uint8_t *Data, size_t Size, const std::string &Path); 33 void AppendToFile(const std::string &Data, const std::string &Path); 34 35 void ReadDirToVectorOfUnits(const char *Path, std::vector<Unit> *V, long *Epoch, 36 size_t MaxSize, bool ExitOnError, 37 std::vector<std::string> *VPaths = 0); 38 39 // Returns "Dir/FileName" or equivalent for the current OS. 40 std::string DirPlusFile(const std::string &DirPath, 41 const std::string &FileName); 42 43 // Returns the name of the dir, similar to the 'dirname' utility. 44 std::string DirName(const std::string &FileName); 45 46 // Returns path to a TmpDir. 47 std::string TmpDir(); 48 49 std::string TempPath(const char *Prefix, const char *Extension); 50 51 bool IsInterestingCoverageFile(const std::string &FileName); 52 53 void DupAndCloseStderr(); 54 55 void CloseStdout(); 56 57 // For testing. 58 FILE *GetOutputFile(); 59 void SetOutputFile(FILE *NewOutputFile); 60 61 void Printf(const char *Fmt, ...); 62 void VPrintf(bool Verbose, const char *Fmt, ...); 63 64 // Print using raw syscalls, useful when printing at early init stages. 65 void RawPrint(const char *Str); 66 67 // Platform specific functions: 68 bool IsFile(const std::string &Path); 69 bool IsDirectory(const std::string &Path); 70 size_t FileSize(const std::string &Path); 71 72 void ListFilesInDirRecursive(const std::string &Dir, long *Epoch, 73 std::vector<std::string> *V, bool TopDir); 74 75 bool MkDirRecursive(const std::string &Dir); 76 void RmDirRecursive(const std::string &Dir); 77 78 // Iterate files and dirs inside Dir, recursively. 79 // Call DirPreCallback/DirPostCallback on dirs before/after 80 // calling FileCallback on files. 81 void IterateDirRecursive(const std::string &Dir, 82 void (*DirPreCallback)(const std::string &Dir), 83 void (*DirPostCallback)(const std::string &Dir), 84 void (*FileCallback)(const std::string &Dir)); 85 86 struct SizedFile { 87 std::string File; 88 size_t Size; 89 bool operator<(const SizedFile &B) const { return Size < B.Size; } 90 }; 91 92 void GetSizedFilesFromDir(const std::string &Dir, std::vector<SizedFile> *V); 93 94 char GetSeparator(); 95 bool IsSeparator(char C); 96 // Similar to the basename utility: returns the file name w/o the dir prefix. 97 std::string Basename(const std::string &Path); 98 99 FILE* OpenFile(int Fd, const char *Mode); 100 101 int CloseFile(int Fd); 102 103 int DuplicateFile(int Fd); 104 105 void RemoveFile(const std::string &Path); 106 void RenameFile(const std::string &OldPath, const std::string &NewPath); 107 108 intptr_t GetHandleFromFd(int fd); 109 110 void MkDir(const std::string &Path); 111 void RmDir(const std::string &Path); 112 113 const std::string &getDevNull(); 114 115 } // namespace fuzzer 116 117 #endif // LLVM_FUZZER_IO_H 118