]>
Commit | Line | Data |
---|---|---|
53e1b683 | 1 | /* SPDX-License-Identifier: LGPL-2.1+ */ |
76877b46 | 2 | #pragma once |
9eb977db | 3 | |
11c3a366 | 4 | #include <alloca.h> |
44a6b1b6 | 5 | #include <stdbool.h> |
11c3a366 | 6 | #include <stddef.h> |
9eb977db | 7 | |
44a6b1b6 | 8 | #include "macro.h" |
a6f72863 | 9 | #include "string-util.h" |
f5a9bd21 | 10 | #include "strv.h" |
8e184852 | 11 | #include "time-util.h" |
44a6b1b6 | 12 | |
0c300adf | 13 | #define PATH_SPLIT_SBIN_BIN(x) x "sbin:" x "bin" |
db11487d | 14 | #define PATH_SPLIT_BIN_SBIN(x) x "bin:" x "sbin" |
0c300adf LP |
15 | #define PATH_SPLIT_SBIN_BIN_NULSTR(x) x "sbin\0" x "bin\0" |
16 | ||
17 | #define PATH_NORMAL_SBIN_BIN(x) x "bin" | |
db11487d | 18 | #define PATH_NORMAL_BIN_SBIN(x) x "bin" |
0c300adf LP |
19 | #define PATH_NORMAL_SBIN_BIN_NULSTR(x) x "bin\0" |
20 | ||
671f0f8d | 21 | #if HAVE_SPLIT_BIN |
0c300adf | 22 | # define PATH_SBIN_BIN(x) PATH_SPLIT_SBIN_BIN(x) |
db11487d | 23 | # define PATH_BIN_SBIN(x) PATH_SPLIT_BIN_SBIN(x) |
0c300adf | 24 | # define PATH_SBIN_BIN_NULSTR(x) PATH_SPLIT_SBIN_BIN_NULSTR(x) |
671f0f8d | 25 | #else |
0c300adf | 26 | # define PATH_SBIN_BIN(x) PATH_NORMAL_SBIN_BIN(x) |
db11487d | 27 | # define PATH_BIN_SBIN(x) PATH_NORMAL_BIN_SBIN(x) |
0c300adf | 28 | # define PATH_SBIN_BIN_NULSTR(x) PATH_NORMAL_SBIN_BIN_NULSTR(x) |
671f0f8d ZJS |
29 | #endif |
30 | ||
31 | #define DEFAULT_PATH_NORMAL PATH_SBIN_BIN("/usr/local/") ":" PATH_SBIN_BIN("/usr/") | |
db11487d | 32 | #define DEFAULT_USER_PATH_NORMAL PATH_BIN_SBIN("/usr/local/") ":" PATH_BIN_SBIN("/usr/") |
2259e8fb | 33 | #define DEFAULT_PATH_NORMAL_NULSTR PATH_SBIN_BIN_NULSTR("/usr/local/") PATH_SBIN_BIN_NULSTR("/usr/") |
671f0f8d | 34 | #define DEFAULT_PATH_SPLIT_USR DEFAULT_PATH_NORMAL ":" PATH_SBIN_BIN("/") |
db11487d | 35 | #define DEFAULT_USER_PATH_SPLIT_USR DEFAULT_PATH_NORMAL ":" PATH_BIN_SBIN("/") |
2259e8fb | 36 | #define DEFAULT_PATH_SPLIT_USR_NULSTR DEFAULT_PATH_NORMAL_NULSTR PATH_SBIN_BIN_NULSTR("/") |
0c300adf | 37 | #define DEFAULT_PATH_COMPAT PATH_SPLIT_SBIN_BIN("/usr/local/") ":" PATH_SPLIT_SBIN_BIN("/usr/") ":" PATH_SPLIT_SBIN_BIN("/") |
e10a55fd | 38 | |
349cc4a5 | 39 | #if HAVE_SPLIT_USR |
e10a55fd | 40 | # define DEFAULT_PATH DEFAULT_PATH_SPLIT_USR |
db11487d | 41 | # define DEFAULT_USER_PATH DEFAULT_USER_PATH_SPLIT_USR |
2259e8fb | 42 | # define DEFAULT_PATH_NULSTR DEFAULT_PATH_SPLIT_USR_NULSTR |
c9d954b2 | 43 | #else |
e10a55fd | 44 | # define DEFAULT_PATH DEFAULT_PATH_NORMAL |
db11487d | 45 | # define DEFAULT_USER_PATH DEFAULT_USER_PATH_NORMAL |
2259e8fb | 46 | # define DEFAULT_PATH_NULSTR DEFAULT_PATH_NORMAL_NULSTR |
c9d954b2 ZJS |
47 | #endif |
48 | ||
44a6b1b6 | 49 | bool is_path(const char *p) _pure_; |
0f474365 | 50 | int path_split_and_make_absolute(const char *p, char ***ret); |
44a6b1b6 ZJS |
51 | bool path_is_absolute(const char *p) _pure_; |
52 | char* path_make_absolute(const char *p, const char *prefix); | |
a2556d25 | 53 | int safe_getcwd(char **ret); |
0f474365 | 54 | int path_make_absolute_cwd(const char *p, char **ret); |
7cb9c51c | 55 | int path_make_relative(const char *from_dir, const char *to_path, char **_r); |
44a6b1b6 | 56 | char* path_startswith(const char *path, const char *prefix) _pure_; |
2230852b | 57 | int path_compare(const char *a, const char *b) _pure_; |
44a6b1b6 | 58 | bool path_equal(const char *a, const char *b) _pure_; |
e3f791a2 | 59 | bool path_equal_or_files_same(const char *a, const char *b, int flags); |
652ef298 ZJS |
60 | char* path_join_internal(const char *first, ...); |
61 | #define path_join(x, ...) path_join_internal(x, __VA_ARGS__, (const char*) -1) | |
cd8194a3 | 62 | |
858d36c1 | 63 | char* path_simplify(char *path, bool kill_dots); |
44a6b1b6 | 64 | |
b47aa73a ZJS |
65 | enum { |
66 | PATH_CHECK_FATAL = 1 << 0, /* If not set, then error message is appended with 'ignoring'. */ | |
67 | PATH_CHECK_ABSOLUTE = 1 << 1, | |
68 | PATH_CHECK_RELATIVE = 1 << 2, | |
69 | }; | |
70 | ||
71 | int path_simplify_and_warn(char *path, unsigned flag, const char *unit, const char *filename, unsigned line, const char *lvalue); | |
72 | ||
24737c29 ZJS |
73 | static inline bool path_equal_ptr(const char *a, const char *b) { |
74 | return !!a == !!b && (!a || path_equal(a, b)); | |
75 | } | |
76 | ||
3ae5990c ZJS |
77 | /* Note: the search terminates on the first NULL item. */ |
78 | #define PATH_IN_SET(p, ...) \ | |
79 | ({ \ | |
6b228852 | 80 | char **_s; \ |
3ae5990c | 81 | bool _found = false; \ |
6b228852 LP |
82 | STRV_FOREACH(_s, STRV_MAKE(__VA_ARGS__)) \ |
83 | if (path_equal(p, *_s)) { \ | |
3ae5990c ZJS |
84 | _found = true; \ |
85 | break; \ | |
86 | } \ | |
87 | _found; \ | |
88 | }) | |
89 | ||
cc4d7d81 ZJS |
90 | char* path_startswith_strv(const char *p, char **set); |
91 | #define PATH_STARTSWITH_SET(p, ...) path_startswith_strv(p, STRV_MAKE(__VA_ARGS__)) | |
ad2706db | 92 | |
0f474365 | 93 | int path_strv_make_absolute_cwd(char **l); |
e1873695 LP |
94 | char** path_strv_resolve(char **l, const char *root); |
95 | char** path_strv_resolve_uniq(char **l, const char *root); | |
9eb977db | 96 | |
85eca92e | 97 | int find_binary(const char *name, char **filename); |
fecffe5d | 98 | |
2ad8416d | 99 | bool paths_check_timestamp(const char* const* paths, usec_t *paths_ts_usec, bool update); |
8e184852 | 100 | |
eb66db55 | 101 | int fsck_exists(const char *fstype); |
5bcd08db | 102 | int mkfs_exists(const char *fstype); |
eb66db55 | 103 | |
e203f7c3 LP |
104 | /* Iterates through the path prefixes of the specified path, going up |
105 | * the tree, to root. Also returns "" (and not "/"!) for the root | |
106 | * directory. Excludes the specified directory itself */ | |
f8703ed7 ZJS |
107 | #define PATH_FOREACH_PREFIX(prefix, path) \ |
108 | for (char *_slash = ({ \ | |
109 | path_simplify(strcpy(prefix, path), false); \ | |
110 | streq(prefix, "/") ? NULL : strrchr(prefix, '/'); \ | |
111 | }); \ | |
112 | _slash && ((*_slash = 0), true); \ | |
113 | _slash = strrchr((prefix), '/')) | |
e203f7c3 LP |
114 | |
115 | /* Same as PATH_FOREACH_PREFIX but also includes the specified path itself */ | |
f8703ed7 ZJS |
116 | #define PATH_FOREACH_PREFIX_MORE(prefix, path) \ |
117 | for (char *_slash = ({ \ | |
118 | path_simplify(strcpy(prefix, path), false); \ | |
119 | if (streq(prefix, "/")) \ | |
120 | prefix[0] = 0; \ | |
121 | strrchr(prefix, 0); \ | |
122 | }); \ | |
123 | _slash && ((*_slash = 0), true); \ | |
124 | _slash = strrchr((prefix), '/')) | |
1d13f648 | 125 | |
c6134d3e | 126 | /* Similar to path_join(), but only works for two components, and only the first one may be NULL and returns |
95bbf19e | 127 | * an alloca() buffer, or possibly a const pointer into the path parameter. */ |
1d13f648 LP |
128 | #define prefix_roota(root, path) \ |
129 | ({ \ | |
130 | const char* _path = (path), *_root = (root), *_ret; \ | |
131 | char *_p, *_n; \ | |
132 | size_t _l; \ | |
133 | while (_path[0] == '/' && _path[1] == '/') \ | |
134 | _path ++; \ | |
95bbf19e | 135 | if (isempty(_root)) \ |
1d13f648 LP |
136 | _ret = _path; \ |
137 | else { \ | |
138 | _l = strlen(_root) + 1 + strlen(_path) + 1; \ | |
6e9417f5 | 139 | _n = newa(char, _l); \ |
1d13f648 LP |
140 | _p = stpcpy(_n, _root); \ |
141 | while (_p > _n && _p[-1] == '/') \ | |
142 | _p--; \ | |
143 | if (_path[0] != '/') \ | |
144 | *(_p++) = '/'; \ | |
145 | strcpy(_p, _path); \ | |
146 | _ret = _n; \ | |
147 | } \ | |
148 | _ret; \ | |
149 | }) | |
0f03c2a4 LP |
150 | |
151 | int parse_path_argument_and_warn(const char *path, bool suppress_root, char **arg); | |
5f311f8c LP |
152 | |
153 | char* dirname_malloc(const char *path); | |
b12d25a8 | 154 | const char *last_path_component(const char *path); |
a60c8eee | 155 | int path_extract_filename(const char *p, char **ret); |
bb15fafe LP |
156 | |
157 | bool filename_is_valid(const char *p) _pure_; | |
656552eb | 158 | bool path_is_valid(const char *p) _pure_; |
99be45a4 | 159 | bool path_is_normalized(const char *p) _pure_; |
a0956174 LP |
160 | |
161 | char *file_in_same_dir(const char *path, const char *filename); | |
162 | ||
55cdd057 | 163 | bool hidden_or_backup_file(const char *filename) _pure_; |
a0956174 LP |
164 | |
165 | bool is_device_path(const char *path); | |
57e84e75 LP |
166 | |
167 | bool valid_device_node_path(const char *path); | |
168 | bool valid_device_allow_pattern(const char *path); | |
5a46d55f ZJS |
169 | |
170 | int systemd_installation_has_version(const char *root, unsigned minimal_version); | |
49bfc877 LP |
171 | |
172 | bool dot_or_dot_dot(const char *path); | |
a119ec7c LP |
173 | |
174 | static inline const char *skip_dev_prefix(const char *p) { | |
175 | const char *e; | |
176 | ||
177 | /* Drop any /dev prefix if there is any */ | |
178 | ||
179 | e = path_startswith(p, "/dev/"); | |
180 | ||
181 | return e ?: p; | |
182 | } | |
57ea45e1 LP |
183 | |
184 | bool empty_or_root(const char *root); | |
945403e6 YW |
185 | static inline const char *empty_to_root(const char *path) { |
186 | return isempty(path) ? "/" : path; | |
187 | } |