Bitcoin Core  31.0.0
P2P Digital Currency
fs_helpers.h
Go to the documentation of this file.
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 #ifndef BITCOIN_UTIL_FS_HELPERS_H
7 #define BITCOIN_UTIL_FS_HELPERS_H
8 
9 #include <util/fs.h>
10 
11 #include <cstdint>
12 #include <cstdio>
13 #include <iosfwd>
14 #include <limits>
15 #include <optional>
16 
17 #ifdef __APPLE__
18 enum class FSType {
19  EXFAT,
20  OTHER,
21  ERROR
22 };
23 
31 FSType GetFilesystemType(const fs::path& path);
32 #endif
33 
38 bool FileCommit(FILE* file);
39 
44 void DirectoryCommit(const fs::path& dirname);
45 
46 bool TruncateFile(FILE* file, unsigned int length);
47 int RaiseFileDescriptorLimit(int nMinFD);
48 void AllocateFileRange(FILE* file, unsigned int offset, unsigned int length);
49 
54 [[nodiscard]] bool RenameOver(fs::path src, fs::path dest);
55 
56 namespace util {
57 enum class LockResult {
58  Success,
59  ErrorWrite,
60  ErrorLock,
61 };
62 [[nodiscard]] LockResult LockDirectory(const fs::path& directory, const fs::path& lockfile_name, bool probe_only = false);
63 } // namespace util
64 void UnlockDirectory(const fs::path& directory, const fs::path& lockfile_name);
65 bool CheckDiskSpace(const fs::path& dir, uint64_t additional_bytes = 0);
66 
73 std::streampos GetFileSize(const char* path, std::streamsize max = std::numeric_limits<std::streamsize>::max());
74 
79 
80 bool TryCreateDirectories(const fs::path& p);
82 
88 std::string PermsToSymbolicString(fs::perms p);
94 std::optional<fs::perms> InterpretPermString(const std::string& s);
95 
96 #ifdef WIN32
97 fs::path GetSpecialFolderPath(int nFolder, bool fCreate = true);
98 #endif
99 
100 #endif // BITCOIN_UTIL_FS_HELPERS_H
std::optional< fs::perms > InterpretPermString(const std::string &s)
Interpret a custom permissions level string as fs::perms.
Definition: fs_helpers.cpp:291
bool RenameOver(fs::path src, fs::path dest)
Rename src to dest.
Definition: fs_helpers.cpp:243
bool TryCreateDirectories(const fs::path &p)
Ignores exceptions thrown by create_directories if the requested directory exists.
Definition: fs_helpers.cpp:255
fs::path GetDefaultDataDir()
Definition: args.cpp:757
int RaiseFileDescriptorLimit(int nMinFD)
this function tries to raise the file descriptor limit to the requested number.
Definition: fs_helpers.cpp:157
void UnlockDirectory(const fs::path &directory, const fs::path &lockfile_name)
Definition: fs_helpers.cpp:75
LockResult LockDirectory(const fs::path &directory, const fs::path &lockfile_name, bool probe_only)
Definition: fs_helpers.cpp:47
void AllocateFileRange(FILE *file, unsigned int offset, unsigned int length)
this function tries to make a particular range of a file allocated (corresponding to disk space) it i...
Definition: fs_helpers.cpp:181
std::string PermsToSymbolicString(fs::perms p)
Convert fs::perms to symbolic string of the form &#39;rwxrwxrwx&#39;.
Definition: fs_helpers.cpp:268
void DirectoryCommit(const fs::path &dirname)
Sync directory contents.
Definition: fs_helpers.cpp:133
LockResult
Definition: fs_helpers.h:57
bool CheckDiskSpace(const fs::path &dir, uint64_t additional_bytes=0)
Definition: fs_helpers.cpp:87
std::streampos GetFileSize(const char *path, std::streamsize max=std::numeric_limits< std::streamsize >::max())
Get the size of a file by scanning it.
Definition: fs_helpers.cpp:95
bool TruncateFile(FILE *file, unsigned int length)
Definition: fs_helpers.cpp:144
bool FileCommit(FILE *file)
Ensure file contents are fully committed to disk, using a platform-specific feature analogous to fsyn...
Definition: fs_helpers.cpp:102
Path class wrapper to block calls to the fs::path(std::string) implicit constructor and the fs::path:...
Definition: fs.h:33
void ReleaseDirectoryLocks()
Release all directory locks.
Definition: fs_helpers.cpp:81