]>
git.ipfire.org Git - thirdparty/systemd.git/blob - src/basic/fs-util.h
1 /* SPDX-License-Identifier: LGPL-2.1+ */
5 Copyright 2010 Lennart Poettering
13 #include <sys/inotify.h>
14 #include <sys/types.h>
17 #include "time-util.h"
20 int unlink_noerrno(const char *path
);
22 int rmdir_parents(const char *path
, const char *stop
);
24 int rename_noreplace(int olddirfd
, const char *oldpath
, int newdirfd
, const char *newpath
);
26 int readlinkat_malloc(int fd
, const char *p
, char **ret
);
27 int readlink_malloc(const char *p
, char **r
);
28 int readlink_value(const char *p
, char **ret
);
29 int readlink_and_make_absolute(const char *p
, char **r
);
31 int chmod_and_chown(const char *path
, mode_t mode
, uid_t uid
, gid_t gid
);
33 int fchmod_umask(int fd
, mode_t mode
);
34 int fchmod_opath(int fd
, mode_t m
);
36 int fd_warn_permissions(const char *path
, int fd
);
38 #define laccess(path, mode) faccessat(AT_FDCWD, (path), (mode), AT_SYMLINK_NOFOLLOW)
40 int touch_file(const char *path
, bool parents
, usec_t stamp
, uid_t uid
, gid_t gid
, mode_t mode
);
41 int touch(const char *path
);
43 int symlink_idempotent(const char *from
, const char *to
);
45 int symlink_atomic(const char *from
, const char *to
);
46 int mknod_atomic(const char *path
, mode_t mode
, dev_t dev
);
47 int mkfifo_atomic(const char *path
, mode_t mode
);
49 int get_files_in_directory(const char *path
, char ***list
);
51 int tmp_dir(const char **ret
);
52 int var_tmp_dir(const char **ret
);
54 int unlink_or_warn(const char *filename
);
56 #define INOTIFY_EVENT_MAX (sizeof(struct inotify_event) + NAME_MAX + 1)
58 #define FOREACH_INOTIFY_EVENT(e, buffer, sz) \
59 for ((e) = &buffer.ev; \
60 (uint8_t*) (e) < (uint8_t*) (buffer.raw) + (sz); \
61 (e) = (struct inotify_event*) ((uint8_t*) (e) + sizeof(struct inotify_event) + (e)->len))
63 union inotify_event_buffer
{
64 struct inotify_event ev
;
65 uint8_t raw
[INOTIFY_EVENT_MAX
];
68 int inotify_add_watch_fd(int fd
, int what
, uint32_t mask
);
71 CHASE_PREFIX_ROOT
= 1 << 0, /* If set, the specified path will be prefixed by the specified root before beginning the iteration */
72 CHASE_NONEXISTENT
= 1 << 1, /* If set, it's OK if the path doesn't actually exist. */
73 CHASE_NO_AUTOFS
= 1 << 2, /* If set, return -EREMOTE if autofs mount point found */
74 CHASE_SAFE
= 1 << 3, /* If set, return EPERM if we ever traverse from unprivileged to privileged files or directories */
75 CHASE_OPEN
= 1 << 4, /* If set, return an O_PATH object to the final component */
76 CHASE_TRAIL_SLASH
= 1 << 5, /* If set, any trailing slash will be preserved */
77 CHASE_STEP
= 1 << 6, /* If set, just execute a single step of the normalization */
80 /* How many iterations to execute before returning -ELOOP */
81 #define CHASE_SYMLINKS_MAX 32
83 int chase_symlinks(const char *path_with_prefix
, const char *root
, unsigned flags
, char **ret
);
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
);
89 /* Useful for usage with _cleanup_(), removes a directory and frees the pointer */
90 static inline void rmdir_and_free(char *p
) {
95 DEFINE_TRIVIAL_CLEANUP_FUNC(char*, rmdir_and_free
);
97 static inline void unlink_and_free(char *p
) {
98 (void) unlink_noerrno(p
);
101 DEFINE_TRIVIAL_CLEANUP_FUNC(char*, unlink_and_free
);
103 int access_fd(int fd
, int mode
);
105 void unlink_tempfilep(char (*p
)[]);
106 int unlinkat_deallocate(int fd
, const char *name
, int flags
);
108 int fsync_directory_of_file(int fd
);