/bitcoin/src/util/fs_helpers.cpp

Source
// Copyright (c) 2009-2010 Satoshi Nakamoto
// Copyright (c) 2009-present The Bitcoin Core developers
// Distributed under the MIT software license, see the accompanying
// file COPYING or http://www.opensource.org/licenses/mit-license.php.

#include <bitcoin-build-config.h> // IWYU pragma: keep

#include <util/fs_helpers.h>
#include <random.h>
#include <sync.h>
#include <tinyformat.h>
#include <util/byte_units.h> // IWYU pragma: keep
#include <util/check.h>
#include <util/fs.h>
#include <util/log.h>
#include <util/syserror.h>

#include <cerrno>
#include <fstream>
#include <limits>
#include <map>
#include <memory>
#include <optional>
#include <stdexcept>
#include <string>
#include <system_error>
#include <utility>

#ifndef WIN32
#include <fcntl.h>
#include <sys/resource.h>
#include <sys/types.h>
#include <unistd.h>
#else
#include <io.h>
#include <shlobj.h>
#endif // WIN32

#ifdef __APPLE__
#include <sys/mount.h>
#include <sys/param.h>
#endif

/** Mutex to protect dir_locks. */
static GlobalMutex cs_dir_locks;
/** A map that contains all the currently held directory locks. After
 * successful locking, these will be held here until the global destructor
 * cleans them up and thus automatically unlocks them, or ReleaseDirectoryLocks
 * is called.
 */
static std::map<std::string, std::unique_ptr<fsbridge::FileLock>> dir_locks GUARDED_BY(cs_dir_locks);
namespace util {
LockResult LockDirectory(const fs::path& directory, const fs::path& lockfile_name, bool probe_only)
{
    LOCK(cs_dir_locks);
    fs::path pathLockFile = directory / lockfile_name;

    // If a lock for this directory already exists in the map, don't try to re-lock it
    if (dir_locks.contains(fs::PathToString(pathLockFile))) {
        return LockResult::Success;
    }

    // Create empty lock file if it doesn't exist.
    if (auto created{fsbridge::fopen(pathLockFile, "a")}) {
        std::fclose(created);
    } else {
        return LockResult::ErrorWrite;
    }
    auto lock = std::make_unique<fsbridge::FileLock>(pathLockFile);
    if (!lock->TryLock()) {
        LogError("Error while attempting to lock directory %s: %s\n", fs::PathToString(directory), lock->GetReason());
        return LockResult::ErrorLock;
    }
    if (!probe_only) {
        // Lock successful and we're not just probing, put it into the map
        dir_locks.emplace(fs::PathToString(pathLockFile), std::move(lock));
    }
    return LockResult::Success;
}
} // namespace util
void UnlockDirectory(const fs::path& directory, const fs::path& lockfile_name)
{
    LOCK(cs_dir_locks);
    dir_locks.erase(fs::PathToString(directory / lockfile_name));
}

void ReleaseDirectoryLocks()
{
    LOCK(cs_dir_locks);
    dir_locks.clear();
}

bool CheckDiskSpace(const fs::path& dir, uint64_t additional_bytes)
{
    constexpr uint64_t min_disk_space{50_MiB};

    uint64_t free_bytes_available = fs::space(dir).available;
    return free_bytes_available >= min_disk_space + additional_bytes;
}

std::streampos GetFileSize(const char* path, std::streamsize max)
{
    std::ifstream file{path, std::ios::binary};
    file.ignore(max);
    return file.gcount();
}

bool FileCommit(FILE* file)
{
    if (fflush(file) != 0) { // harmless if redundantly called
        LogError("fflush failed: %s", SysErrorString(errno));
        return false;
    }
#ifdef WIN32
    HANDLE hFile = (HANDLE)_get_osfhandle(_fileno(file));
    if (FlushFileBuffers(hFile) == 0) {
        LogError("FlushFileBuffers failed: %s", Win32ErrorString(GetLastError()));
        return false;
    }
#elif defined(__APPLE__) && defined(F_FULLFSYNC)
    if (fcntl(fileno(file), F_FULLFSYNC, 0) == -1) { // Manpage says "value other than -1" is returned on success
        LogError("fcntl F_FULLFSYNC failed: %s", SysErrorString(errno));
        return false;
    }
#elif HAVE_FDATASYNC
    if (fdatasync(fileno(file)) != 0 && errno != EINVAL) { // Ignore EINVAL for filesystems that don't support sync
        LogError("fdatasync failed: %s", SysErrorString(errno));
        return false;
    }
#else
    if (fsync(fileno(file)) != 0 && errno != EINVAL) {
        LogError("fsync failed: %s", SysErrorString(errno));
        return false;
    }
#endif
    return true;
}

