]>
git.ipfire.org Git - thirdparty/systemd.git/blob - src/basic/path-util.h
1 /* SPDX-License-Identifier: LGPL-2.1-or-later */
9 #include "string-util.h"
11 #include "time-util.h"
13 #define PATH_SPLIT_SBIN_BIN(x) x "sbin:" x "bin"
14 #define PATH_SPLIT_SBIN_BIN_NULSTR(x) x "sbin\0" x "bin\0"
16 #define PATH_NORMAL_SBIN_BIN(x) x "bin"
17 #define PATH_NORMAL_SBIN_BIN_NULSTR(x) x "bin\0"
20 # define PATH_SBIN_BIN(x) PATH_SPLIT_SBIN_BIN(x)
21 # define PATH_SBIN_BIN_NULSTR(x) PATH_SPLIT_SBIN_BIN_NULSTR(x)
23 # define PATH_SBIN_BIN(x) PATH_NORMAL_SBIN_BIN(x)
24 # define PATH_SBIN_BIN_NULSTR(x) PATH_NORMAL_SBIN_BIN_NULSTR(x)
27 #define DEFAULT_PATH_NORMAL PATH_SBIN_BIN("/usr/local/") ":" PATH_SBIN_BIN("/usr/")
28 #define DEFAULT_PATH_NORMAL_NULSTR PATH_SBIN_BIN_NULSTR("/usr/local/") PATH_SBIN_BIN_NULSTR("/usr/")
29 #define DEFAULT_PATH_SPLIT_USR DEFAULT_PATH_NORMAL ":" PATH_SBIN_BIN("/")
30 #define DEFAULT_PATH_SPLIT_USR_NULSTR DEFAULT_PATH_NORMAL_NULSTR PATH_SBIN_BIN_NULSTR("/")
31 #define DEFAULT_PATH_COMPAT PATH_SPLIT_SBIN_BIN("/usr/local/") ":" PATH_SPLIT_SBIN_BIN("/usr/") ":" PATH_SPLIT_SBIN_BIN("/")
34 # define DEFAULT_PATH DEFAULT_PATH_SPLIT_USR
35 # define DEFAULT_PATH_NULSTR DEFAULT_PATH_SPLIT_USR_NULSTR
37 # define DEFAULT_PATH DEFAULT_PATH_NORMAL
38 # define DEFAULT_PATH_NULSTR DEFAULT_PATH_NORMAL_NULSTR
41 #ifndef DEFAULT_USER_PATH
42 # define DEFAULT_USER_PATH DEFAULT_PATH
45 static inline bool is_path(const char *p
) {
46 if (!p
) /* A NULL pointer is definitely not a path */
49 return strchr(p
, '/');
52 static inline bool path_is_absolute(const char *p
) {
53 if (!p
) /* A NULL pointer is definitely not an absolute path */
59 int path_split_and_make_absolute(const char *p
, char ***ret
);
60 char* path_make_absolute(const char *p
, const char *prefix
);
61 int safe_getcwd(char **ret
);
62 int path_make_absolute_cwd(const char *p
, char **ret
);
63 int path_make_relative(const char *from
, const char *to
, char **ret
);
64 int path_make_relative_parent(const char *from_child
, const char *to
, char **ret
);
65 char *path_startswith_full(const char *path
, const char *prefix
, bool accept_dot_dot
) _pure_
;
66 static inline char* path_startswith(const char *path
, const char *prefix
) {
67 return path_startswith_full(path
, prefix
, true);
69 int path_compare(const char *a
, const char *b
) _pure_
;
71 static inline bool path_equal(const char *a
, const char *b
) {
72 return path_compare(a
, b
) == 0;
75 bool path_equal_or_files_same(const char *a
, const char *b
, int flags
);
76 /* Compares only the last portion of the input paths, ie: the filenames */
77 bool path_equal_filename(const char *a
, const char *b
);
79 char* path_extend_internal(char **x
, ...);
80 #define path_extend(x, ...) path_extend_internal(x, __VA_ARGS__, POINTER_MAX)
81 #define path_join(...) path_extend_internal(NULL, __VA_ARGS__, POINTER_MAX)
83 char* path_simplify(char *path
);
85 static inline bool path_equal_ptr(const char *a
, const char *b
) {
86 return !!a
== !!b
&& (!a
|| path_equal(a
, b
));
89 /* Note: the search terminates on the first NULL item. */
90 #define PATH_IN_SET(p, ...) path_strv_contains(STRV_MAKE(__VA_ARGS__), p)
92 char* path_startswith_strv(const char *p
, char **set
);
93 #define PATH_STARTSWITH_SET(p, ...) path_startswith_strv(p, STRV_MAKE(__VA_ARGS__))
95 int path_strv_make_absolute_cwd(char **l
);
96 char** path_strv_resolve(char **l
, const char *root
);
97 char** path_strv_resolve_uniq(char **l
, const char *root
);
99 int find_executable_full(const char *name
, const char *root
, char **exec_search_path
, bool use_path_envvar
, char **ret_filename
, int *ret_fd
);
100 static inline int find_executable(const char *name
, char **ret_filename
) {
101 return find_executable_full(name
, /* root= */ NULL
, NULL
, true, ret_filename
, NULL
);
104 bool paths_check_timestamp(const char* const* paths
, usec_t
*paths_ts_usec
, bool update
);
106 int fsck_exists(void);
107 int fsck_exists_for_fstype(const char *fstype
);
109 /* Iterates through the path prefixes of the specified path, going up
110 * the tree, to root. Also returns "" (and not "/"!) for the root
111 * directory. Excludes the specified directory itself */
112 #define PATH_FOREACH_PREFIX(prefix, path) \
113 for (char *_slash = ({ \
114 path_simplify(strcpy(prefix, path)); \
115 streq(prefix, "/") ? NULL : strrchr(prefix, '/'); \
117 _slash && ((*_slash = 0), true); \
118 _slash = strrchr((prefix), '/'))
120 /* Same as PATH_FOREACH_PREFIX but also includes the specified path itself */
121 #define PATH_FOREACH_PREFIX_MORE(prefix, path) \
122 for (char *_slash = ({ \
123 path_simplify(strcpy(prefix, path)); \
124 if (streq(prefix, "/")) \
126 strrchr(prefix, 0); \
128 _slash && ((*_slash = 0), true); \
129 _slash = strrchr((prefix), '/'))
131 /* Similar to path_join(), but only works for two components, and only the first one may be NULL and returns
132 * an alloca() buffer, or possibly a const pointer into the path parameter. */
133 #define prefix_roota(root, path) \
135 const char* _path = (path), *_root = (root), *_ret; \
138 while (_path[0] == '/' && _path[1] == '/') \
140 if (isempty(_root)) \
143 _l = strlen(_root) + 1 + strlen(_path) + 1; \
144 _n = newa(char, _l); \
145 _p = stpcpy(_n, _root); \
146 while (_p > _n && _p[-1] == '/') \
148 if (_path[0] != '/') \
156 int path_find_first_component(const char **p
, bool accept_dot_dot
, const char **ret
);
157 int path_find_last_component(const char *path
, bool accept_dot_dot
, const char **next
, const char **ret
);
158 const char *last_path_component(const char *path
);
159 int path_extract_filename(const char *path
, char **ret
);
160 int path_extract_directory(const char *path
, char **ret
);
162 bool filename_is_valid(const char *p
) _pure_
;
163 bool path_is_valid_full(const char *p
, bool accept_dot_dot
) _pure_
;
164 static inline bool path_is_valid(const char *p
) {
165 return path_is_valid_full(p
, /* accept_dot_dot= */ true);
167 static inline bool path_is_safe(const char *p
) {
168 return path_is_valid_full(p
, /* accept_dot_dot= */ false);
170 bool path_is_normalized(const char *p
) _pure_
;
172 char *file_in_same_dir(const char *path
, const char *filename
);
174 bool hidden_or_backup_file(const char *filename
) _pure_
;
176 bool is_device_path(const char *path
);
178 bool valid_device_node_path(const char *path
);
179 bool valid_device_allow_pattern(const char *path
);
181 bool dot_or_dot_dot(const char *path
);
183 static inline const char *skip_dev_prefix(const char *p
) {
186 /* Drop any /dev prefix if there is any */
188 e
= path_startswith(p
, "/dev/");
193 bool empty_or_root(const char *path
);
194 static inline const char *empty_to_root(const char *path
) {
195 return isempty(path
) ? "/" : path
;
198 bool path_strv_contains(char **l
, const char *path
);
199 bool prefixed_path_strv_contains(char **l
, const char *path
);
201 int path_glob_can_match(const char *pattern
, const char *prefix
, char **ret
);