Bitcoin Core 31.99.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#include <string>
17
18#ifdef __APPLE__
19enum class FSType {
20 EXFAT,
21 OTHER,
22 ERROR
23};
24
32FSType GetFilesystemType(const fs::path& path);
33#endif
34
39bool FileCommit(FILE* file);
40
45void DirectoryCommit(const fs::path& dirname);
46
47bool TruncateFile(FILE* file, unsigned int length);
48
58int RaiseFileDescriptorLimit(int min_fd);
59
60void AllocateFileRange(FILE* file, unsigned int offset, unsigned int length);
61
66[[nodiscard]] bool RenameOver(fs::path src, fs::path dest);
67
68namespace util {
69enum class LockResult {
70 Success,
73};
74[[nodiscard]] LockResult LockDirectory(const fs::path& directory, const fs::path& lockfile_name, bool probe_only = false);
75} // namespace util
76void UnlockDirectory(const fs::path& directory, const fs::path& lockfile_name);
77bool CheckDiskSpace(const fs::path& dir, uint64_t additional_bytes = 0);
78
85std::streampos GetFileSize(const char* path, std::streamsize max = std::numeric_limits<std::streamsize>::max());
86
91
92bool TryCreateDirectories(const fs::path& p);
93fs::path GetDefaultDataDir();
94
100std::string PermsToSymbolicString(fs::perms p);
106std::optional<fs::perms> InterpretPermString(const std::string& s);
107
114bool IsDirWritable(const fs::path& dir_path);
115
116#ifdef WIN32
117fs::path GetSpecialFolderPath(int nFolder, bool fCreate = true);
118#endif
119
120#endif // BITCOIN_UTIL_FS_HELPERS_H
fs::path GetDefaultDataDir()
Definition: args.cpp:861
bool RenameOver(fs::path src, fs::path dest)
Rename src to dest.
Definition: fs_helpers.cpp:262
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:101
void DirectoryCommit(const fs::path &dirname)
Sync directory contents.
Definition: fs_helpers.cpp:139
int RaiseFileDescriptorLimit(int min_fd)
Try to raise the file descriptor limit to the requested number.
Definition: fs_helpers.cpp:159
void ReleaseDirectoryLocks()
Release all directory locks.
Definition: fs_helpers.cpp:87
bool IsDirWritable(const fs::path &dir_path)
Check if a directory is writable by creating a temporary file on it.
Definition: fs_helpers.cpp:326
bool TryCreateDirectories(const fs::path &p)
Ignores exceptions thrown by create_directories if the requested directory exists.
Definition: fs_helpers.cpp:274
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:200
std::optional< fs::perms > InterpretPermString(const std::string &s)
Interpret a custom permissions level string as fs::perms.
Definition: fs_helpers.cpp:310
bool TruncateFile(FILE *file, unsigned int length)
Definition: fs_helpers.cpp:150
bool CheckDiskSpace(const fs::path &dir, uint64_t additional_bytes=0)
Definition: fs_helpers.cpp:93
std::string PermsToSymbolicString(fs::perms p)
Convert fs::perms to symbolic string of the form 'rwxrwxrwx'.
Definition: fs_helpers.cpp:287
bool FileCommit(FILE *file)
Ensure file contents are fully committed to disk, using a platform-specific feature analogous to fsyn...
Definition: fs_helpers.cpp:108
void UnlockDirectory(const fs::path &directory, const fs::path &lockfile_name)
Definition: fs_helpers.cpp:81
LockResult
Definition: fs_helpers.h:69
LockResult LockDirectory(const fs::path &directory, const fs::path &lockfile_name, bool probe_only)
Definition: fs_helpers.cpp:53