void DirectoryCommit(const fs::path& dirname)
{
#ifndef WIN32
    FILE* file = fsbridge::fopen(dirname, "r");
    if (file) {
        fsync(fileno(file));
        fclose(file);
    }
#endif
}

bool TruncateFile(FILE* file, unsigned int length)
{
#if defined(WIN32)
    return _chsize(_fileno(file), length) == 0;
#else
    return ftruncate(fileno(file), length) == 0;
#endif
}

int RaiseFileDescriptorLimit(int min_fd)
{
    Assert(min_fd >= 0);
#if defined(WIN32)
    return 2048;
#else
    struct rlimit limitFD;
    if (getrlimit(RLIMIT_NOFILE, &limitFD) != -1) {
        // If the current soft limit is already higher, don't raise it
        if (limitFD.rlim_cur != RLIM_INFINITY && std::cmp_less(limitFD.rlim_cur, min_fd)) {
            const auto current_limit{limitFD.rlim_cur};
            static_assert(std::in_range<rlim_t>(std::numeric_limits<int>::max()));
            limitFD.rlim_cur = static_cast<rlim_t>(min_fd);
            // Don't raise soft limit beyond hard limit
            if ((limitFD.rlim_max != RLIM_INFINITY) && (limitFD.rlim_cur > limitFD.rlim_max)) {
                limitFD.rlim_cur = limitFD.rlim_max;
            }
            if (current_limit != limitFD.rlim_cur) {
                setrlimit(RLIMIT_NOFILE, &limitFD);
                getrlimit(RLIMIT_NOFILE, &limitFD);
            }
        }
        // Check the (possibly raised) current soft limit against the special
        // value of RLIM_INFINITY. Some platforms implement this as the maximum
        // uint64, others as int64 (-1). Avoid casting even if the return type
        // is changed to uint64_t. We also cap unlikely but possible values
        // that would overflow int.
        if (limitFD.rlim_cur == RLIM_INFINITY ||
            std::cmp_greater_equal(limitFD.rlim_cur, std::numeric_limits<int>::max())) {
            return std::numeric_limits<int>::max();
        }
        return static_cast<int>(limitFD.rlim_cur);
    }
    return min_fd; // getrlimit failed, assume it's fine
#endif
}

/**
 * this function tries to make a particular range of a file allocated (corresponding to disk space)
 * it is advisory, and the range specified in the arguments will never contain live data
 */
void AllocateFileRange(FILE* file, unsigned int offset, unsigned int length)
{
#if defined(WIN32)
    // Windows-specific version
    HANDLE hFile = (HANDLE)_get_osfhandle(_fileno(file));
    LARGE_INTEGER nFileSize;
    int64_t nEndPos = (int64_t)offset + length;
    nFileSize.u.LowPart = nEndPos & 0xFFFFFFFF;
    nFileSize.u.HighPart = nEndPos >> 32;
    SetFilePointerEx(hFile, nFileSize, 0, FILE_BEGIN);
    SetEndOfFile(hFile);
#elif defined(__APPLE__)
    // OSX specific version
    // NOTE: Contrary to other OS versions, the OSX version assumes that
    // NOTE: offset is the size of the file.
    fstore_t fst;
    fst.fst_flags = F_ALLOCATECONTIG;
    fst.fst_posmode = F_PEOFPOSMODE;
    fst.fst_offset = 0;
    fst.fst_length = length; // mac os fst_length takes the # of free bytes to allocate, not desired file size
    fst.fst_bytesalloc = 0;
    if (fcntl(fileno(file), F_PREALLOCATE, &fst) == -1) {
        fst.fst_flags = F_ALLOCATEALL;
        fcntl(fileno(file), F_PREALLOCATE, &fst);
    }
    ftruncate(fileno(file), static_cast<off_t>(offset) + length);
#else
#if defined(HAVE_POSIX_FALLOCATE)
    // Version using posix_fallocate
    off_t nEndPos = (off_t)offset + length;
    if (0 == posix_fallocate(fileno(file), 0, nEndPos)) return;
#endif
    // Fallback version
    // TODO: just write one byte per block
    static const char buf[65536] = {};
    if (fseek(file, offset, SEEK_SET)) {
        return;
    }
    while (length > 0) {
        unsigned int now = 65536;
        if (length < now)
            now = length;
        fwrite(buf, 1, now, file); // allowed to fail; this function is advisory anyway
        length -= now;
    }
#endif
}

