b3cade0c27
This adds two optional functions that may be passed to the various copy functions. One is invoked whenever we start copying a new file object, the other while we copy file payload in each loop iteration. When the caller passes one or both they can get notifications about copy progress, for example to log where things are.
61 lines
3.6 KiB
C
61 lines
3.6 KiB
C
/* SPDX-License-Identifier: LGPL-2.1+ */
|
|
#pragma once
|
|
|
|
#include <fcntl.h>
|
|
#include <inttypes.h>
|
|
#include <stdbool.h>
|
|
#include <stdint.h>
|
|
#include <sys/stat.h>
|
|
#include <sys/types.h>
|
|
|
|
typedef enum CopyFlags {
|
|
COPY_REFLINK = 1 << 0, /* Try to reflink */
|
|
COPY_MERGE = 1 << 1, /* Merge existing trees with our new one to copy */
|
|
COPY_REPLACE = 1 << 2, /* Replace an existing file if there's one */
|
|
COPY_SAME_MOUNT = 1 << 3, /* Don't descend recursively into other file systems, across mount point boundaries */
|
|
} CopyFlags;
|
|
|
|
typedef int (*copy_progress_bytes_t)(uint64_t n_bytes, void *userdata);
|
|
typedef int (*copy_progress_path_t)(const char *path, const struct stat *st, void *userdata);
|
|
|
|
int copy_file_fd_full(const char *from, int to, CopyFlags copy_flags, copy_progress_bytes_t progress, void *userdata);
|
|
static inline int copy_file_fd(const char *from, int to, CopyFlags copy_flags) {
|
|
return copy_file_fd_full(from, to, copy_flags, NULL, NULL);
|
|
}
|
|
|
|
int copy_file_full(const char *from, const char *to, int open_flags, mode_t mode, unsigned chattr_flags, CopyFlags copy_flags, copy_progress_bytes_t progress, void *userdata);
|
|
static inline int copy_file(const char *from, const char *to, int open_flags, mode_t mode, unsigned chattr_flags, CopyFlags copy_flags) {
|
|
return copy_file_full(from, to, open_flags, mode, chattr_flags, copy_flags, NULL, NULL);
|
|
}
|
|
|
|
int copy_file_atomic_full(const char *from, const char *to, mode_t mode, unsigned chattr_flags, CopyFlags copy_flags, copy_progress_bytes_t progress, void *userdata);
|
|
static inline int copy_file_atomic(const char *from, const char *to, mode_t mode, unsigned chattr_flags, CopyFlags copy_flags) {
|
|
return copy_file_atomic_full(from, to, mode, chattr_flags, copy_flags, NULL, NULL);
|
|
}
|
|
|
|
int copy_tree_at_full(int fdf, const char *from, int fdt, const char *to, uid_t override_uid, gid_t override_gid, CopyFlags copy_flags, copy_progress_path_t progress_path, copy_progress_bytes_t progress_bytes, void *userdata);
|
|
static inline int copy_tree_at(int fdf, const char *from, int fdt, const char *to, uid_t override_uid, gid_t override_gid, CopyFlags copy_flags) {
|
|
return copy_tree_at_full(fdf, from, fdt, to, override_uid, override_gid, copy_flags, NULL, NULL, NULL);
|
|
}
|
|
static inline int copy_tree(const char *from, const char *to, uid_t override_uid, gid_t override_gid, CopyFlags copy_flags) {
|
|
return copy_tree_at_full(AT_FDCWD, from, AT_FDCWD, to, override_uid, override_gid, copy_flags, NULL, NULL, NULL);
|
|
}
|
|
|
|
int copy_directory_fd_full(int dirfd, const char *to, CopyFlags copy_flags, copy_progress_path_t progress_path, copy_progress_bytes_t progress_bytes, void *userdata);
|
|
static inline int copy_directory_fd(int dirfd, const char *to, CopyFlags copy_flags) {
|
|
return copy_directory_fd_full(dirfd, to, copy_flags, NULL, NULL, NULL);
|
|
}
|
|
|
|
int copy_directory_full(const char *from, const char *to, CopyFlags copy_flags, copy_progress_path_t progress_path, copy_progress_bytes_t progress_bytes, void *userdata);
|
|
static inline int copy_directory(const char *from, const char *to, CopyFlags copy_flags) {
|
|
return copy_directory_full(from, to, copy_flags, NULL, NULL, NULL);
|
|
}
|
|
|
|
int copy_bytes_full(int fdf, int fdt, uint64_t max_bytes, CopyFlags copy_flags, void **ret_remains, size_t *ret_remains_size, copy_progress_bytes_t progress, void *userdata);
|
|
static inline int copy_bytes(int fdf, int fdt, uint64_t max_bytes, CopyFlags copy_flags) {
|
|
return copy_bytes_full(fdf, fdt, max_bytes, copy_flags, NULL, NULL, NULL, NULL);
|
|
}
|
|
|
|
int copy_times(int fdf, int fdt);
|
|
int copy_xattr(int fdf, int fdt);
|