src/basic/fs-util.h

   1 /* SPDX-License-Identifier: LGPL-2.1+ */
   2 #pragma once
   3
   4 #include <dirent.h>
   5 #include <fcntl.h>
   6 #include <limits.h>
   7 #include <stdbool.h>
   8 #include <stdint.h>
   9 #include <sys/inotify.h>
  10 #include <sys/types.h>
  11 #include <unistd.h>
  12
  13 #include "time-util.h"
  14 #include "util.h"
  15
  16 int unlink_noerrno(const char *path);
  17
  18 int rmdir_parents(const char *path, const char *stop);
  19
  20 int rename_noreplace(int olddirfd, const char *oldpath, int newdirfd, const char *newpath);
  21
  22 int readlinkat_malloc(int fd, const char *p, char **ret);
  23 int readlink_malloc(const char *p, char **r);
  24 int readlink_value(const char *p, char **ret);
  25 int readlink_and_make_absolute(const char *p, char **r);
  26
  27 int chmod_and_chown(const char *path, mode_t mode, uid_t uid, gid_t gid);
  28 int fchmod_and_chown(int fd, mode_t mode, uid_t uid, gid_t gid);
  29
  30 int fchmod_umask(int fd, mode_t mode);
  31 int fchmod_opath(int fd, mode_t m);
  32
  33 int fd_warn_permissions(const char *path, int fd);
  34
  35 #define laccess(path, mode) faccessat(AT_FDCWD, (path), (mode), AT_SYMLINK_NOFOLLOW)
  36
  37 int touch_file(const char *path, bool parents, usec_t stamp, uid_t uid, gid_t gid, mode_t mode);
  38 int touch(const char *path);
  39
  40 int symlink_idempotent(const char *from, const char *to, bool make_relative);
  41
  42 int symlink_atomic(const char *from, const char *to);
  43 int mknod_atomic(const char *path, mode_t mode, dev_t dev);
  44 int mkfifo_atomic(const char *path, mode_t mode);
  45 int mkfifoat_atomic(int dir_fd, const char *path, mode_t mode);
  46
  47 int get_files_in_directory(const char *path, char ***list);
  48
  49 int tmp_dir(const char **ret);
  50 int var_tmp_dir(const char **ret);
  51
  52 int unlink_or_warn(const char *filename);
  53
  54 #define INOTIFY_EVENT_MAX (sizeof(struct inotify_event) + NAME_MAX + 1)
  55
  56 #define FOREACH_INOTIFY_EVENT(e, buffer, sz) \
  57         for ((e) = &buffer.ev;                                \
  58              (uint8_t*) (e) < (uint8_t*) (buffer.raw) + (sz); \
  59              (e) = (struct inotify_event*) ((uint8_t*) (e) + sizeof(struct inotify_event) + (e)->len))
  60
  61 union inotify_event_buffer {
  62         struct inotify_event ev;
  63         uint8_t raw[INOTIFY_EVENT_MAX];
  64 };
  65
  66 int inotify_add_watch_fd(int fd, int what, uint32_t mask);
  67
  68 enum {
  69         CHASE_PREFIX_ROOT = 1 << 0, /* If set, the specified path will be prefixed by the specified root before beginning the iteration */
  70         CHASE_NONEXISTENT = 1 << 1, /* If set, it's OK if the path doesn't actually exist. */
  71         CHASE_NO_AUTOFS   = 1 << 2, /* If set, return -EREMOTE if autofs mount point found */
  72         CHASE_SAFE        = 1 << 3, /* If set, return EPERM if we ever traverse from unprivileged to privileged files or directories */
  73         CHASE_OPEN        = 1 << 4, /* If set, return an O_PATH object to the final component */
  74         CHASE_TRAIL_SLASH = 1 << 5, /* If set, any trailing slash will be preserved */
  75         CHASE_STEP        = 1 << 6, /* If set, just execute a single step of the normalization */
  76         CHASE_NOFOLLOW    = 1 << 7, /* Only valid with CHASE_OPEN: when the path's right-most component refers to symlink return O_PATH fd of the symlink, rather than following it. */
  77         CHASE_WARN        = 1 << 8, /* Emit an appropriate warning when an error is encountered */
  78 };
  79
  80 /* How many iterations to execute before returning -ELOOP */
  81 #define CHASE_SYMLINKS_MAX 32
  82
  83 int chase_symlinks(const char *path_with_prefix, const char *root, unsigned flags, char **ret);
  84
  85 int chase_symlinks_and_open(const char *path, const char *root, unsigned chase_flags, int open_flags, char **ret_path);
  86 int chase_symlinks_and_opendir(const char *path, const char *root, unsigned chase_flags, char **ret_path, DIR **ret_dir);
  87 int chase_symlinks_and_stat(const char *path, const char *root, unsigned chase_flags, char **ret_path, struct stat *ret_stat);
  88
  89 /* Useful for usage with _cleanup_(), removes a directory and frees the pointer */
  90 static inline void rmdir_and_free(char *p) {
  91         PROTECT_ERRNO;
  92         (void) rmdir(p);
  93         free(p);
  94 }
  95 DEFINE_TRIVIAL_CLEANUP_FUNC(char*, rmdir_and_free);
  96
  97 static inline void unlink_and_free(char *p) {
  98         (void) unlink_noerrno(p);
  99         free(p);
 100 }
 101 DEFINE_TRIVIAL_CLEANUP_FUNC(char*, unlink_and_free);
 102
 103 int access_fd(int fd, int mode);
 104
 105 void unlink_tempfilep(char (*p)[]);
 106 int unlinkat_deallocate(int fd, const char *name, int flags);
 107
 108 int fsync_directory_of_file(int fd);
 109 int fsync_path_at(int at_fd, const char *path);
 110
 111 int open_parent(const char *path, int flags, mode_t mode);