#ifdef WIN32
fs::path GetSpecialFolderPath(int nFolder, bool fCreate)
{
    WCHAR pszPath[MAX_PATH] = L"";

    if (SHGetSpecialFolderPathW(nullptr, pszPath, nFolder, fCreate)) {
        return fs::path(pszPath);
    }

    LogError("SHGetSpecialFolderPathW() failed, could not obtain requested path.");
    return fs::path("");
}
#endif

bool RenameOver(fs::path src, fs::path dest)
{
    std::error_code error;
    fs::rename(src, dest, error);
    return !error;
}

/**
 * Ignores exceptions thrown by create_directories if the requested directory exists.
 * Specifically handles case where path p exists, but it wasn't possible for the user to
 * write to the parent directory.
 */
bool TryCreateDirectories(const fs::path& p)
{
    try {
        return fs::create_directories(p);
    } catch (const fs::filesystem_error&) {
        if (!fs::exists(p) || !fs::is_directory(p))
            throw;
    }

    // create_directories didn't create the directory, it had to have existed already
    return false;
}

std::string PermsToSymbolicString(fs::perms p)
{
    std::string perm_str(9, '-');

    auto set_perm = [&](size_t pos, fs::perms required_perm, char letter) {
        if ((p & required_perm) != fs::perms::none) {
            perm_str[pos] = letter;
        }
    };

    set_perm(0, fs::perms::owner_read,   'r');
    set_perm(1, fs::perms::owner_write,  'w');
    set_perm(2, fs::perms::owner_exec,   'x');
    set_perm(3, fs::perms::group_read,   'r');
    set_perm(4, fs::perms::group_write,  'w');
    set_perm(5, fs::perms::group_exec,   'x');
    set_perm(6, fs::perms::others_read,  'r');
    set_perm(7, fs::perms::others_write, 'w');
    set_perm(8, fs::perms::others_exec,  'x');

    return perm_str;
}

std::optional<fs::perms> InterpretPermString(const std::string& s)
{
    if (s == "owner") {
        return fs::perms::owner_read | fs::perms::owner_write;
    } else if (s == "group") {
        return fs::perms::owner_read | fs::perms::owner_write |
               fs::perms::group_read;
    } else if (s == "all") {
        return fs::perms::owner_read | fs::perms::owner_write |
               fs::perms::group_read |
               fs::perms::others_read;
    } else {
        return std::nullopt;
    }
}

bool IsDirWritable(const fs::path& dir_path)
{
    // Attempt to create a tmp file in the directory
    if (!fs::is_directory(dir_path)) throw std::runtime_error(strprintf("Path %s is not a directory", fs::PathToString(dir_path)));
    FastRandomContext rng;
    const auto tmp = dir_path / fs::PathFromString(strprintf(".tmp_%d", rng.rand64()));

    const char* mode;
#ifdef __MINGW64__
    mode = "w"; // Temporary workaround for https://github.com/bitcoin/bitcoin/issues/30210
#else
    mode = "wx";
#endif

    if (const auto created{fsbridge::fopen(tmp, mode)}) {
        std::fclose(created);
        std::error_code ec;
        fs::remove(tmp, ec); // clean up, ignore errors
        return true;
    }
    return false;
}

