/* SPDX-License-Identifier: LGPL-2.1-or-later */

#pragma once

#include <dirent.h>

#include <fcntl.h>

#include <limits.h>

#include <stdbool.h>

#include <stdint.h>

#include <sys/stat.h>

#include <sys/types.h>

#include <unistd.h>

#include "alloc-util.h"

#include "errno-util.h"

#include "time-util.h"

#include "user-util.h"

#define MODE_INVALID ((mode_t) -1)

/* The following macros add 1 when converting things, since 0 is a valid mode, while the pointer

 * NULL is special */

#define PTR_TO_MODE(p) ((mode_t) ((uintptr_t) (p)-1))

#define MODE_TO_PTR(u) ((void *) ((uintptr_t) (u)+1))

int unlink_noerrno(const char *path);

int rmdir_parents(const char *path, const char *stop);

int rename_noreplace(int olddirfd, const char *oldpath, int newdirfd, const char *newpath);

int readlinkat_malloc(int fd, const char *p, char **ret);

int readlink_malloc(const char *p, char **r);

int readlink_value(const char *p, char **ret);

int readlink_and_make_absolute(const char *p, char **r);

int chmod_and_chown(const char *path, mode_t mode, uid_t uid, gid_t gid);

int fchmod_and_chown_with_fallback(int fd, const char *path, mode_t mode, uid_t uid, gid_t gid);

static inline int fchmod_and_chown(int fd, mode_t mode, uid_t uid, gid_t gid) {

        return fchmod_and_chown_with_fallback(fd, NULL, mode, uid, gid); /* no fallback */

}

int fchmod_umask(int fd, mode_t mode);

int fchmod_opath(int fd, mode_t m);

int futimens_opath(int fd, const struct timespec ts[2]);

int fd_warn_permissions(const char *path, int fd);

int stat_warn_permissions(const char *path, const struct stat *st);

#define laccess(path, mode)                                             \

        RET_NERRNO(faccessat(AT_FDCWD, (path), (mode), AT_SYMLINK_NOFOLLOW))

int touch_file(const char *path, bool parents, usec_t stamp, uid_t uid, gid_t gid, mode_t mode);

static inline int touch(const char *path) {

        return touch_file(path, false, USEC_INFINITY, UID_INVALID, GID_INVALID, MODE_INVALID);

}

int symlink_idempotent(const char *from, const char *to, bool make_relative);

int symlinkat_atomic_full(const char *from, int atfd, const char *to, bool make_relative);

static inline int symlink_atomic(const char *from, const char *to) {

        return symlinkat_atomic_full(from, AT_FDCWD, to, false);

}

int mknodat_atomic(int atfd, const char *path, mode_t mode, dev_t dev);

static inline int mknod_atomic(const char *path, mode_t mode, dev_t dev) {

        return mknodat_atomic(AT_FDCWD, path, mode, dev);

}

int mkfifoat_atomic(int dir_fd, const char *path, mode_t mode);

static inline int mkfifo_atomic(const char *path, mode_t mode) {

        return mkfifoat_atomic(AT_FDCWD, path, mode);

}

int get_files_in_directory(const char *path, char ***list);

int tmp_dir(const char **ret);

int var_tmp_dir(const char **ret);

int unlink_or_warn(const char *filename);

/* Useful for usage with _cleanup_(), removes a directory and frees the pointer */

static inline char *rmdir_and_free(char *p) {

        PROTECT_ERRNO;

        if (!p)

                return NULL;

        (void) rmdir(p);

        return mfree(p);

}

DEFINE_TRIVIAL_CLEANUP_FUNC(char*, rmdir_and_free);

static inline char* unlink_and_free(char *p) {

        if (!p)

                return NULL;

        (void) unlink_noerrno(p);

        return mfree(p);

}

DEFINE_TRIVIAL_CLEANUP_FUNC(char*, unlink_and_free);

int access_fd(int fd, int mode);

void unlink_tempfilep(char (*p)[]);

typedef enum UnlinkDeallocateFlags {

        UNLINK_REMOVEDIR = 1 << 0,

        UNLINK_ERASE     = 1 << 1,

} UnlinkDeallocateFlags;

int unlinkat_deallocate(int fd, const char *name, UnlinkDeallocateFlags flags);

int open_parent(const char *path, int flags, mode_t mode);

int conservative_renameat(int olddirfd, const char *oldpath, int newdirfd, const char *newpath);

static inline int conservative_rename(const char *oldpath, const char *newpath) {

        return conservative_renameat(AT_FDCWD, oldpath, AT_FDCWD, newpath);

}

int posix_fallocate_loop(int fd, uint64_t offset, uint64_t size);

int parse_cifs_service(const char *s, char **ret_host, char **ret_service, char **ret_path);

int open_mkdir_at(int dirfd, const char *path, int flags, mode_t mode);

int openat_report_new(int dirfd, const char *pathname, int flags, mode_t mode, bool *ret_newly_created);