]>
Commit | Line | Data |
---|---|---|
03467c88 | 1 | /*-*- Mode: C; c-basic-offset: 8; indent-tabs-mode: nil -*-*/ |
60918275 | 2 | |
c2f1db8f | 3 | #pragma once |
60918275 | 4 | |
a7334b09 LP |
5 | /*** |
6 | This file is part of systemd. | |
7 | ||
8 | Copyright 2010 Lennart Poettering | |
9 | ||
10 | systemd is free software; you can redistribute it and/or modify it | |
5430f7f2 LP |
11 | under the terms of the GNU Lesser General Public License as published by |
12 | the Free Software Foundation; either version 2.1 of the License, or | |
a7334b09 LP |
13 | (at your option) any later version. |
14 | ||
15 | systemd is distributed in the hope that it will be useful, but | |
16 | WITHOUT ANY WARRANTY; without even the implied warranty of | |
17 | MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU | |
5430f7f2 | 18 | Lesser General Public License for more details. |
a7334b09 | 19 | |
5430f7f2 | 20 | You should have received a copy of the GNU Lesser General Public License |
a7334b09 LP |
21 | along with systemd; If not, see <http://www.gnu.org/licenses/>. |
22 | ***/ | |
23 | ||
31885cd5 | 24 | #include <alloca.h> |
370c860f | 25 | #include <fcntl.h> |
60918275 LP |
26 | #include <inttypes.h> |
27 | #include <time.h> | |
ec2002f8 | 28 | #include <stdarg.h> |
60918275 | 29 | #include <stdbool.h> |
5cb5a6ff | 30 | #include <stdlib.h> |
80876c20 | 31 | #include <stdio.h> |
9a34ec5f | 32 | #include <signal.h> |
82c121a4 | 33 | #include <sched.h> |
8f75a603 | 34 | #include <limits.h> |
25ea79fe | 35 | #include <sys/types.h> |
2c35d880 | 36 | #include <sys/socket.h> |
00dc5d76 | 37 | #include <sys/stat.h> |
3b63d2d3 | 38 | #include <dirent.h> |
7d5e9c0f | 39 | #include <stddef.h> |
79d860fe | 40 | #include <unistd.h> |
d6dd604b | 41 | #include <locale.h> |
5862d652 | 42 | #include <mntent.h> |
0254e944 | 43 | #include <sys/inotify.h> |
c6878637 | 44 | #include <sys/statfs.h> |
60918275 | 45 | |
ccd06097 | 46 | #if SIZEOF_PID_T == 4 |
3da7a50f | 47 | # define PID_PRI PRIi32 |
ccd06097 | 48 | #elif SIZEOF_PID_T == 2 |
3da7a50f | 49 | # define PID_PRI PRIi16 |
ccd06097 ZJS |
50 | #else |
51 | # error Unknown pid_t size | |
52 | #endif | |
3da7a50f | 53 | #define PID_FMT "%" PID_PRI |
ccd06097 ZJS |
54 | |
55 | #if SIZEOF_UID_T == 4 | |
56 | # define UID_FMT "%" PRIu32 | |
57 | #elif SIZEOF_UID_T == 2 | |
58 | # define UID_FMT "%" PRIu16 | |
59 | #else | |
60 | # error Unknown uid_t size | |
61 | #endif | |
62 | ||
1c231f56 LP |
63 | #if SIZEOF_GID_T == 4 |
64 | # define GID_FMT "%" PRIu32 | |
65 | #elif SIZEOF_GID_T == 2 | |
66 | # define GID_FMT "%" PRIu16 | |
67 | #else | |
68 | # error Unknown gid_t size | |
69 | #endif | |
70 | ||
de0671ee | 71 | #if SIZEOF_TIME_T == 8 |
1fa2f38f | 72 | # define PRI_TIME PRIi64 |
1f2b7175 | 73 | #elif SIZEOF_TIME_T == 4 |
de0671ee ZJS |
74 | # define PRI_TIME PRIu32 |
75 | #else | |
76 | # error Unknown time_t size | |
77 | #endif | |
78 | ||
79 | #if SIZEOF_RLIM_T == 8 | |
80 | # define RLIM_FMT "%" PRIu64 | |
81 | #elif SIZEOF_RLIM_T == 4 | |
82 | # define RLIM_FMT "%" PRIu32 | |
83 | #else | |
84 | # error Unknown rlim_t size | |
85 | #endif | |
86 | ||
a838e6a1 | 87 | #include "macro.h" |
dced1557 | 88 | #include "missing.h" |
9a98c7a1 | 89 | #include "time-util.h" |
871d7de4 | 90 | |
44d8db9e | 91 | /* What is interpreted as whitespace? */ |
4a72ff34 | 92 | #define WHITESPACE " \t\n\r" |
e3e0314b ZJS |
93 | #define NEWLINE "\n\r" |
94 | #define QUOTES "\"\'" | |
95 | #define COMMENTS "#;" | |
96 | #define GLOB_CHARS "*?[" | |
44d8db9e | 97 | |
0ce5a806 MM |
98 | /* What characters are special in the shell? */ |
99 | /* must be escaped outside and inside double-quotes */ | |
100 | #define SHELL_NEED_ESCAPE "\"\\`$" | |
101 | /* can be escaped or double-quoted */ | |
102 | #define SHELL_NEED_QUOTES SHELL_NEED_ESCAPE GLOB_CHARS "'()<>|&;" | |
103 | ||
a7bc2c2a | 104 | #define FORMAT_BYTES_MAX 8 |
8b6c7120 | 105 | |
c1072ea0 | 106 | #define ANSI_HIGHLIGHT_ON "\x1B[1;39m" |
03b717a3 | 107 | #define ANSI_RED_ON "\x1B[31m" |
281605bf | 108 | #define ANSI_HIGHLIGHT_RED_ON "\x1B[1;31m" |
076a24ad | 109 | #define ANSI_GREEN_ON "\x1B[32m" |
2ee68f72 | 110 | #define ANSI_HIGHLIGHT_GREEN_ON "\x1B[1;32m" |
5f23d5b1 | 111 | #define ANSI_HIGHLIGHT_YELLOW_ON "\x1B[1;33m" |
c0fdf098 | 112 | #define ANSI_HIGHLIGHT_BLUE_ON "\x1B[1;34m" |
61cbdc4b | 113 | #define ANSI_HIGHLIGHT_OFF "\x1B[0m" |
984a2be4 | 114 | #define ANSI_ERASE_TO_END_OF_LINE "\x1B[K" |
61cbdc4b | 115 | |
2e857429 | 116 | size_t page_size(void) _pure_; |
37f85e66 | 117 | #define PAGE_ALIGN(l) ALIGN_TO((l), page_size()) |
118 | ||
60918275 | 119 | #define streq(a,b) (strcmp((a),(b)) == 0) |
3846aeeb | 120 | #define strneq(a, b, n) (strncmp((a), (b), (n)) == 0) |
b43d1d01 TA |
121 | #define strcaseeq(a,b) (strcasecmp((a),(b)) == 0) |
122 | #define strncaseeq(a, b, n) (strncasecmp((a), (b), (n)) == 0) | |
60918275 | 123 | |
44a6b1b6 | 124 | bool streq_ptr(const char *a, const char *b) _pure_; |
e05797fb | 125 | |
4b8772bf | 126 | #define new(t, n) ((t*) malloc_multiply(sizeof(t), (n))) |
60918275 LP |
127 | |
128 | #define new0(t, n) ((t*) calloc((n), sizeof(t))) | |
129 | ||
0f0dbc46 LP |
130 | #define newa(t, n) ((t*) alloca(sizeof(t)*(n))) |
131 | ||
7629889c LP |
132 | #define newa0(t, n) ((t*) alloca0(sizeof(t)*(n))) |
133 | ||
4b8772bf | 134 | #define newdup(t, p, n) ((t*) memdup_multiply(p, sizeof(t), (n))) |
888c7102 | 135 | |
60918275 LP |
136 | #define malloc0(n) (calloc((n), 1)) |
137 | ||
138 | static inline const char* yes_no(bool b) { | |
139 | return b ? "yes" : "no"; | |
140 | } | |
141 | ||
5232c42e LS |
142 | static inline const char* true_false(bool b) { |
143 | return b ? "true" : "false"; | |
144 | } | |
145 | ||
769d324c LP |
146 | static inline const char* one_zero(bool b) { |
147 | return b ? "1" : "0"; | |
148 | } | |
149 | ||
60918275 LP |
150 | static inline const char* strempty(const char *s) { |
151 | return s ? s : ""; | |
152 | } | |
153 | ||
154 | static inline const char* strnull(const char *s) { | |
155 | return s ? s : "(null)"; | |
156 | } | |
157 | ||
04fd6fe4 LP |
158 | static inline const char *strna(const char *s) { |
159 | return s ? s : "n/a"; | |
160 | } | |
161 | ||
9beb3f4d LP |
162 | static inline bool isempty(const char *p) { |
163 | return !p || !p[0]; | |
164 | } | |
165 | ||
11adc1ae LP |
166 | static inline char *startswith(const char *s, const char *prefix) { |
167 | size_t l; | |
168 | ||
169 | l = strlen(prefix); | |
170 | if (strncmp(s, prefix, l) == 0) | |
171 | return (char*) s + l; | |
172 | ||
df89481a KS |
173 | return NULL; |
174 | } | |
175 | ||
11adc1ae LP |
176 | static inline char *startswith_no_case(const char *s, const char *prefix) { |
177 | size_t l; | |
178 | ||
179 | l = strlen(prefix); | |
180 | if (strncasecmp(s, prefix, l) == 0) | |
181 | return (char*) s + l; | |
182 | ||
df89481a KS |
183 | return NULL; |
184 | } | |
185 | ||
44a6b1b6 | 186 | char *endswith(const char *s, const char *postfix) _pure_; |
60918275 | 187 | |
5cb36f41 | 188 | char *first_word(const char *s, const char *word) _pure_; |
79d6d816 | 189 | |
42f4e3c4 | 190 | int close_nointr(int fd); |
03e334a1 | 191 | int safe_close(int fd); |
3d94f76c | 192 | void safe_close_pair(int p[]); |
03e334a1 | 193 | |
5b6319dc | 194 | void close_many(const int fds[], unsigned n_fd); |
60918275 | 195 | |
5556b5fe LP |
196 | int parse_size(const char *t, off_t base, off_t *size); |
197 | ||
44a6b1b6 | 198 | int parse_boolean(const char *v) _pure_; |
3ba686c1 | 199 | int parse_pid(const char *s, pid_t* ret_pid); |
034a2a52 LP |
200 | int parse_uid(const char *s, uid_t* ret_uid); |
201 | #define parse_gid(s, ret_uid) parse_uid(s, ret_uid) | |
85261803 LP |
202 | |
203 | int safe_atou(const char *s, unsigned *ret_u); | |
204 | int safe_atoi(const char *s, int *ret_i); | |
205 | ||
8f75a603 LP |
206 | int safe_atollu(const char *s, unsigned long long *ret_u); |
207 | int safe_atolli(const char *s, long long int *ret_i); | |
208 | ||
f7900e25 TA |
209 | int safe_atod(const char *s, double *ret_d); |
210 | ||
b914e211 LP |
211 | int safe_atou8(const char *s, uint8_t *ret); |
212 | ||
8507eb20 | 213 | #if LONG_MAX == INT_MAX |
8f75a603 LP |
214 | static inline int safe_atolu(const char *s, unsigned long *ret_u) { |
215 | assert_cc(sizeof(unsigned long) == sizeof(unsigned)); | |
216 | return safe_atou(s, (unsigned*) ret_u); | |
217 | } | |
218 | static inline int safe_atoli(const char *s, long int *ret_u) { | |
219 | assert_cc(sizeof(long int) == sizeof(int)); | |
220 | return safe_atoi(s, (int*) ret_u); | |
221 | } | |
222 | #else | |
223 | static inline int safe_atolu(const char *s, unsigned long *ret_u) { | |
224 | assert_cc(sizeof(unsigned long) == sizeof(unsigned long long)); | |
225 | return safe_atollu(s, (unsigned long long*) ret_u); | |
226 | } | |
227 | static inline int safe_atoli(const char *s, long int *ret_u) { | |
228 | assert_cc(sizeof(long int) == sizeof(long long int)); | |
229 | return safe_atolli(s, (long long int*) ret_u); | |
230 | } | |
231 | #endif | |
232 | ||
a838e6a1 LP |
233 | static inline int safe_atou32(const char *s, uint32_t *ret_u) { |
234 | assert_cc(sizeof(uint32_t) == sizeof(unsigned)); | |
235 | return safe_atou(s, (unsigned*) ret_u); | |
236 | } | |
237 | ||
8f75a603 | 238 | static inline int safe_atoi32(const char *s, int32_t *ret_i) { |
a838e6a1 | 239 | assert_cc(sizeof(int32_t) == sizeof(int)); |
8f75a603 | 240 | return safe_atoi(s, (int*) ret_i); |
a838e6a1 LP |
241 | } |
242 | ||
8f75a603 LP |
243 | static inline int safe_atou64(const char *s, uint64_t *ret_u) { |
244 | assert_cc(sizeof(uint64_t) == sizeof(unsigned long long)); | |
245 | return safe_atollu(s, (unsigned long long*) ret_u); | |
246 | } | |
034c6ed7 | 247 | |
8f75a603 LP |
248 | static inline int safe_atoi64(const char *s, int64_t *ret_i) { |
249 | assert_cc(sizeof(int64_t) == sizeof(long long int)); | |
250 | return safe_atolli(s, (long long int*) ret_i); | |
251 | } | |
034c6ed7 | 252 | |
781fa938 LP |
253 | int safe_atou16(const char *s, uint16_t *ret); |
254 | int safe_atoi16(const char *s, int16_t *ret); | |
255 | ||
a2a5291b | 256 | const char* split(const char **state, size_t *l, const char *separator, bool quoted); |
a41e8209 | 257 | |
034c6ed7 | 258 | #define FOREACH_WORD(word, length, s, state) \ |
bf85c24d | 259 | _FOREACH_WORD(word, length, s, WHITESPACE, false, state) |
65d2ebdc LP |
260 | |
261 | #define FOREACH_WORD_SEPARATOR(word, length, s, separator, state) \ | |
bf85c24d | 262 | _FOREACH_WORD(word, length, s, separator, false, state) |
a41e8209 | 263 | |
034c6ed7 | 264 | #define FOREACH_WORD_QUOTED(word, length, s, state) \ |
bf85c24d SP |
265 | _FOREACH_WORD(word, length, s, WHITESPACE, true, state) |
266 | ||
bf85c24d | 267 | #define _FOREACH_WORD(word, length, s, separator, quoted, state) \ |
a2a5291b | 268 | for ((state) = (s), (word) = split(&(state), &(length), (separator), (quoted)); (word); (word) = split(&(state), &(length), (separator), (quoted))) |
034c6ed7 | 269 | |
034c6ed7 LP |
270 | pid_t get_parent_of_pid(pid_t pid, pid_t *ppid); |
271 | ||
44d8db9e | 272 | char *strappend(const char *s, const char *suffix); |
fab56fc5 LP |
273 | char *strnappend(const char *s, const char *suffix, size_t length); |
274 | ||
275 | char *replace_env(const char *format, char **env); | |
276 | char **replace_env_argv(char **argv, char **env); | |
44d8db9e | 277 | |
849958d1 | 278 | int readlinkat_malloc(int fd, const char *p, char **ret); |
87f0e418 | 279 | int readlink_malloc(const char *p, char **r); |
9a67bcf2 | 280 | int readlink_value(const char *p, char **ret); |
2c7108c4 | 281 | int readlink_and_make_absolute(const char *p, char **r); |
83096483 | 282 | int readlink_and_canonicalize(const char *p, char **r); |
87f0e418 | 283 | |
2a987ee8 | 284 | int reset_all_signal_handlers(void); |
1dedb74a | 285 | int reset_signal_mask(void); |
2a987ee8 | 286 | |
4a72ff34 | 287 | char *strstrip(char *s); |
ee9b5e01 | 288 | char *delete_chars(char *s, const char *bad); |
7072ced8 | 289 | char *truncate_nl(char *s); |
ee9b5e01 | 290 | |
4a72ff34 LP |
291 | char *file_in_same_dir(const char *path, const char *filename); |
292 | ||
c32dd69b LP |
293 | int rmdir_parents(const char *path, const char *stop); |
294 | ||
93b5eaec | 295 | int get_process_state(pid_t pid); |
87d2c1ff LP |
296 | int get_process_comm(pid_t pid, char **name); |
297 | int get_process_cmdline(pid_t pid, size_t max_length, bool comm_fallback, char **line); | |
298 | int get_process_exe(pid_t pid, char **name); | |
7e4ab3c5 | 299 | int get_process_uid(pid_t pid, uid_t *uid); |
901c3d0d | 300 | int get_process_gid(pid_t pid, gid_t *gid); |
3a832116 | 301 | int get_process_capeff(pid_t pid, char **capeff); |
ad450c3e JF |
302 | int get_process_cwd(pid_t pid, char **cwd); |
303 | int get_process_root(pid_t pid, char **root); | |
c593bb36 | 304 | int get_process_environ(pid_t pid, char **environ); |
7072ced8 | 305 | |
bcb92f48 CR |
306 | char hexchar(int x) _const_; |
307 | int unhexchar(char c) _const_; | |
308 | char octchar(int x) _const_; | |
309 | int unoctchar(char c) _const_; | |
310 | char decchar(int x) _const_; | |
311 | int undecchar(char c) _const_; | |
4fe88d28 LP |
312 | |
313 | char *cescape(const char *s); | |
527b7a42 LP |
314 | |
315 | typedef enum UnescapeFlags { | |
316 | UNESCAPE_RELAX = 1, | |
317 | } UnescapeFlags; | |
318 | ||
319 | int cunescape(const char *s, UnescapeFlags flags, char **ret); | |
320 | int cunescape_length(const char *s, size_t length, UnescapeFlags flags, char **ret); | |
321 | int cunescape_length_with_prefix(const char *s, size_t length, const char *prefix, UnescapeFlags flags, char **ret); | |
6febfd0d LP |
322 | |
323 | char *xescape(const char *s, const char *bad); | |
324 | ||
4fe88d28 LP |
325 | char *ascii_strlower(char *path); |
326 | ||
44a6b1b6 ZJS |
327 | bool dirent_is_file(const struct dirent *de) _pure_; |
328 | bool dirent_is_file_with_suffix(const struct dirent *de, const char *suffix) _pure_; | |
87d2c1ff | 329 | |
a34bf9db | 330 | bool hidden_file(const char *filename) _pure_; |
c85dc17b | 331 | |
44a6b1b6 | 332 | bool chars_intersect(const char *a, const char *b) _pure_; |
db12775d | 333 | |
843d2643 | 334 | int make_stdio(int fd); |
ade509ce | 335 | int make_null_stdio(void); |
cd3bd60a | 336 | int make_console_stdio(void); |
843d2643 | 337 | |
b89446bb | 338 | int dev_urandom(void *p, size_t n); |
9bf3b535 | 339 | void random_bytes(void *p, size_t n); |
ef309a68 | 340 | void initialize_srand(void); |
9bf3b535 LP |
341 | |
342 | static inline uint64_t random_u64(void) { | |
343 | uint64_t u; | |
344 | random_bytes(&u, sizeof(u)); | |
345 | return u; | |
346 | } | |
347 | ||
348 | static inline uint32_t random_u32(void) { | |
349 | uint32_t u; | |
350 | random_bytes(&u, sizeof(u)); | |
351 | return u; | |
352 | } | |
d3782d60 | 353 | |
f8b69d1d | 354 | /* For basic lookup tables with strictly enumerated entries */ |
b9a5f858 | 355 | #define _DEFINE_STRING_TABLE_LOOKUP_TO_STRING(name,type,scope) \ |
4e240ab0 | 356 | scope const char *name##_to_string(type i) { \ |
1dccbe19 LP |
357 | if (i < 0 || i >= (type) ELEMENTSOF(name##_table)) \ |
358 | return NULL; \ | |
359 | return name##_table[i]; \ | |
b9a5f858 LP |
360 | } |
361 | ||
9cad100e BB |
362 | ssize_t string_table_lookup(const char * const *table, size_t len, const char *key); |
363 | ||
364 | #define _DEFINE_STRING_TABLE_LOOKUP_FROM_STRING(name,type,scope) \ | |
365 | scope inline type name##_from_string(const char *s) { \ | |
366 | return (type)string_table_lookup(name##_table, ELEMENTSOF(name##_table), s); \ | |
b9a5f858 LP |
367 | } |
368 | ||
369 | #define _DEFINE_STRING_TABLE_LOOKUP(name,type,scope) \ | |
370 | _DEFINE_STRING_TABLE_LOOKUP_TO_STRING(name,type,scope) \ | |
371 | _DEFINE_STRING_TABLE_LOOKUP_FROM_STRING(name,type,scope) \ | |
1dccbe19 LP |
372 | struct __useless_struct_to_allow_trailing_semicolon__ |
373 | ||
b9a5f858 LP |
374 | #define DEFINE_STRING_TABLE_LOOKUP(name,type) _DEFINE_STRING_TABLE_LOOKUP(name,type,) |
375 | #define DEFINE_PRIVATE_STRING_TABLE_LOOKUP(name,type) _DEFINE_STRING_TABLE_LOOKUP(name,type,static) | |
376 | #define DEFINE_PRIVATE_STRING_TABLE_LOOKUP_TO_STRING(name,type) _DEFINE_STRING_TABLE_LOOKUP_TO_STRING(name,type,static) | |
377 | #define DEFINE_PRIVATE_STRING_TABLE_LOOKUP_FROM_STRING(name,type) _DEFINE_STRING_TABLE_LOOKUP_FROM_STRING(name,type,static) | |
1dccbe19 | 378 | |
f8b69d1d MS |
379 | /* For string conversions where numbers are also acceptable */ |
380 | #define DEFINE_STRING_TABLE_LOOKUP_WITH_FALLBACK(name,type,max) \ | |
381 | int name##_to_string_alloc(type i, char **str) { \ | |
382 | char *s; \ | |
383 | int r; \ | |
384 | if (i < 0 || i > max) \ | |
385 | return -ERANGE; \ | |
386 | if (i < (type) ELEMENTSOF(name##_table)) { \ | |
387 | s = strdup(name##_table[i]); \ | |
388 | if (!s) \ | |
389 | return log_oom(); \ | |
390 | } else { \ | |
8facc349 | 391 | r = asprintf(&s, "%i", i); \ |
f8b69d1d MS |
392 | if (r < 0) \ |
393 | return log_oom(); \ | |
394 | } \ | |
395 | *str = s; \ | |
396 | return 0; \ | |
397 | } \ | |
398 | type name##_from_string(const char *s) { \ | |
399 | type i; \ | |
400 | unsigned u = 0; \ | |
401 | assert(s); \ | |
402 | for (i = 0; i < (type)ELEMENTSOF(name##_table); i++) \ | |
403 | if (name##_table[i] && \ | |
404 | streq(name##_table[i], s)) \ | |
405 | return i; \ | |
8511dd18 | 406 | if (safe_atou(s, &u) >= 0 && u <= max) \ |
f8b69d1d MS |
407 | return (type) u; \ |
408 | return (type) -1; \ | |
409 | } \ | |
410 | struct __useless_struct_to_allow_trailing_semicolon__ | |
411 | ||
3a0ecb08 LP |
412 | int fd_nonblock(int fd, bool nonblock); |
413 | int fd_cloexec(int fd, bool cloexec); | |
414 | ||
a0d40ac5 LP |
415 | int close_all_fds(const int except[], unsigned n_except); |
416 | ||
42856c10 LP |
417 | bool fstype_is_network(const char *fstype); |
418 | ||
601f6a1e LP |
419 | int chvt(int vt); |
420 | ||
8f2d43a0 | 421 | int read_one_char(FILE *f, char *ret, usec_t timeout, bool *need_nl); |
6294aa76 LP |
422 | int ask_char(char *ret, const char *replies, const char *text, ...) _printf_(3, 4); |
423 | int ask_string(char **ret, const char *text, ...) _printf_(2, 3); | |
80876c20 | 424 | |
512947d4 | 425 | int reset_terminal_fd(int fd, bool switch_to_text); |
6ea832a2 LP |
426 | int reset_terminal(const char *name); |
427 | ||
80876c20 | 428 | int open_terminal(const char *name, int mode); |
af6da548 | 429 | int acquire_terminal(const char *name, bool fail, bool force, bool ignore_tiocstty_eperm, usec_t timeout); |
80876c20 LP |
430 | int release_terminal(void); |
431 | ||
432 | int flush_fd(int fd); | |
433 | ||
9a34ec5f LP |
434 | int ignore_signals(int sig, ...); |
435 | int default_signals(int sig, ...); | |
436 | int sigaction_many(const struct sigaction *sa, ...); | |
a337c6fc | 437 | |
5a3ab509 | 438 | int fopen_temporary(const char *path, FILE **_f, char **_temp_path); |
8d567588 | 439 | |
eb22ac37 | 440 | ssize_t loop_read(int fd, void *buf, size_t nbytes, bool do_poll); |
a6dcc7e5 | 441 | int loop_read_exact(int fd, void *buf, size_t nbytes, bool do_poll); |
553acb7b | 442 | int loop_write(int fd, const void *buf, size_t nbytes, bool do_poll); |
8d567588 | 443 | |
8407a5d0 LP |
444 | bool is_device_path(const char *path); |
445 | ||
01f78473 | 446 | int dir_is_empty(const char *path); |
844ec79b | 447 | char* dirname_malloc(const char *path); |
01f78473 | 448 | |
5b6319dc | 449 | void rename_process(const char name[8]); |
2d368c14 | 450 | |
7d793605 | 451 | void sigset_add_many(sigset_t *ss, ...); |
856a5a7d | 452 | int sigprocmask_many(int how, ...); |
7d793605 | 453 | |
344de609 | 454 | bool hostname_is_set(void); |
7c5f152a | 455 | |
f1566e63 | 456 | char* lookup_uid(uid_t uid); |
7c5f152a | 457 | char* gethostname_malloc(void); |
ef2f1067 | 458 | char* getlogname_malloc(void); |
7c5f152a | 459 | char* getusername_malloc(void); |
fc116c6a LP |
460 | |
461 | int getttyname_malloc(int fd, char **r); | |
462 | int getttyname_harder(int fd, char **r); | |
463 | ||
4d6d6518 LP |
464 | int get_ctty_devnr(pid_t pid, dev_t *d); |
465 | int get_ctty(pid_t, dev_t *_devnr, char **r); | |
8c6db833 LP |
466 | |
467 | int chmod_and_chown(const char *path, mode_t mode, uid_t uid, gid_t gid); | |
f4b47811 | 468 | int fchmod_and_fchown(int fd, mode_t mode, uid_t uid, gid_t gid); |
8c6db833 | 469 | |
c6878637 LP |
470 | bool is_temporary_fs(const struct statfs *s) _pure_; |
471 | int fd_is_temporary_fs(int fd); | |
ef2f1067 | 472 | |
1325aa42 LP |
473 | int pipe_eof(int fd); |
474 | ||
82c121a4 LP |
475 | cpu_set_t* cpu_set_malloc(unsigned *ncpus); |
476 | ||
44b601bc LP |
477 | int status_vprintf(const char *status, bool ellipse, bool ephemeral, const char *format, va_list ap) _printf_(4,0); |
478 | int status_printf(const char *status, bool ellipse, bool ephemeral, const char *format, ...) _printf_(4,5); | |
9e58ff9c | 479 | |
5ffa8c81 ZJS |
480 | #define xsprintf(buf, fmt, ...) assert_se((size_t) snprintf(buf, ELEMENTSOF(buf), fmt, __VA_ARGS__) < ELEMENTSOF(buf)) |
481 | ||
81beb750 | 482 | int fd_columns(int fd); |
72f59706 | 483 | unsigned columns(void); |
8f2d43a0 LP |
484 | int fd_lines(int fd); |
485 | unsigned lines(void); | |
ed757c0c LP |
486 | void columns_lines_cache_reset(int _unused_ signum); |
487 | ||
488 | bool on_tty(void); | |
8f2d43a0 | 489 | |
0b5a519c DS |
490 | static inline const char *ansi_highlight(void) { |
491 | return on_tty() ? ANSI_HIGHLIGHT_ON : ""; | |
492 | } | |
493 | ||
494 | static inline const char *ansi_highlight_red(void) { | |
495 | return on_tty() ? ANSI_HIGHLIGHT_RED_ON : ""; | |
496 | } | |
497 | ||
498 | static inline const char *ansi_highlight_green(void) { | |
499 | return on_tty() ? ANSI_HIGHLIGHT_GREEN_ON : ""; | |
500 | } | |
501 | ||
dbc2c080 LP |
502 | static inline const char *ansi_highlight_yellow(void) { |
503 | return on_tty() ? ANSI_HIGHLIGHT_YELLOW_ON : ""; | |
504 | } | |
505 | ||
c0fdf098 ZJS |
506 | static inline const char *ansi_highlight_blue(void) { |
507 | return on_tty() ? ANSI_HIGHLIGHT_BLUE_ON : ""; | |
508 | } | |
509 | ||
0b5a519c DS |
510 | static inline const char *ansi_highlight_off(void) { |
511 | return on_tty() ? ANSI_HIGHLIGHT_OFF : ""; | |
512 | } | |
513 | ||
9d9951a4 HH |
514 | int files_same(const char *filea, const char *fileb); |
515 | ||
b4f10a5e LP |
516 | int running_in_chroot(void); |
517 | ||
72f59706 | 518 | char *ellipsize(const char *s, size_t length, unsigned percent); |
f405e86d | 519 | /* bytes columns */ |
72f59706 | 520 | char *ellipsize_mem(const char *s, size_t old_length, size_t new_length, unsigned percent); |
8fe914ec | 521 | |
c38dfac9 | 522 | int touch_file(const char *path, bool parents, usec_t stamp, uid_t uid, gid_t gid, mode_t mode); |
f6144808 LP |
523 | int touch(const char *path); |
524 | ||
8e12a6ae | 525 | int wait_for_terminate(pid_t pid, siginfo_t *status); |
820d3acf | 526 | int wait_for_terminate_and_warn(const char *name, pid_t pid, bool check_exit_code); |
2e78aa99 | 527 | |
919ce0b7 | 528 | noreturn void freeze(void); |
3c14d26c | 529 | |
44a6b1b6 | 530 | bool null_or_empty(struct stat *st) _pure_; |
83096483 | 531 | int null_or_empty_path(const char *fn); |
ed88bcfb | 532 | int null_or_empty_fd(int fd); |
00dc5d76 | 533 | |
a247755d | 534 | DIR *xopendirat(int dirfd, const char *name, int flags); |
3b63d2d3 | 535 | |
e23a0ce8 LP |
536 | char *fstab_node_to_udev_node(const char *p); |
537 | ||
21baf21a | 538 | char *resolve_dev_console(char **active); |
f212ac12 | 539 | bool tty_is_vc(const char *tty); |
3043935f | 540 | bool tty_is_vc_resolve(const char *tty); |
44a6b1b6 | 541 | bool tty_is_console(const char *tty) _pure_; |
98a28fef | 542 | int vtnr_from_tty(const char *tty); |
e3aa71c3 LP |
543 | const char *default_term_for_tty(const char *tty); |
544 | ||
e801700e | 545 | void execute_directories(const char* const* directories, usec_t timeout, char *argv[]); |
83cc030f | 546 | |
430c18ed LP |
547 | int kill_and_sigcont(pid_t pid, int sig); |
548 | ||
05feefe0 LP |
549 | bool nulstr_contains(const char*nulstr, const char *needle); |
550 | ||
a88c8750 TG |
551 | bool plymouth_running(void); |
552 | ||
44a6b1b6 | 553 | bool hostname_is_valid(const char *s) _pure_; |
e724b063 | 554 | char* hostname_cleanup(char *s, bool lowercase); |
9beb3f4d | 555 | |
7f0d207d LP |
556 | bool machine_name_is_valid(const char *s) _pure_; |
557 | ||
9beb3f4d LP |
558 | char* strshorten(char *s, size_t l); |
559 | ||
6ea832a2 LP |
560 | int terminal_vhangup_fd(int fd); |
561 | int terminal_vhangup(const char *name); | |
562 | ||
563 | int vt_disallocate(const char *name); | |
564 | ||
424a19f8 | 565 | int symlink_atomic(const char *from, const char *to); |
1554afae LP |
566 | int mknod_atomic(const char *path, mode_t mode, dev_t dev); |
567 | int mkfifo_atomic(const char *path, mode_t mode); | |
34ca941c LP |
568 | |
569 | int fchmod_umask(int fd, mode_t mode); | |
570 | ||
44a6b1b6 | 571 | bool display_is_local(const char *display) _pure_; |
4d6d6518 LP |
572 | int socket_from_display(const char *display, char **path); |
573 | ||
d05c5031 | 574 | int get_user_creds(const char **username, uid_t *uid, gid_t *gid, const char **home, const char **shell); |
4b67834e | 575 | int get_group_creds(const char **groupname, gid_t *gid); |
1cccf435 | 576 | |
4468addc | 577 | int in_gid(gid_t gid); |
43673799 LP |
578 | int in_group(const char *name); |
579 | ||
59164be4 | 580 | char* uid_to_name(uid_t uid); |
4468addc | 581 | char* gid_to_name(gid_t gid); |
59164be4 | 582 | |
8092a428 | 583 | int glob_exists(const char *path); |
8d98da3f | 584 | int glob_extend(char ***strv, const char *path); |
8092a428 | 585 | |
83096483 LP |
586 | int dirent_ensure_type(DIR *d, struct dirent *de); |
587 | ||
034a2a52 | 588 | int get_files_in_directory(const char *path, char ***list); |
83096483 | 589 | |
b7def684 | 590 | char *strjoin(const char *x, ...) _sentinel_; |
911a4828 | 591 | |
b636465b LP |
592 | bool is_main_thread(void); |
593 | ||
01f83c1c JT |
594 | static inline bool _pure_ in_charset(const char *s, const char* charset) { |
595 | assert(s); | |
596 | assert(charset); | |
597 | return s[strspn(s, charset)] == '\0'; | |
598 | } | |
ab1f0633 | 599 | |
94959f0f LP |
600 | int block_get_whole_disk(dev_t d, dev_t *ret); |
601 | ||
e23a0ce8 | 602 | #define NULSTR_FOREACH(i, l) \ |
c4e2ceae LP |
603 | for ((i) = (l); (i) && *(i); (i) = strchr((i), 0)+1) |
604 | ||
5c0532d1 LP |
605 | #define NULSTR_FOREACH_PAIR(i, j, l) \ |
606 | for ((i) = (l), (j) = strchr((i), 0)+1; (i) && *(i); (i) = strchr((j), 0)+1, (j) = *(i) ? strchr((i), 0)+1 : (i)) | |
607 | ||
f8b69d1d | 608 | int ioprio_class_to_string_alloc(int i, char **s); |
1dccbe19 LP |
609 | int ioprio_class_from_string(const char *s); |
610 | ||
44a6b1b6 ZJS |
611 | const char *sigchld_code_to_string(int i) _const_; |
612 | int sigchld_code_from_string(const char *s) _pure_; | |
1dccbe19 | 613 | |
f8b69d1d | 614 | int log_facility_unshifted_to_string_alloc(int i, char **s); |
7d76f312 | 615 | int log_facility_unshifted_from_string(const char *s); |
1dccbe19 | 616 | |
f8b69d1d | 617 | int log_level_to_string_alloc(int i, char **s); |
1dccbe19 LP |
618 | int log_level_from_string(const char *s); |
619 | ||
f8b69d1d | 620 | int sched_policy_to_string_alloc(int i, char **s); |
1dccbe19 LP |
621 | int sched_policy_from_string(const char *s); |
622 | ||
44a6b1b6 ZJS |
623 | const char *rlimit_to_string(int i) _const_; |
624 | int rlimit_from_string(const char *s) _pure_; | |
1dccbe19 | 625 | |
f8b69d1d | 626 | int ip_tos_to_string_alloc(int i, char **s); |
4fd5948e LP |
627 | int ip_tos_from_string(const char *s); |
628 | ||
44a6b1b6 ZJS |
629 | const char *signal_to_string(int i) _const_; |
630 | int signal_from_string(const char *s) _pure_; | |
2e22afe9 | 631 | |
8a0867d6 LP |
632 | int signal_from_string_try_harder(const char *s); |
633 | ||
9a0e6896 LP |
634 | extern int saved_argc; |
635 | extern char **saved_argv; | |
636 | ||
65457142 FC |
637 | bool kexec_loaded(void); |
638 | ||
44a6b1b6 | 639 | int prot_from_flags(int flags) _const_; |
87d2c1ff | 640 | |
babfc091 LP |
641 | char *format_bytes(char *buf, size_t l, off_t t); |
642 | ||
8f2d43a0 | 643 | int fd_wait_for_event(int fd, int event, usec_t timeout); |
df50185b | 644 | |
750ef272 | 645 | void* memdup(const void *p, size_t l) _alloc_(2); |
55d7bfc1 | 646 | |
1e5678d0 LP |
647 | int is_kernel_thread(pid_t pid); |
648 | ||
bb99a35a LP |
649 | int fd_inc_sndbuf(int fd, size_t n); |
650 | int fd_inc_rcvbuf(int fd, size_t n); | |
6bb92a16 | 651 | |
9bdc770c | 652 | int fork_agent(pid_t *pid, const int except[], unsigned n_except, const char *path, ...); |
6bb92a16 | 653 | |
68faf98c LP |
654 | int setrlimit_closest(int resource, const struct rlimit *rlim); |
655 | ||
ab94af92 LP |
656 | int getenv_for_pid(pid_t pid, const char *field, char **_value); |
657 | ||
a2e03378 LP |
658 | bool http_url_is_valid(const char *url) _pure_; |
659 | bool documentation_url_is_valid(const char *url) _pure_; | |
49dbfa7b | 660 | |
3d7415f4 LP |
661 | bool http_etag_is_valid(const char *etag); |
662 | ||
9be346c9 | 663 | bool in_initrd(void); |
069cfc85 LP |
664 | |
665 | void warn_melody(void); | |
666 | ||
7c5f152a | 667 | int get_home_dir(char **ret); |
2cfbd749 | 668 | int get_shell(char **_ret); |
2fbe635a | 669 | |
a740c14c MS |
670 | static inline void freep(void *p) { |
671 | free(*(void**) p); | |
672 | } | |
673 | ||
dfb33a97 | 674 | static inline void closep(int *fd) { |
03e334a1 | 675 | safe_close(*fd); |
dfb33a97 LP |
676 | } |
677 | ||
dfb33a97 LP |
678 | static inline void umaskp(mode_t *u) { |
679 | umask(*u); | |
763c7aa2 ZJS |
680 | } |
681 | ||
3d94f76c LP |
682 | static inline void close_pairp(int (*p)[2]) { |
683 | safe_close_pair(*p); | |
04d39279 LP |
684 | } |
685 | ||
14bf2c9d LP |
686 | DEFINE_TRIVIAL_CLEANUP_FUNC(FILE*, fclose); |
687 | DEFINE_TRIVIAL_CLEANUP_FUNC(FILE*, pclose); | |
688 | DEFINE_TRIVIAL_CLEANUP_FUNC(DIR*, closedir); | |
689 | DEFINE_TRIVIAL_CLEANUP_FUNC(FILE*, endmntent); | |
5862d652 | 690 | |
dfb33a97 | 691 | #define _cleanup_free_ _cleanup_(freep) |
dfb33a97 | 692 | #define _cleanup_close_ _cleanup_(closep) |
dfb33a97 LP |
693 | #define _cleanup_umask_ _cleanup_(umaskp) |
694 | #define _cleanup_globfree_ _cleanup_(globfree) | |
1ca208fb ZJS |
695 | #define _cleanup_fclose_ _cleanup_(fclosep) |
696 | #define _cleanup_pclose_ _cleanup_(pclosep) | |
697 | #define _cleanup_closedir_ _cleanup_(closedirp) | |
5862d652 | 698 | #define _cleanup_endmntent_ _cleanup_(endmntentp) |
3d94f76c | 699 | #define _cleanup_close_pair_ _cleanup_(close_pairp) |
c84a9488 | 700 | |
750ef272 | 701 | _malloc_ _alloc_(1, 2) static inline void *malloc_multiply(size_t a, size_t b) { |
368504f4 | 702 | if (_unlikely_(b != 0 && a > ((size_t) -1) / b)) |
4b8772bf LP |
703 | return NULL; |
704 | ||
705 | return malloc(a * b); | |
706 | } | |
707 | ||
9489490a DH |
708 | _alloc_(2, 3) static inline void *realloc_multiply(void *p, size_t a, size_t b) { |
709 | if (_unlikely_(b != 0 && a > ((size_t) -1) / b)) | |
710 | return NULL; | |
711 | ||
712 | return realloc(p, a * b); | |
713 | } | |
714 | ||
750ef272 | 715 | _alloc_(2, 3) static inline void *memdup_multiply(const void *p, size_t a, size_t b) { |
368504f4 | 716 | if (_unlikely_(b != 0 && a > ((size_t) -1) / b)) |
4b8772bf LP |
717 | return NULL; |
718 | ||
719 | return memdup(p, a * b); | |
720 | } | |
0b507b17 | 721 | |
ae6c3cc0 | 722 | bool filename_is_valid(const char *p) _pure_; |
44a6b1b6 ZJS |
723 | bool path_is_safe(const char *p) _pure_; |
724 | bool string_is_safe(const char *p) _pure_; | |
6294aa76 | 725 | bool string_has_cc(const char *p, const char *ok) _pure_; |
cfbc22ab | 726 | |
e3e0314b ZJS |
727 | /** |
728 | * Check if a string contains any glob patterns. | |
729 | */ | |
730 | _pure_ static inline bool string_is_glob(const char *p) { | |
731 | return !!strpbrk(p, GLOB_CHARS); | |
732 | } | |
733 | ||
a9e12476 KS |
734 | void *xbsearch_r(const void *key, const void *base, size_t nmemb, size_t size, |
735 | int (*compar) (const void *, const void *, void *), | |
736 | void *arg); | |
09017585 | 737 | |
20f56fdd DR |
738 | #define _(String) gettext (String) |
739 | void init_gettext(void); | |
09017585 | 740 | bool is_locale_utf8(void); |
c339d977 MS |
741 | |
742 | typedef enum DrawSpecialChar { | |
6b01f1d3 | 743 | DRAW_TREE_VERTICAL, |
45a5ff0d MS |
744 | DRAW_TREE_BRANCH, |
745 | DRAW_TREE_RIGHT, | |
55c0b89c | 746 | DRAW_TREE_SPACE, |
c339d977 | 747 | DRAW_TRIANGULAR_BULLET, |
3deadb91 | 748 | DRAW_BLACK_CIRCLE, |
6b01f1d3 | 749 | DRAW_ARROW, |
13f8b8cb | 750 | DRAW_DASH, |
c339d977 MS |
751 | _DRAW_SPECIAL_CHAR_MAX |
752 | } DrawSpecialChar; | |
6b01f1d3 | 753 | |
c339d977 | 754 | const char *draw_special_char(DrawSpecialChar ch); |
409bc9c3 LP |
755 | |
756 | char *strreplace(const char *text, const char *old_string, const char *new_string); | |
e8bc0ea2 LP |
757 | |
758 | char *strip_tab_ansi(char **p, size_t *l); | |
240dbaa4 LP |
759 | |
760 | int on_ac_power(void); | |
f74e605f | 761 | |
4cf7ea55 MM |
762 | int search_and_fopen(const char *path, const char *mode, const char *root, const char **search, FILE **_f); |
763 | int search_and_fopen_nulstr(const char *path, const char *mode, const char *root, const char *search, FILE **_f); | |
fabe5c0e | 764 | |
9db11a99 LP |
765 | #define FOREACH_LINE(line, f, on_error) \ |
766 | for (;;) \ | |
f74e605f LP |
767 | if (!fgets(line, sizeof(line), f)) { \ |
768 | if (ferror(f)) { \ | |
769 | on_error; \ | |
770 | } \ | |
771 | break; \ | |
772 | } else | |
9db11a99 LP |
773 | |
774 | #define FOREACH_DIRENT(de, d, on_error) \ | |
775 | for (errno = 0, de = readdir(d);; errno = 0, de = readdir(d)) \ | |
776 | if (!de) { \ | |
8333c77e | 777 | if (errno > 0) { \ |
9db11a99 LP |
778 | on_error; \ |
779 | } \ | |
780 | break; \ | |
a34bf9db | 781 | } else if (hidden_file((de)->d_name)) \ |
9db11a99 LP |
782 | continue; \ |
783 | else | |
cd61c3bf LP |
784 | |
785 | #define FOREACH_DIRENT_ALL(de, d, on_error) \ | |
786 | for (errno = 0, de = readdir(d);; errno = 0, de = readdir(d)) \ | |
787 | if (!de) { \ | |
788 | if (errno > 0) { \ | |
789 | on_error; \ | |
790 | } \ | |
791 | break; \ | |
792 | } else | |
6282c859 MS |
793 | |
794 | static inline void *mempset(void *s, int c, size_t n) { | |
795 | memset(s, c, n); | |
dfb33a97 | 796 | return (uint8_t*)s + n; |
6282c859 | 797 | } |
66e35261 LP |
798 | |
799 | char *hexmem(const void *p, size_t l); | |
2181a7f5 LP |
800 | void *unhexmem(const char *p, size_t l); |
801 | ||
a432cb69 | 802 | char *strextend(char **x, ...) _sentinel_; |
9a17484d | 803 | char *strrep(const char *s, unsigned n); |
392d5b37 | 804 | |
ca2d3784 ZJS |
805 | void* greedy_realloc(void **p, size_t *allocated, size_t need, size_t size); |
806 | void* greedy_realloc0(void **p, size_t *allocated, size_t need, size_t size); | |
807 | #define GREEDY_REALLOC(array, allocated, need) \ | |
808 | greedy_realloc((void**) &(array), &(allocated), (need), sizeof((array)[0])) | |
809 | ||
810 | #define GREEDY_REALLOC0(array, allocated, need) \ | |
811 | greedy_realloc0((void**) &(array), &(allocated), (need), sizeof((array)[0])) | |
a1937e67 | 812 | |
5c0d398d | 813 | static inline void _reset_errno_(int *saved_errno) { |
5c0aa72a LP |
814 | errno = *saved_errno; |
815 | } | |
816 | ||
2a371001 | 817 | #define PROTECT_ERRNO _cleanup_(_reset_errno_) __attribute__((unused)) int _saved_errno_ = errno |
5c0d398d | 818 | |
44dd2c6e DH |
819 | static inline int negative_errno(void) { |
820 | /* This helper should be used to shut up gcc if you know 'errno' is | |
821 | * negative. Instead of "return -errno;", use "return negative_errno();" | |
822 | * It will suppress bogus gcc warnings in case it assumes 'errno' might | |
823 | * be 0 and thus the caller's error-handling might not be triggered. */ | |
824 | assert_return(errno > 0, -EINVAL); | |
825 | return -errno; | |
826 | } | |
827 | ||
d6dd604b | 828 | struct _umask_struct_ { |
5c0d398d LP |
829 | mode_t mask; |
830 | bool quit; | |
831 | }; | |
832 | ||
d6dd604b | 833 | static inline void _reset_umask_(struct _umask_struct_ *s) { |
5c0d398d LP |
834 | umask(s->mask); |
835 | }; | |
836 | ||
837 | #define RUN_WITH_UMASK(mask) \ | |
d6dd604b | 838 | for (_cleanup_(_reset_umask_) struct _umask_struct_ _saved_umask_ = { umask(mask), false }; \ |
5c0d398d LP |
839 | !_saved_umask_.quit ; \ |
840 | _saved_umask_.quit = true) | |
144e51ec CR |
841 | |
842 | static inline unsigned u64log2(uint64_t n) { | |
ec417ccc | 843 | #if __SIZEOF_LONG_LONG__ == 8 |
693eb9a2 | 844 | return (n > 1) ? (unsigned) __builtin_clzll(n) ^ 63U : 0; |
ec417ccc LP |
845 | #else |
846 | #error "Wut?" | |
847 | #endif | |
848 | } | |
849 | ||
850 | static inline unsigned u32ctz(uint32_t n) { | |
851 | #if __SIZEOF_INT__ == 4 | |
852 | return __builtin_ctz(n); | |
853 | #else | |
854 | #error "Wut?" | |
855 | #endif | |
144e51ec | 856 | } |
79d860fe | 857 | |
7d328b54 | 858 | static inline unsigned log2i(int x) { |
8fe90522 ZJS |
859 | assert(x > 0); |
860 | ||
861 | return __SIZEOF_INT__ * 8 - __builtin_clz(x) - 1; | |
862 | } | |
863 | ||
b5de6d98 MS |
864 | static inline unsigned log2u(unsigned x) { |
865 | assert(x > 0); | |
866 | ||
867 | return sizeof(unsigned) * 8 - __builtin_clz(x) - 1; | |
868 | } | |
869 | ||
870 | static inline unsigned log2u_round_up(unsigned x) { | |
871 | assert(x > 0); | |
872 | ||
873 | if (x == 1) | |
874 | return 0; | |
875 | ||
876 | return log2u(x - 1) + 1; | |
877 | } | |
878 | ||
79d860fe MP |
879 | static inline bool logind_running(void) { |
880 | return access("/run/systemd/seats/", F_OK) >= 0; | |
881 | } | |
4b73a0c0 | 882 | |
82da66fb LP |
883 | #define DECIMAL_STR_WIDTH(x) \ |
884 | ({ \ | |
885 | typeof(x) _x_ = (x); \ | |
886 | unsigned ans = 1; \ | |
887 | while (_x_ /= 10) \ | |
888 | ans++; \ | |
889 | ans; \ | |
890 | }) | |
75add28a | 891 | |
4b73a0c0 | 892 | int unlink_noerrno(const char *path); |
ed5c5dbd | 893 | |
82da66fb LP |
894 | #define alloca0(n) \ |
895 | ({ \ | |
896 | char *_new_; \ | |
897 | size_t _len_ = n; \ | |
898 | _new_ = alloca(_len_); \ | |
899 | (void *) memset(_new_, 0, _len_); \ | |
ed5c5dbd | 900 | }) |
95d78c7e | 901 | |
257224b0 | 902 | /* It's not clear what alignment glibc/gcc alloca() guarantee, hence provide a guaranteed safe version */ |
95d78c7e DH |
903 | #define alloca_align(size, align) \ |
904 | ({ \ | |
905 | void *_ptr_; \ | |
906 | size_t _mask_ = (align) - 1; \ | |
907 | _ptr_ = alloca((size) + _mask_); \ | |
908 | (void*)(((uintptr_t)_ptr_ + _mask_) & ~_mask_); \ | |
909 | }) | |
910 | ||
911 | #define alloca0_align(size, align) \ | |
912 | ({ \ | |
913 | void *_new_; \ | |
914 | size_t _size_ = (size); \ | |
915 | _new_ = alloca_align(_size_, (align)); \ | |
916 | (void*)memset(_new_, 0, _size_); \ | |
917 | }) | |
66060897 | 918 | |
63c372cb LP |
919 | #define strjoina(a, ...) \ |
920 | ({ \ | |
921 | const char *_appendees_[] = { a, __VA_ARGS__ }; \ | |
922 | char *_d_, *_p_; \ | |
923 | int _len_ = 0; \ | |
924 | unsigned _i_; \ | |
925 | for (_i_ = 0; _i_ < ELEMENTSOF(_appendees_) && _appendees_[_i_]; _i_++) \ | |
926 | _len_ += strlen(_appendees_[_i_]); \ | |
927 | _p_ = _d_ = alloca(_len_ + 1); \ | |
928 | for (_i_ = 0; _i_ < ELEMENTSOF(_appendees_) && _appendees_[_i_]; _i_++) \ | |
929 | _p_ = stpcpy(_p_, _appendees_[_i_]); \ | |
930 | *_p_ = 0; \ | |
931 | _d_; \ | |
f39d4a08 HH |
932 | }) |
933 | ||
31885cd5 ZJS |
934 | #define procfs_file_alloca(pid, field) \ |
935 | ({ \ | |
936 | pid_t _pid_ = (pid); \ | |
b68fa010 SP |
937 | const char *_r_; \ |
938 | if (_pid_ == 0) { \ | |
939 | _r_ = ("/proc/self/" field); \ | |
940 | } else { \ | |
941 | _r_ = alloca(strlen("/proc/") + DECIMAL_STR_MAX(pid_t) + 1 + sizeof(field)); \ | |
942 | sprintf((char*) _r_, "/proc/"PID_FMT"/" field, _pid_); \ | |
943 | } \ | |
31885cd5 ZJS |
944 | _r_; \ |
945 | }) | |
d6dd604b | 946 | |
44a6b1b6 | 947 | bool id128_is_valid(const char *s) _pure_; |
d4ac85c6 LP |
948 | |
949 | int split_pair(const char *s, const char *sep, char **l, char **r); | |
7ff7394d | 950 | |
74df0fca | 951 | int shall_restore_state(void); |
295edddf | 952 | |
7ff7394d ZJS |
953 | /** |
954 | * Normal qsort requires base to be nonnull. Here were require | |
955 | * that only if nmemb > 0. | |
956 | */ | |
957 | static inline void qsort_safe(void *base, size_t nmemb, size_t size, | |
958 | int (*compar)(const void *, const void *)) { | |
959 | if (nmemb) { | |
960 | assert(base); | |
961 | qsort(base, nmemb, size, compar); | |
962 | } | |
963 | } | |
74df0fca LP |
964 | |
965 | int proc_cmdline(char **ret); | |
059cb385 | 966 | int parse_proc_cmdline(int (*parse_word)(const char *key, const char *value)); |
1a299299 | 967 | int get_proc_cmdline_key(const char *parameter, char **value); |
bc9fd78c LP |
968 | |
969 | int container_get_leader(const char *machine, pid_t *pid); | |
970 | ||
878cd7e9 LP |
971 | int namespace_open(pid_t pid, int *pidns_fd, int *mntns_fd, int *netns_fd, int *root_fd); |
972 | int namespace_enter(int pidns_fd, int mntns_fd, int netns_fd, int root_fd); | |
bf108e55 | 973 | |
9f5650ae LP |
974 | bool pid_is_alive(pid_t pid); |
975 | bool pid_is_unwaited(pid_t pid); | |
eff05270 LP |
976 | |
977 | int getpeercred(int fd, struct ucred *ucred); | |
978 | int getpeersec(int fd, char **ret); | |
8e33886e | 979 | |
65b3903f ZJS |
980 | int writev_safe(int fd, const struct iovec *w, int j); |
981 | ||
982 | int mkostemp_safe(char *pattern, int flags); | |
8e33886e | 983 | int open_tmpfile(const char *path, int flags); |
fdb9161c LP |
984 | |
985 | int fd_warn_permissions(const char *path, int fd); | |
6afc95b7 | 986 | |
ac45f971 LP |
987 | unsigned long personality_from_string(const char *p); |
988 | const char *personality_to_string(unsigned long); | |
1c231f56 LP |
989 | |
990 | uint64_t physical_memory(void); | |
6db615c1 | 991 | |
29bfbcd6 | 992 | void hexdump(FILE *f, const void *p, size_t s); |
370c860f DR |
993 | |
994 | union file_handle_union { | |
c5220a94 MO |
995 | struct file_handle handle; |
996 | char padding[sizeof(struct file_handle) + MAX_HANDLE_SZ]; | |
370c860f | 997 | }; |
2695c5c4 | 998 | #define FILE_HANDLE_INIT { .handle.handle_bytes = MAX_HANDLE_SZ } |
c5220a94 MO |
999 | |
1000 | int update_reboot_param_file(const char *param); | |
6d313367 LP |
1001 | |
1002 | int umount_recursive(const char *target, int flags); | |
d6797c92 LP |
1003 | |
1004 | int bind_remount_recursive(const char *prefix, bool ro); | |
1b992147 LP |
1005 | |
1006 | int fflush_and_check(FILE *f); | |
2e78fa79 | 1007 | |
ae6c3cc0 LP |
1008 | int tempfn_xxxxxx(const char *p, char **ret); |
1009 | int tempfn_random(const char *p, char **ret); | |
c4e34a61 | 1010 | int tempfn_random_child(const char *p, char **ret); |
fecc80c1 LP |
1011 | |
1012 | bool is_localhost(const char *hostname); | |
45035609 LP |
1013 | |
1014 | int take_password_lock(const char *root); | |
5261ba90 | 1015 | |
7629889c | 1016 | int is_symlink(const char *path); |
be57e297 | 1017 | int is_dir(const char *path, bool follow); |
7629889c | 1018 | |
527b7a42 | 1019 | typedef enum UnquoteFlags { |
4034a06d LP |
1020 | UNQUOTE_RELAX = 1, |
1021 | UNQUOTE_CUNESCAPE = 2, | |
1022 | } UnquoteFlags; | |
1023 | ||
1024 | int unquote_first_word(const char **p, char **ret, UnquoteFlags flags); | |
1025 | int unquote_many_words(const char **p, UnquoteFlags flags, ...) _sentinel_; | |
2928b0a8 LP |
1026 | |
1027 | int free_and_strdup(char **p, const char *s); | |
605f81a8 MS |
1028 | |
1029 | int sethostname_idempotent(const char *s); | |
f7c1ad4f LP |
1030 | |
1031 | #define INOTIFY_EVENT_MAX (sizeof(struct inotify_event) + NAME_MAX + 1) | |
1032 | ||
1033 | #define FOREACH_INOTIFY_EVENT(e, buffer, sz) \ | |
0254e944 SL |
1034 | for ((e) = &buffer.ev; \ |
1035 | (uint8_t*) (e) < (uint8_t*) (buffer.raw) + (sz); \ | |
f7c1ad4f | 1036 | (e) = (struct inotify_event*) ((uint8_t*) (e) + sizeof(struct inotify_event) + (e)->len)) |
72648326 | 1037 | |
0254e944 SL |
1038 | union inotify_event_buffer { |
1039 | struct inotify_event ev; | |
1040 | uint8_t raw[INOTIFY_EVENT_MAX]; | |
1041 | }; | |
1042 | ||
72648326 | 1043 | #define laccess(path, mode) faccessat(AT_FDCWD, (path), (mode), AT_SYMLINK_NOFOLLOW) |
ee451d76 LP |
1044 | |
1045 | int ptsname_malloc(int fd, char **ret); | |
5f8cc96a LP |
1046 | |
1047 | int openpt_in_namespace(pid_t pid, int flags); | |
4a4d89b6 | 1048 | |
10f9c755 LP |
1049 | ssize_t fgetxattrat_fake(int dirfd, const char *filename, const char *attribute, void *value, size_t size, int flags); |
1050 | ||
4a4d89b6 LP |
1051 | int fd_setcrtime(int fd, usec_t usec); |
1052 | int fd_getcrtime(int fd, usec_t *usec); | |
1053 | int path_getcrtime(const char *p, usec_t *usec); | |
10f9c755 | 1054 | int fd_getcrtime_at(int dirfd, const char *name, usec_t *usec, int flags); |
a354329f LP |
1055 | |
1056 | int same_fd(int a, int b); | |
11689d2a | 1057 | |
1ed8f8c1 LP |
1058 | int chattr_fd(int fd, unsigned value, unsigned mask); |
1059 | int chattr_path(const char *p, unsigned value, unsigned mask); | |
de45d726 | 1060 | |
01b72568 LP |
1061 | int read_attr_fd(int fd, unsigned *ret); |
1062 | int read_attr_path(const char *p, unsigned *ret); | |
1063 | ||
30535c16 LP |
1064 | typedef struct LockFile { |
1065 | char *path; | |
1066 | int fd; | |
1067 | int operation; | |
1068 | } LockFile; | |
1069 | ||
1070 | int make_lock_file(const char *p, int operation, LockFile *ret); | |
1071 | int make_lock_file_for(const char *p, int operation, LockFile *ret); | |
1072 | void release_lock_file(LockFile *f); | |
1073 | ||
1074 | #define _cleanup_release_lock_file_ _cleanup_(release_lock_file) | |
1075 | ||
1076 | #define LOCK_FILE_INIT { .fd = -1, .path = NULL } | |
1077 | ||
de45d726 | 1078 | #define RLIMIT_MAKE_CONST(lim) ((struct rlimit) { lim, lim }) |
ff6a7460 LP |
1079 | |
1080 | ssize_t sparse_write(int fd, const void *p, size_t sz, size_t run_length); | |
3576d631 LP |
1081 | |
1082 | void sigkill_wait(pid_t *pid); | |
1083 | #define _cleanup_sigkill_wait_ _cleanup_(sigkill_wait) | |
3d7415f4 LP |
1084 | |
1085 | int syslog_parse_priority(const char **p, int *priority, bool with_facility); | |
1c8da044 LP |
1086 | |
1087 | void cmsg_close_all(struct msghdr *mh); | |
f85ef957 AC |
1088 | |
1089 | int rename_noreplace(int olddirfd, const char *oldpath, int newdirfd, const char *newpath); | |
019c7fba LP |
1090 | |
1091 | char *shell_maybe_quote(const char *s); | |
2ff7b0a5 LP |
1092 | |
1093 | int parse_mode(const char *s, mode_t *ret); |