#ifdef __APPLE__
FSType GetFilesystemType(const fs::path& path)
{
    if (struct statfs fs_info; statfs(path.c_str(), &fs_info)) {
        return FSType::ERROR;
    } else if (std::string_view{fs_info.f_fstypename} == "exfat") {
        return FSType::EXFAT;
    }
    return FSType::OTHER;
}
#endif

Coverage Report

Created: 2026-07-14 18:13

Line	Count	Source
1		// Copyright (c) 2009-2010 Satoshi Nakamoto
2		// Copyright (c) 2009-present The Bitcoin Core developers
3		// Distributed under the MIT software license, see the accompanying
4		// file COPYING or http://www.opensource.org/licenses/mit-license.php.
5
6		#include <bitcoin-build-config.h> // IWYU pragma: keep
7
8		#include <util/fs_helpers.h>
9		#include <random.h>
10		#include <sync.h>
11		#include <tinyformat.h>
12		#include <util/byte_units.h> // IWYU pragma: keep
13		#include <util/check.h>
14		#include <util/fs.h>
15		#include <util/log.h>
16		#include <util/syserror.h>
17
18		#include <cerrno>
19		#include <fstream>
20		#include <limits>
21		#include <map>
22		#include <memory>
23		#include <optional>
24		#include <stdexcept>
25		#include <string>
26		#include <system_error>
27		#include <utility>
28
29		#ifndef WIN32
30		#include <fcntl.h>
31		#include <sys/resource.h>
32		#include <sys/types.h>
33		#include <unistd.h>
34		#else
35		#include <io.h>
36		#include <shlobj.h>
37		#endif // WIN32
38
39		#ifdef __APPLE__
40		#include <sys/mount.h>
41		#include <sys/param.h>
42		#endif
43
44		/** Mutex to protect dir_locks. */
45		static GlobalMutex cs_dir_locks;
46		/** A map that contains all the currently held directory locks. After
47		* successful locking, these will be held here until the global destructor
48		* cleans them up and thus automatically unlocks them, or ReleaseDirectoryLocks
49		* is called.
50		*/
51		static std::map<std::string, std::unique_ptr<fsbridge::FileLock>> dir_locks GUARDED_BY(cs_dir_locks);
52		namespace util {
53		LockResult LockDirectory(const fs::path& directory, const fs::path& lockfile_name, bool probe_only)
54	108	{
55	108	LOCK(cs_dir_locks);
56	108	fs::path pathLockFile = directory / lockfile_name;
57
58		// If a lock for this directory already exists in the map, don't try to re-lock it
59	108	if (dir_locks.contains(fs::PathToString(pathLockFile))) { Branch (59:9): [True: 0, False: 108]
60	0	return LockResult::Success;
61	0	}
62
63		// Create empty lock file if it doesn't exist.
64	108	if (auto created{fsbridge::fopen(pathLockFile, "a")}) { Branch (64:14): [True: 108, False: 0]
65	108	std::fclose(created);
66	108	} else {
67	0	return LockResult::ErrorWrite;
68	0	}
69	108	auto lock = std::make_unique<fsbridge::FileLock>(pathLockFile);
70	108	if (!lock->TryLock()) { Branch (70:9): [True: 0, False: 108]
71	0	LogError("Error while attempting to lock directory %s: %s\n", fs::PathToString(directory), lock->GetReason());
72	0	return LockResult::ErrorLock;
73	0	}
74	108	if (!probe_only) { Branch (74:9): [True: 54, False: 54]
75		// Lock successful and we're not just probing, put it into the map
76	54	dir_locks.emplace(fs::PathToString(pathLockFile), std::move(lock));
77	54	}
78	108	return LockResult::Success;
79	108	}
80		} // namespace util
81		void UnlockDirectory(const fs::path& directory, const fs::path& lockfile_name)
82	0	{
83	0	LOCK(cs_dir_locks);
84	0	dir_locks.erase(fs::PathToString(directory / lockfile_name));
85	0	}
86
87		void ReleaseDirectoryLocks()
88	0	{
89	0	LOCK(cs_dir_locks);
90	0	dir_locks.clear();
91	0	}
92
93		bool CheckDiskSpace(const fs::path& dir, uint64_t additional_bytes)
94	680k	{
95	680k	constexpr uint64_t min_disk_space{50_MiB};
96
97	680k	uint64_t free_bytes_available = fs::space(dir).available;
98	680k	return free_bytes_available >= min_disk_space + additional_bytes;
99	680k	}
100
101		std::streampos GetFileSize(const char* path, std::streamsize max)
102	0	{
103	0	std::ifstream file{path, std::ios::binary};
104	0	file.ignore(max);
105	0	return file.gcount();
106	0	}
107
108		bool FileCommit(FILE* file)
109	1.13M	{
110	1.13M	if (fflush(file) != 0) { // harmless if redundantly called Branch (110:9): [True: 0, False: 1.13M]
111	0	LogError("fflush failed: %s", SysErrorString(errno));
112	0	return false;
113	0	}
114		#ifdef WIN32
115		HANDLE hFile = (HANDLE)_get_osfhandle(_fileno(file));
116		if (FlushFileBuffers(hFile) == 0) {
117		LogError("FlushFileBuffers failed: %s", Win32ErrorString(GetLastError()));
118		return false;
119		}
120		#elif defined(__APPLE__) && defined(F_FULLFSYNC)
121		if (fcntl(fileno(file), F_FULLFSYNC, 0) == -1) { // Manpage says "value other than -1" is returned on success
122		LogError("fcntl F_FULLFSYNC failed: %s", SysErrorString(errno));
123		return false;
124		}
125		#elif HAVE_FDATASYNC
126	1.13M	if (fdatasync(fileno(file)) != 0 && errno != EINVAL) { // Ignore EINVAL for filesystems that don't support sync Branch (126:9): [True: 0, False: 1.13M] Branch (126:41): [True: 0, False: 0]
127	0	LogError("fdatasync failed: %s", SysErrorString(errno));
128	0	return false;
129	0	}
130		#else
131		if (fsync(fileno(file)) != 0 && errno != EINVAL) {
132		LogError("fsync failed: %s", SysErrorString(errno));
133		return false;
134		}
135		#endif
136	1.13M	return true;
137	1.13M	}
138
139		void DirectoryCommit(const fs::path& dirname)
140	611k	{
141	611k	#ifndef WIN32
142	611k	FILE* file = fsbridge::fopen(dirname, "r");
143	611k	if (file) { Branch (143:9): [True: 611k, False: 0]
144	611k	fsync(fileno(file));
145	611k	fclose(file);
146	611k	}
147	611k	#endif
148	611k	}
149
150		bool TruncateFile(FILE* file, unsigned int length)
151	0	{
152		#if defined(WIN32)
153		return _chsize(_fileno(file), length) == 0;
154		#else
155	0	return ftruncate(fileno(file), length) == 0;
156	0	#endif
157	0	}
158
159		int RaiseFileDescriptorLimit(int min_fd)
160	27	{
161	27	Assert(min_fd >= 0);
162		#if defined(WIN32)
163		return 2048;
164		#else
165	27	struct rlimit limitFD;
166	27	if (getrlimit(RLIMIT_NOFILE, &limitFD) != -1) { Branch (166:9): [True: 27, False: 0]
167		// If the current soft limit is already higher, don't raise it
168	27	if (limitFD.rlim_cur != RLIM_INFINITY && std::cmp_less(limitFD.rlim_cur, min_fd)) { Branch (168:13): [True: 27, False: 0] Branch (168:50): [True: 0, False: 27]
169	0	const auto current_limit{limitFD.rlim_cur};
170	0	static_assert(std::in_range<rlim_t>(std::numeric_limits<int>::max()));
171	0	limitFD.rlim_cur = static_cast<rlim_t>(min_fd);
172		// Don't raise soft limit beyond hard limit
173	0	if ((limitFD.rlim_max != RLIM_INFINITY) && (limitFD.rlim_cur > limitFD.rlim_max)) { Branch (173:17): [True: 0, False: 0] Branch (173:56): [True: 0, False: 0]
174	0	limitFD.rlim_cur = limitFD.rlim_max;
175	0	}
176	0	if (current_limit != limitFD.rlim_cur) { Branch (176:17): [True: 0, False: 0]
177	0	setrlimit(RLIMIT_NOFILE, &limitFD);
178	0	getrlimit(RLIMIT_NOFILE, &limitFD);
179	0	}
180	0	}
181		// Check the (possibly raised) current soft limit against the special
182		// value of RLIM_INFINITY. Some platforms implement this as the maximum
183		// uint64, others as int64 (-1). Avoid casting even if the return type
184		// is changed to uint64_t. We also cap unlikely but possible values
185		// that would overflow int.
186	27	if (limitFD.rlim_cur == RLIM_INFINITY \|\| Branch (186:13): [True: 0, False: 27]
187	27	std::cmp_greater_equal(limitFD.rlim_cur, std::numeric_limits<int>::max())) { Branch (187:13): [True: 0, False: 27]
188	0	return std::numeric_limits<int>::max();
189	0	}
190	27	return static_cast<int>(limitFD.rlim_cur);
191	27	}
192	0	return min_fd; // getrlimit failed, assume it's fine
193	27	#endif
194	27	}
195
196		/**
197		* this function tries to make a particular range of a file allocated (corresponding to disk space)
198		* it is advisory, and the range specified in the arguments will never contain live data
199		*/
200		void AllocateFileRange(FILE* file, unsigned int offset, unsigned int length)
201	54	{
202		#if defined(WIN32)
203		// Windows-specific version
204		HANDLE hFile = (HANDLE)_get_osfhandle(_fileno(file));
205		LARGE_INTEGER nFileSize;
206		int64_t nEndPos = (int64_t)offset + length;
207		nFileSize.u.LowPart = nEndPos & 0xFFFFFFFF;
208		nFileSize.u.HighPart = nEndPos >> 32;
209		SetFilePointerEx(hFile, nFileSize, 0, FILE_BEGIN);
210		SetEndOfFile(hFile);
211		#elif defined(__APPLE__)
212		// OSX specific version
213		// NOTE: Contrary to other OS versions, the OSX version assumes that
214		// NOTE: offset is the size of the file.
215		fstore_t fst;
216		fst.fst_flags = F_ALLOCATECONTIG;
217		fst.fst_posmode = F_PEOFPOSMODE;
218		fst.fst_offset = 0;
219		fst.fst_length = length; // mac os fst_length takes the # of free bytes to allocate, not desired file size
220		fst.fst_bytesalloc = 0;
221		if (fcntl(fileno(file), F_PREALLOCATE, &fst) == -1) {
222		fst.fst_flags = F_ALLOCATEALL;
223		fcntl(fileno(file), F_PREALLOCATE, &fst);
224		}
225		ftruncate(fileno(file), static_cast<off_t>(offset) + length);
226		#else
227	54	#if defined(HAVE_POSIX_FALLOCATE)
228		// Version using posix_fallocate
229	54	off_t nEndPos = (off_t)offset + length;
230	54	if (0 == posix_fallocate(fileno(file), 0, nEndPos)) return; Branch (230:9): [True: 54, False: 0]
231	0	#endif
232		// Fallback version
233		// TODO: just write one byte per block
234	0	static const char buf[65536] = {};
235	0	if (fseek(file, offset, SEEK_SET)) { Branch (235:9): [True: 0, False: 0]
236	0	return;
237	0	}
238	0	while (length > 0) { Branch (238:12): [True: 0, False: 0]
239	0	unsigned int now = 65536;
240	0	if (length < now) Branch (240:13): [True: 0, False: 0]
241	0	now = length;
242	0	fwrite(buf, 1, now, file); // allowed to fail; this function is advisory anyway
243	0	length -= now;
244	0	}
245	0	#endif
246	0	}
247
248		#ifdef WIN32
249		fs::path GetSpecialFolderPath(int nFolder, bool fCreate)
250		{
251		WCHAR pszPath[MAX_PATH] = L"";
252
253		if (SHGetSpecialFolderPathW(nullptr, pszPath, nFolder, fCreate)) {
254		return fs::path(pszPath);
255		}
256
257		LogError("SHGetSpecialFolderPathW() failed, could not obtain requested path.");
258		return fs::path("");
259		}
260		#endif
261
262		bool RenameOver(fs::path src, fs::path dest)
263	365k	{
264	365k	std::error_code error;
265	365k	fs::rename(src, dest, error);
266	365k	return !error;
267	365k	}
268
269		/**
270		* Ignores exceptions thrown by create_directories if the requested directory exists.
271		* Specifically handles case where path p exists, but it wasn't possible for the user to
272		* write to the parent directory.
273		*/
274		bool TryCreateDirectories(const fs::path& p)
275	81	{
276	81	try {
277	81	return fs::create_directories(p);
278	81	} catch (const fs::filesystem_error&) {
279	0	if (!fs::exists(p) \|\| !fs::is_directory(p)) Branch (279:13): [True: 0, False: 0] Branch (279:31): [True: 0, False: 0]
280	0	throw;
281	0	}
282
283		// create_directories didn't create the directory, it had to have existed already
284	0	return false;
285	81	}
286
287		std::string PermsToSymbolicString(fs::perms p)
288	27	{
289	27	std::string perm_str(9, '-');
290
291	243	auto set_perm = [&](size_t pos, fs::perms required_perm, char letter) {
292	243	if ((p & required_perm) != fs::perms::none) { Branch (292:13): [True: 54, False: 189]
293	54	perm_str[pos] = letter;
294	54	}
295	243	};
296
297	27	set_perm(0, fs::perms::owner_read, 'r');
298	27	set_perm(1, fs::perms::owner_write, 'w');
299	27	set_perm(2, fs::perms::owner_exec, 'x');
300	27	set_perm(3, fs::perms::group_read, 'r');
301	27	set_perm(4, fs::perms::group_write, 'w');
302	27	set_perm(5, fs::perms::group_exec, 'x');
303	27	set_perm(6, fs::perms::others_read, 'r');
304	27	set_perm(7, fs::perms::others_write, 'w');
305	27	set_perm(8, fs::perms::others_exec, 'x');
306
307	27	return perm_str;
308	27	}
309
310		std::optional<fs::perms> InterpretPermString(const std::string& s)
311	0	{
312	0	if (s == "owner") { Branch (312:9): [True: 0, False: 0]
313	0	return fs::perms::owner_read \| fs::perms::owner_write;
314	0	} else if (s == "group") { Branch (314:16): [True: 0, False: 0]
315	0	return fs::perms::owner_read \| fs::perms::owner_write \|
316	0	fs::perms::group_read;
317	0	} else if (s == "all") { Branch (317:16): [True: 0, False: 0]
318	0	return fs::perms::owner_read \| fs::perms::owner_write \|
319	0	fs::perms::group_read \|
320	0	fs::perms::others_read;
321	0	} else {
322	0	return std::nullopt;
323	0	}
324	0	}
325
326		bool IsDirWritable(const fs::path& dir_path)
327	0	{
328		// Attempt to create a tmp file in the directory
329	0	if (!fs::is_directory(dir_path)) throw std::runtime_error(strprintf("Path %s is not a directory", fs::PathToString(dir_path))); Branch (329:9): [True: 0, False: 0]
330	0	FastRandomContext rng;
331	0	const auto tmp = dir_path / fs::PathFromString(strprintf(".tmp_%d", rng.rand64()));
332
333	0	const char* mode;
334		#ifdef __MINGW64__
335		mode = "w"; // Temporary workaround for https://github.com/bitcoin/bitcoin/issues/30210
336		#else
337	0	mode = "wx";
338	0	#endif
339
340	0	if (const auto created{fsbridge::fopen(tmp, mode)}) { Branch (340:20): [True: 0, False: 0]
341	0	std::fclose(created);
342	0	std::error_code ec;
343	0	fs::remove(tmp, ec); // clean up, ignore errors
344	0	return true;
345	0	}
346	0	return false;
347	0	}
348
349		#ifdef __APPLE__
350		FSType GetFilesystemType(const fs::path& path)
351		{
352		if (struct statfs fs_info; statfs(path.c_str(), &fs_info)) {
353		return FSType::ERROR;
354		} else if (std::string_view{fs_info.f_fstypename} == "exfat") {
355		return FSType::EXFAT;
356		}
357		return FSType::OTHER;
358		}
359		#endif