1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
|
// **************************************************************************
// * This file is part of the FreeFileSync project. It is distributed under *
// * GNU General Public License: http://www.gnu.org/licenses/gpl-3.0 *
// * Copyright (C) Zenju (zenju AT gmx DOT de) - All Rights Reserved *
// **************************************************************************
#ifndef FILE_ACCESS_H_8017341345614857
#define FILE_ACCESS_H_8017341345614857
#include <functional>
#include "zstring.h"
#include "file_error.h"
#include "file_id_def.h"
namespace zen
{
bool fileExists (const Zstring& filepath); //noexcept; check whether file or file-symlink exists
bool dirExists (const Zstring& dirpath ); //noexcept; check whether directory or dir-symlink exists
bool symlinkExists (const Zstring& linkname); //noexcept; check whether a symbolic link exists
bool somethingExists(const Zstring& objname ); //noexcept; check whether any object with this name exists
enum class ProcSymlink
{
DIRECT,
FOLLOW
};
void setFileTime(const Zstring& filepath, std::int64_t modificationTime, ProcSymlink procSl); //throw FileError
//symlink handling: always evaluate target
std::uint64_t getFilesize(const Zstring& filepath); //throw FileError
std::uint64_t getFreeDiskSpace(const Zstring& path); //throw FileError, returns 0 if not available
bool removeFile(const Zstring& filepath); //throw FileError; return "false" if file is not existing
void removeDirectory(const Zstring& directory, //throw FileError
const std::function<void (const Zstring& filepath)>& onBeforeFileDeletion = nullptr, //optional;
const std::function<void (const Zstring& dirpath )>& onBeforeDirDeletion = nullptr); //one call for each *existing* object!
//rename file or directory: no copying!!!
void renameFile(const Zstring& itemPathOld, const Zstring& itemPathNew); //throw FileError, ErrorDifferentVolume, ErrorTargetExisting
bool supportsPermissions(const Zstring& dirpath); //throw FileError, dereferences symlinks
//if parent directory not existing: create recursively:
void makeNewDirectory(const Zstring& directory); //throw FileError, ErrorTargetExisting
//fail if already existing or parent directory not existing:
//directory should not end with path separator
void copyNewDirectory(const Zstring& sourcePath, const Zstring& targetPath, bool copyFilePermissions); //throw FileError, ErrorTargetExisting, ErrorTargetPathMissing
void copySymlink(const Zstring& sourceLink, const Zstring& targetLink, bool copyFilePermissions); //throw FileError
struct InSyncAttributes
{
std::uint64_t fileSize;
std::int64_t modificationTime; //time_t UTC compatible
FileId sourceFileId;
FileId targetFileId;
};
InSyncAttributes copyNewFile(const Zstring& sourceFile, const Zstring& targetFile, bool copyFilePermissions, //throw FileError, ErrorTargetExisting, ErrorFileLocked
//accummulated delta != file size! consider ADS, sparse, compressed files
const std::function<void(std::int64_t bytesDelta)>& onUpdateCopyStatus); //may be nullptr; throw X!
}
#endif //FILE_ACCESS_H_8017341345614857
|
