]> git.ipfire.org Git - thirdparty/systemd.git/blame - src/shared/util.h
util: add files_same() helper function
[thirdparty/systemd.git] / src / shared / util.h
CommitLineData
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>
60918275
LP
25#include <inttypes.h>
26#include <time.h>
27#include <sys/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>
00dc5d76 36#include <sys/stat.h>
3b63d2d3 37#include <dirent.h>
68faf98c 38#include <sys/resource.h>
7d5e9c0f 39#include <stddef.h>
79d860fe 40#include <unistd.h>
d6dd604b 41#include <locale.h>
5862d652 42#include <mntent.h>
eff05270 43#include <sys/socket.h>
60918275 44
ccd06097
ZJS
45#if SIZEOF_PID_T == 4
46# define PID_FMT "%" PRIu32
47#elif SIZEOF_PID_T == 2
48# define PID_FMT "%" PRIu16
49#else
50# error Unknown pid_t size
51#endif
52
53#if SIZEOF_UID_T == 4
54# define UID_FMT "%" PRIu32
55#elif SIZEOF_UID_T == 2
56# define UID_FMT "%" PRIu16
57#else
58# error Unknown uid_t size
59#endif
60
1c231f56
LP
61#if SIZEOF_GID_T == 4
62# define GID_FMT "%" PRIu32
63#elif SIZEOF_GID_T == 2
64# define GID_FMT "%" PRIu16
65#else
66# error Unknown gid_t size
67#endif
68
a838e6a1 69#include "macro.h"
9a98c7a1 70#include "time-util.h"
871d7de4 71
44d8db9e 72/* What is interpreted as whitespace? */
4a72ff34 73#define WHITESPACE " \t\n\r"
e3e0314b
ZJS
74#define NEWLINE "\n\r"
75#define QUOTES "\"\'"
76#define COMMENTS "#;"
77#define GLOB_CHARS "*?["
44d8db9e 78
a7bc2c2a 79#define FORMAT_BYTES_MAX 8
8b6c7120 80
c1072ea0 81#define ANSI_HIGHLIGHT_ON "\x1B[1;39m"
03b717a3 82#define ANSI_RED_ON "\x1B[31m"
281605bf 83#define ANSI_HIGHLIGHT_RED_ON "\x1B[1;31m"
076a24ad 84#define ANSI_GREEN_ON "\x1B[32m"
2ee68f72 85#define ANSI_HIGHLIGHT_GREEN_ON "\x1B[1;32m"
5f23d5b1 86#define ANSI_HIGHLIGHT_YELLOW_ON "\x1B[1;33m"
c0fdf098 87#define ANSI_HIGHLIGHT_BLUE_ON "\x1B[1;34m"
61cbdc4b 88#define ANSI_HIGHLIGHT_OFF "\x1B[0m"
984a2be4 89#define ANSI_ERASE_TO_END_OF_LINE "\x1B[K"
61cbdc4b 90
37f85e66 91size_t page_size(void);
92#define PAGE_ALIGN(l) ALIGN_TO((l), page_size())
93
60918275 94#define streq(a,b) (strcmp((a),(b)) == 0)
3846aeeb 95#define strneq(a, b, n) (strncmp((a), (b), (n)) == 0)
b43d1d01
TA
96#define strcaseeq(a,b) (strcasecmp((a),(b)) == 0)
97#define strncaseeq(a, b, n) (strncasecmp((a), (b), (n)) == 0)
60918275 98
44a6b1b6 99bool streq_ptr(const char *a, const char *b) _pure_;
e05797fb 100
4b8772bf 101#define new(t, n) ((t*) malloc_multiply(sizeof(t), (n)))
60918275
LP
102
103#define new0(t, n) ((t*) calloc((n), sizeof(t)))
104
0f0dbc46
LP
105#define newa(t, n) ((t*) alloca(sizeof(t)*(n)))
106
4b8772bf 107#define newdup(t, p, n) ((t*) memdup_multiply(p, sizeof(t), (n)))
888c7102 108
60918275
LP
109#define malloc0(n) (calloc((n), 1))
110
111static inline const char* yes_no(bool b) {
112 return b ? "yes" : "no";
113}
114
5232c42e
LS
115static inline const char* true_false(bool b) {
116 return b ? "true" : "false";
117}
118
60918275
LP
119static inline const char* strempty(const char *s) {
120 return s ? s : "";
121}
122
123static inline const char* strnull(const char *s) {
124 return s ? s : "(null)";
125}
126
04fd6fe4
LP
127static inline const char *strna(const char *s) {
128 return s ? s : "n/a";
129}
130
9beb3f4d
LP
131static inline bool isempty(const char *p) {
132 return !p || !p[0];
133}
134
df89481a
KS
135static inline const char *startswith(const char *s, const char *prefix) {
136 if (strncmp(s, prefix, strlen(prefix)) == 0)
137 return s + strlen(prefix);
138 return NULL;
139}
140
141static inline const char *startswith_no_case(const char *s, const char *prefix) {
142 if (strncasecmp(s, prefix, strlen(prefix)) == 0)
143 return s + strlen(prefix);
144 return NULL;
145}
146
44a6b1b6 147char *endswith(const char *s, const char *postfix) _pure_;
60918275 148
44a6b1b6 149bool first_word(const char *s, const char *word) _pure_;
79d6d816 150
42f4e3c4 151int close_nointr(int fd);
85f136b5 152void close_nointr_nofail(int fd);
5b6319dc 153void close_many(const int fds[], unsigned n_fd);
60918275 154
5556b5fe
LP
155int parse_size(const char *t, off_t base, off_t *size);
156
44a6b1b6 157int parse_boolean(const char *v) _pure_;
3ba686c1 158int parse_pid(const char *s, pid_t* ret_pid);
034a2a52
LP
159int parse_uid(const char *s, uid_t* ret_uid);
160#define parse_gid(s, ret_uid) parse_uid(s, ret_uid)
85261803
LP
161
162int safe_atou(const char *s, unsigned *ret_u);
163int safe_atoi(const char *s, int *ret_i);
164
8f75a603
LP
165int safe_atollu(const char *s, unsigned long long *ret_u);
166int safe_atolli(const char *s, long long int *ret_i);
167
f7900e25
TA
168int safe_atod(const char *s, double *ret_d);
169
8f75a603
LP
170#if __WORDSIZE == 32
171static inline int safe_atolu(const char *s, unsigned long *ret_u) {
172 assert_cc(sizeof(unsigned long) == sizeof(unsigned));
173 return safe_atou(s, (unsigned*) ret_u);
174}
175static inline int safe_atoli(const char *s, long int *ret_u) {
176 assert_cc(sizeof(long int) == sizeof(int));
177 return safe_atoi(s, (int*) ret_u);
178}
179#else
180static inline int safe_atolu(const char *s, unsigned long *ret_u) {
181 assert_cc(sizeof(unsigned long) == sizeof(unsigned long long));
182 return safe_atollu(s, (unsigned long long*) ret_u);
183}
184static inline int safe_atoli(const char *s, long int *ret_u) {
185 assert_cc(sizeof(long int) == sizeof(long long int));
186 return safe_atolli(s, (long long int*) ret_u);
187}
188#endif
189
a838e6a1
LP
190static inline int safe_atou32(const char *s, uint32_t *ret_u) {
191 assert_cc(sizeof(uint32_t) == sizeof(unsigned));
192 return safe_atou(s, (unsigned*) ret_u);
193}
194
8f75a603 195static inline int safe_atoi32(const char *s, int32_t *ret_i) {
a838e6a1 196 assert_cc(sizeof(int32_t) == sizeof(int));
8f75a603 197 return safe_atoi(s, (int*) ret_i);
a838e6a1
LP
198}
199
8f75a603
LP
200static inline int safe_atou64(const char *s, uint64_t *ret_u) {
201 assert_cc(sizeof(uint64_t) == sizeof(unsigned long long));
202 return safe_atollu(s, (unsigned long long*) ret_u);
203}
034c6ed7 204
8f75a603
LP
205static inline int safe_atoi64(const char *s, int64_t *ret_i) {
206 assert_cc(sizeof(int64_t) == sizeof(long long int));
207 return safe_atolli(s, (long long int*) ret_i);
208}
034c6ed7 209
bf85c24d 210char *split(const char *c, size_t *l, const char *separator, bool quoted, char **state);
a41e8209 211
034c6ed7 212#define FOREACH_WORD(word, length, s, state) \
bf85c24d 213 _FOREACH_WORD(word, length, s, WHITESPACE, false, state)
65d2ebdc
LP
214
215#define FOREACH_WORD_SEPARATOR(word, length, s, separator, state) \
bf85c24d 216 _FOREACH_WORD(word, length, s, separator, false, state)
a41e8209 217
034c6ed7 218#define FOREACH_WORD_QUOTED(word, length, s, state) \
bf85c24d
SP
219 _FOREACH_WORD(word, length, s, WHITESPACE, true, state)
220
221#define FOREACH_WORD_SEPARATOR_QUOTED(word, length, s, separator, state) \
222 _FOREACH_WORD(word, length, s, separator, true, state)
223
224#define _FOREACH_WORD(word, length, s, separator, quoted, state) \
225 for ((state) = NULL, (word) = split((s), &(length), (separator), (quoted), &(state)); (word); (word) = split((s), &(length), (separator), (quoted), &(state)))
034c6ed7 226
034c6ed7 227pid_t get_parent_of_pid(pid_t pid, pid_t *ppid);
7640a5de 228int get_starttime_of_pid(pid_t pid, unsigned long long *st);
034c6ed7 229
44d8db9e 230char *strappend(const char *s, const char *suffix);
fab56fc5
LP
231char *strnappend(const char *s, const char *suffix, size_t length);
232
233char *replace_env(const char *format, char **env);
234char **replace_env_argv(char **argv, char **env);
44d8db9e 235
87f0e418 236int readlink_malloc(const char *p, char **r);
2c7108c4 237int readlink_and_make_absolute(const char *p, char **r);
83096483 238int readlink_and_canonicalize(const char *p, char **r);
87f0e418 239
2a987ee8
LP
240int reset_all_signal_handlers(void);
241
4a72ff34 242char *strstrip(char *s);
ee9b5e01 243char *delete_chars(char *s, const char *bad);
7072ced8 244char *truncate_nl(char *s);
ee9b5e01 245
4a72ff34
LP
246char *file_in_same_dir(const char *path, const char *filename);
247
c32dd69b
LP
248int rmdir_parents(const char *path, const char *stop);
249
93b5eaec 250int get_process_state(pid_t pid);
87d2c1ff
LP
251int get_process_comm(pid_t pid, char **name);
252int get_process_cmdline(pid_t pid, size_t max_length, bool comm_fallback, char **line);
253int get_process_exe(pid_t pid, char **name);
7e4ab3c5 254int get_process_uid(pid_t pid, uid_t *uid);
901c3d0d 255int get_process_gid(pid_t pid, gid_t *gid);
3a832116 256int get_process_capeff(pid_t pid, char **capeff);
7072ced8 257
bcb92f48
CR
258char hexchar(int x) _const_;
259int unhexchar(char c) _const_;
260char octchar(int x) _const_;
261int unoctchar(char c) _const_;
262char decchar(int x) _const_;
263int undecchar(char c) _const_;
4fe88d28
LP
264
265char *cescape(const char *s);
266char *cunescape(const char *s);
6febfd0d 267char *cunescape_length(const char *s, size_t length);
5b4c61cd 268char *cunescape_length_with_prefix(const char *s, size_t length, const char *prefix);
6febfd0d
LP
269
270char *xescape(const char *s, const char *bad);
271
4fe88d28
LP
272char *ascii_strlower(char *path);
273
44a6b1b6
ZJS
274bool dirent_is_file(const struct dirent *de) _pure_;
275bool dirent_is_file_with_suffix(const struct dirent *de, const char *suffix) _pure_;
87d2c1ff 276
44a6b1b6 277bool ignore_file(const char *filename) _pure_;
c85dc17b 278
44a6b1b6 279bool chars_intersect(const char *a, const char *b) _pure_;
db12775d 280
843d2643 281int make_stdio(int fd);
ade509ce 282int make_null_stdio(void);
cd3bd60a 283int make_console_stdio(void);
843d2643 284
b89446bb 285int dev_urandom(void *p, size_t n);
9bf3b535
LP
286void random_bytes(void *p, size_t n);
287
288static inline uint64_t random_u64(void) {
289 uint64_t u;
290 random_bytes(&u, sizeof(u));
291 return u;
292}
293
294static inline uint32_t random_u32(void) {
295 uint32_t u;
296 random_bytes(&u, sizeof(u));
297 return u;
298}
d3782d60 299
f8b69d1d 300/* For basic lookup tables with strictly enumerated entries */
4e240ab0
MS
301#define __DEFINE_STRING_TABLE_LOOKUP(name,type,scope) \
302 scope const char *name##_to_string(type i) { \
1dccbe19
LP
303 if (i < 0 || i >= (type) ELEMENTSOF(name##_table)) \
304 return NULL; \
305 return name##_table[i]; \
306 } \
4e240ab0 307 scope type name##_from_string(const char *s) { \
1dccbe19 308 type i; \
2c3d81d4
TG
309 if (!s) \
310 return (type) -1; \
1dccbe19 311 for (i = 0; i < (type)ELEMENTSOF(name##_table); i++) \
4fd5948e
LP
312 if (name##_table[i] && \
313 streq(name##_table[i], s)) \
1dccbe19
LP
314 return i; \
315 return (type) -1; \
316 } \
317 struct __useless_struct_to_allow_trailing_semicolon__
318
4e240ab0
MS
319#define DEFINE_STRING_TABLE_LOOKUP(name,type) __DEFINE_STRING_TABLE_LOOKUP(name,type,)
320#define DEFINE_PRIVATE_STRING_TABLE_LOOKUP(name,type) __DEFINE_STRING_TABLE_LOOKUP(name,type,static)
1dccbe19 321
f8b69d1d
MS
322/* For string conversions where numbers are also acceptable */
323#define DEFINE_STRING_TABLE_LOOKUP_WITH_FALLBACK(name,type,max) \
324 int name##_to_string_alloc(type i, char **str) { \
325 char *s; \
326 int r; \
327 if (i < 0 || i > max) \
328 return -ERANGE; \
329 if (i < (type) ELEMENTSOF(name##_table)) { \
330 s = strdup(name##_table[i]); \
331 if (!s) \
332 return log_oom(); \
333 } else { \
334 r = asprintf(&s, "%u", i); \
335 if (r < 0) \
336 return log_oom(); \
337 } \
338 *str = s; \
339 return 0; \
340 } \
341 type name##_from_string(const char *s) { \
342 type i; \
343 unsigned u = 0; \
344 assert(s); \
345 for (i = 0; i < (type)ELEMENTSOF(name##_table); i++) \
346 if (name##_table[i] && \
347 streq(name##_table[i], s)) \
348 return i; \
8511dd18 349 if (safe_atou(s, &u) >= 0 && u <= max) \
f8b69d1d
MS
350 return (type) u; \
351 return (type) -1; \
352 } \
353 struct __useless_struct_to_allow_trailing_semicolon__
354
3a0ecb08
LP
355int fd_nonblock(int fd, bool nonblock);
356int fd_cloexec(int fd, bool cloexec);
357
a0d40ac5
LP
358int close_all_fds(const int except[], unsigned n_except);
359
42856c10
LP
360bool fstype_is_network(const char *fstype);
361
601f6a1e
LP
362int chvt(int vt);
363
8f2d43a0 364int read_one_char(FILE *f, char *ret, usec_t timeout, bool *need_nl);
44b601bc 365int ask(char *ret, const char *replies, const char *text, ...) _printf_(3, 4);
80876c20 366
512947d4 367int reset_terminal_fd(int fd, bool switch_to_text);
6ea832a2
LP
368int reset_terminal(const char *name);
369
80876c20 370int open_terminal(const char *name, int mode);
af6da548 371int acquire_terminal(const char *name, bool fail, bool force, bool ignore_tiocstty_eperm, usec_t timeout);
80876c20
LP
372int release_terminal(void);
373
374int flush_fd(int fd);
375
9a34ec5f
LP
376int ignore_signals(int sig, ...);
377int default_signals(int sig, ...);
378int sigaction_many(const struct sigaction *sa, ...);
a337c6fc 379
8d567588 380int close_pipe(int p[]);
5a3ab509 381int fopen_temporary(const char *path, FILE **_f, char **_temp_path);
8d567588 382
eb22ac37
LP
383ssize_t loop_read(int fd, void *buf, size_t nbytes, bool do_poll);
384ssize_t loop_write(int fd, const void *buf, size_t nbytes, bool do_poll);
8d567588 385
8407a5d0
LP
386bool is_device_path(const char *path);
387
01f78473 388int dir_is_empty(const char *path);
844ec79b 389char* dirname_malloc(const char *path);
01f78473 390
5b6319dc 391void rename_process(const char name[8]);
2d368c14 392
7d793605
LP
393void sigset_add_many(sigset_t *ss, ...);
394
344de609 395bool hostname_is_set(void);
7c5f152a
LP
396
397char* gethostname_malloc(void);
ef2f1067 398char* getlogname_malloc(void);
7c5f152a 399char* getusername_malloc(void);
fc116c6a
LP
400
401int getttyname_malloc(int fd, char **r);
402int getttyname_harder(int fd, char **r);
403
4d6d6518
LP
404int get_ctty_devnr(pid_t pid, dev_t *d);
405int get_ctty(pid_t, dev_t *_devnr, char **r);
8c6db833
LP
406
407int chmod_and_chown(const char *path, mode_t mode, uid_t uid, gid_t gid);
f4b47811 408int fchmod_and_fchown(int fd, mode_t mode, uid_t uid, gid_t gid);
8c6db833 409
597f43c7 410int rm_rf_children(int fd, bool only_dirs, bool honour_sticky, struct stat *root_dev);
f56d5db9 411int rm_rf_children_dangerous(int fd, bool only_dirs, bool honour_sticky, struct stat *root_dev);
ad293f5a 412int rm_rf(const char *path, bool only_dirs, bool delete_root, bool honour_sticky);
f56d5db9 413int rm_rf_dangerous(const char *path, bool only_dirs, bool delete_root, bool honour_sticky);
ef2f1067 414
1325aa42
LP
415int pipe_eof(int fd);
416
82c121a4
LP
417cpu_set_t* cpu_set_malloc(unsigned *ncpus);
418
44b601bc
LP
419int status_vprintf(const char *status, bool ellipse, bool ephemeral, const char *format, va_list ap) _printf_(4,0);
420int status_printf(const char *status, bool ellipse, bool ephemeral, const char *format, ...) _printf_(4,5);
9e58ff9c 421
81beb750 422int fd_columns(int fd);
72f59706 423unsigned columns(void);
8f2d43a0
LP
424int fd_lines(int fd);
425unsigned lines(void);
ed757c0c
LP
426void columns_lines_cache_reset(int _unused_ signum);
427
428bool on_tty(void);
8f2d43a0 429
0b5a519c
DS
430static inline const char *ansi_highlight(void) {
431 return on_tty() ? ANSI_HIGHLIGHT_ON : "";
432}
433
434static inline const char *ansi_highlight_red(void) {
435 return on_tty() ? ANSI_HIGHLIGHT_RED_ON : "";
436}
437
438static inline const char *ansi_highlight_green(void) {
439 return on_tty() ? ANSI_HIGHLIGHT_GREEN_ON : "";
440}
441
dbc2c080
LP
442static inline const char *ansi_highlight_yellow(void) {
443 return on_tty() ? ANSI_HIGHLIGHT_YELLOW_ON : "";
444}
445
c0fdf098
ZJS
446static inline const char *ansi_highlight_blue(void) {
447 return on_tty() ? ANSI_HIGHLIGHT_BLUE_ON : "";
448}
449
0b5a519c
DS
450static inline const char *ansi_highlight_off(void) {
451 return on_tty() ? ANSI_HIGHLIGHT_OFF : "";
452}
453
9d9951a4
HH
454int files_same(const char *filea, const char *fileb);
455
b4f10a5e
LP
456int running_in_chroot(void);
457
72f59706 458char *ellipsize(const char *s, size_t length, unsigned percent);
f405e86d 459 /* bytes columns */
72f59706 460char *ellipsize_mem(const char *s, size_t old_length, size_t new_length, unsigned percent);
8fe914ec 461
f6144808
LP
462int touch(const char *path);
463
97c4a07d 464char *unquote(const char *s, const char *quotes);
5f7c426e 465char *normalize_env_assignment(const char *s);
11ce3427 466
8e12a6ae 467int wait_for_terminate(pid_t pid, siginfo_t *status);
97c4a07d 468int wait_for_terminate_and_warn(const char *name, pid_t pid);
2e78aa99 469
919ce0b7 470noreturn void freeze(void);
3c14d26c 471
44a6b1b6 472bool null_or_empty(struct stat *st) _pure_;
83096483 473int null_or_empty_path(const char *fn);
00dc5d76 474
a247755d 475DIR *xopendirat(int dirfd, const char *name, int flags);
3b63d2d3 476
e23a0ce8
LP
477char *fstab_node_to_udev_node(const char *p);
478
21baf21a 479char *resolve_dev_console(char **active);
f212ac12 480bool tty_is_vc(const char *tty);
3043935f 481bool tty_is_vc_resolve(const char *tty);
44a6b1b6 482bool tty_is_console(const char *tty) _pure_;
98a28fef 483int vtnr_from_tty(const char *tty);
e3aa71c3
LP
484const char *default_term_for_tty(const char *tty);
485
aa62a893 486void execute_directory(const char *directory, DIR *_d, usec_t timeout, char *argv[]);
83cc030f 487
430c18ed
LP
488int kill_and_sigcont(pid_t pid, int sig);
489
05feefe0
LP
490bool nulstr_contains(const char*nulstr, const char *needle);
491
6faa1114
LP
492bool plymouth_running(void);
493
44a6b1b6 494bool hostname_is_valid(const char *s) _pure_;
e724b063 495char* hostname_cleanup(char *s, bool lowercase);
9beb3f4d
LP
496
497char* strshorten(char *s, size_t l);
498
6ea832a2
LP
499int terminal_vhangup_fd(int fd);
500int terminal_vhangup(const char *name);
501
502int vt_disallocate(const char *name);
503
51045322 504int copy_file(const char *from, const char *to, int flags);
424a19f8
LP
505
506int symlink_atomic(const char *from, const char *to);
34ca941c
LP
507
508int fchmod_umask(int fd, mode_t mode);
509
44a6b1b6 510bool display_is_local(const char *display) _pure_;
4d6d6518
LP
511int socket_from_display(const char *display, char **path);
512
d05c5031 513int get_user_creds(const char **username, uid_t *uid, gid_t *gid, const char **home, const char **shell);
4b67834e 514int get_group_creds(const char **groupname, gid_t *gid);
1cccf435 515
4468addc 516int in_gid(gid_t gid);
43673799
LP
517int in_group(const char *name);
518
59164be4 519char* uid_to_name(uid_t uid);
4468addc 520char* gid_to_name(gid_t gid);
59164be4 521
8092a428 522int glob_exists(const char *path);
8d98da3f 523int glob_extend(char ***strv, const char *path);
8092a428 524
83096483
LP
525int dirent_ensure_type(DIR *d, struct dirent *de);
526
527int in_search_path(const char *path, char **search);
034a2a52 528int get_files_in_directory(const char *path, char ***list);
83096483 529
b7def684 530char *strjoin(const char *x, ...) _sentinel_;
911a4828 531
b636465b
LP
532bool is_main_thread(void);
533
44a6b1b6 534bool in_charset(const char *s, const char* charset) _pure_;
ab1f0633 535
94959f0f
LP
536int block_get_whole_disk(dev_t d, dev_t *ret);
537
8d53b453 538int file_is_priv_sticky(const char *p);
ad293f5a 539
fb9de93d
LP
540int strdup_or_null(const char *a, char **b);
541
e23a0ce8 542#define NULSTR_FOREACH(i, l) \
c4e2ceae
LP
543 for ((i) = (l); (i) && *(i); (i) = strchr((i), 0)+1)
544
5c0532d1
LP
545#define NULSTR_FOREACH_PAIR(i, j, l) \
546 for ((i) = (l), (j) = strchr((i), 0)+1; (i) && *(i); (i) = strchr((j), 0)+1, (j) = *(i) ? strchr((i), 0)+1 : (i))
547
f8b69d1d 548int ioprio_class_to_string_alloc(int i, char **s);
1dccbe19
LP
549int ioprio_class_from_string(const char *s);
550
44a6b1b6
ZJS
551const char *sigchld_code_to_string(int i) _const_;
552int sigchld_code_from_string(const char *s) _pure_;
1dccbe19 553
f8b69d1d 554int log_facility_unshifted_to_string_alloc(int i, char **s);
7d76f312 555int log_facility_unshifted_from_string(const char *s);
1dccbe19 556
f8b69d1d 557int log_level_to_string_alloc(int i, char **s);
1dccbe19
LP
558int log_level_from_string(const char *s);
559
f8b69d1d 560int sched_policy_to_string_alloc(int i, char **s);
1dccbe19
LP
561int sched_policy_from_string(const char *s);
562
44a6b1b6
ZJS
563const char *rlimit_to_string(int i) _const_;
564int rlimit_from_string(const char *s) _pure_;
1dccbe19 565
f8b69d1d 566int ip_tos_to_string_alloc(int i, char **s);
4fd5948e
LP
567int ip_tos_from_string(const char *s);
568
44a6b1b6
ZJS
569const char *signal_to_string(int i) _const_;
570int signal_from_string(const char *s) _pure_;
2e22afe9 571
8a0867d6
LP
572int signal_from_string_try_harder(const char *s);
573
9a0e6896
LP
574extern int saved_argc;
575extern char **saved_argv;
576
65457142
FC
577bool kexec_loaded(void);
578
44a6b1b6 579int prot_from_flags(int flags) _const_;
87d2c1ff 580
babfc091
LP
581char *format_bytes(char *buf, size_t l, off_t t);
582
8f2d43a0 583int fd_wait_for_event(int fd, int event, usec_t timeout);
df50185b 584
750ef272 585void* memdup(const void *p, size_t l) _alloc_(2);
55d7bfc1 586
1e5678d0
LP
587int is_kernel_thread(pid_t pid);
588
bb99a35a
LP
589int fd_inc_sndbuf(int fd, size_t n);
590int fd_inc_rcvbuf(int fd, size_t n);
6bb92a16 591
9bdc770c 592int fork_agent(pid_t *pid, const int except[], unsigned n_except, const char *path, ...);
6bb92a16 593
68faf98c
LP
594int setrlimit_closest(int resource, const struct rlimit *rlim);
595
ab94af92
LP
596int getenv_for_pid(pid_t pid, const char *field, char **_value);
597
44a6b1b6 598bool is_valid_documentation_url(const char *url) _pure_;
49dbfa7b 599
9be346c9 600bool in_initrd(void);
069cfc85
LP
601
602void warn_melody(void);
603
7c5f152a 604int get_home_dir(char **ret);
2cfbd749 605int get_shell(char **_ret);
2fbe635a 606
a740c14c
MS
607static inline void freep(void *p) {
608 free(*(void**) p);
609}
610
14bf2c9d
LP
611#define DEFINE_TRIVIAL_CLEANUP_FUNC(type, func) \
612 static inline void func##p(type *p) { \
613 if (*p) \
614 func(*p); \
615 } \
616 struct __useless_struct_to_allow_trailing_semicolon__
dfb33a97
LP
617
618static inline void closep(int *fd) {
619 if (*fd >= 0)
620 close_nointr_nofail(*fd);
621}
622
dfb33a97
LP
623static inline void umaskp(mode_t *u) {
624 umask(*u);
763c7aa2
ZJS
625}
626
04d39279
LP
627static inline void close_pipep(int (*p)[2]) {
628 close_pipe(*p);
629}
630
14bf2c9d
LP
631DEFINE_TRIVIAL_CLEANUP_FUNC(FILE*, fclose);
632DEFINE_TRIVIAL_CLEANUP_FUNC(FILE*, pclose);
633DEFINE_TRIVIAL_CLEANUP_FUNC(DIR*, closedir);
634DEFINE_TRIVIAL_CLEANUP_FUNC(FILE*, endmntent);
5862d652 635
dfb33a97 636#define _cleanup_free_ _cleanup_(freep)
dfb33a97 637#define _cleanup_close_ _cleanup_(closep)
dfb33a97
LP
638#define _cleanup_umask_ _cleanup_(umaskp)
639#define _cleanup_globfree_ _cleanup_(globfree)
1ca208fb
ZJS
640#define _cleanup_fclose_ _cleanup_(fclosep)
641#define _cleanup_pclose_ _cleanup_(pclosep)
642#define _cleanup_closedir_ _cleanup_(closedirp)
5862d652 643#define _cleanup_endmntent_ _cleanup_(endmntentp)
04d39279 644#define _cleanup_close_pipe_ _cleanup_(close_pipep)
c84a9488 645
750ef272 646_malloc_ _alloc_(1, 2) static inline void *malloc_multiply(size_t a, size_t b) {
aa408e77 647 if (_unlikely_(b == 0 || a > ((size_t) -1) / b))
4b8772bf
LP
648 return NULL;
649
650 return malloc(a * b);
651}
652
750ef272 653_alloc_(2, 3) static inline void *memdup_multiply(const void *p, size_t a, size_t b) {
aa408e77 654 if (_unlikely_(b == 0 || a > ((size_t) -1) / b))
4b8772bf
LP
655 return NULL;
656
657 return memdup(p, a * b);
658}
0b507b17 659
44a6b1b6
ZJS
660bool filename_is_safe(const char *p) _pure_;
661bool path_is_safe(const char *p) _pure_;
662bool string_is_safe(const char *p) _pure_;
663bool string_has_cc(const char *p) _pure_;
cfbc22ab 664
e3e0314b
ZJS
665/**
666 * Check if a string contains any glob patterns.
667 */
668_pure_ static inline bool string_is_glob(const char *p) {
669 return !!strpbrk(p, GLOB_CHARS);
670}
671
a9e12476
KS
672void *xbsearch_r(const void *key, const void *base, size_t nmemb, size_t size,
673 int (*compar) (const void *, const void *, void *),
674 void *arg);
09017585
MS
675
676bool is_locale_utf8(void);
c339d977
MS
677
678typedef enum DrawSpecialChar {
45a5ff0d
MS
679 DRAW_TREE_VERT,
680 DRAW_TREE_BRANCH,
681 DRAW_TREE_RIGHT,
55c0b89c 682 DRAW_TREE_SPACE,
c339d977 683 DRAW_TRIANGULAR_BULLET,
3deadb91 684 DRAW_BLACK_CIRCLE,
c339d977
MS
685 _DRAW_SPECIAL_CHAR_MAX
686} DrawSpecialChar;
687const char *draw_special_char(DrawSpecialChar ch);
409bc9c3
LP
688
689char *strreplace(const char *text, const char *old_string, const char *new_string);
e8bc0ea2
LP
690
691char *strip_tab_ansi(char **p, size_t *l);
240dbaa4
LP
692
693int on_ac_power(void);
f74e605f 694
fabe5c0e
LP
695int search_and_fopen(const char *path, const char *mode, const char **search, FILE **_f);
696int search_and_fopen_nulstr(const char *path, const char *mode, const char *search, FILE **_f);
697
9db11a99
LP
698#define FOREACH_LINE(line, f, on_error) \
699 for (;;) \
f74e605f
LP
700 if (!fgets(line, sizeof(line), f)) { \
701 if (ferror(f)) { \
702 on_error; \
703 } \
704 break; \
705 } else
9db11a99
LP
706
707#define FOREACH_DIRENT(de, d, on_error) \
708 for (errno = 0, de = readdir(d);; errno = 0, de = readdir(d)) \
709 if (!de) { \
8333c77e 710 if (errno > 0) { \
9db11a99
LP
711 on_error; \
712 } \
713 break; \
714 } else if (ignore_file((de)->d_name)) \
715 continue; \
716 else
6282c859
MS
717
718static inline void *mempset(void *s, int c, size_t n) {
719 memset(s, c, n);
dfb33a97 720 return (uint8_t*)s + n;
6282c859 721}
66e35261
LP
722
723char *hexmem(const void *p, size_t l);
2181a7f5
LP
724void *unhexmem(const char *p, size_t l);
725
a432cb69 726char *strextend(char **x, ...) _sentinel_;
9a17484d 727char *strrep(const char *s, unsigned n);
392d5b37
LP
728
729void* greedy_realloc(void **p, size_t *allocated, size_t need);
4545a231 730void* greedy_realloc0(void **p, size_t *allocated, size_t need);
2244a6fb 731#define GREEDY_REALLOC(array, allocated, need) \
dfb33a97 732 greedy_realloc((void**) &(array), &(allocated), sizeof((array)[0]) * (need))
4545a231
DH
733#define GREEDY_REALLOC0(array, allocated, need) \
734 greedy_realloc0((void**) &(array), &(allocated), sizeof((array)[0]) * (need))
5c0aa72a 735
a1937e67
DH
736#define GREEDY_REALLOC0_T(array, count, need) \
737 ({ \
738 size_t _size = (count) * sizeof((array)[0]); \
739 void *_ptr = GREEDY_REALLOC0((array), _size, (need)); \
740 if (_ptr) \
741 (count) = _size / sizeof((array)[0]); \
742 _ptr; \
743 })
744
5c0d398d 745static inline void _reset_errno_(int *saved_errno) {
5c0aa72a
LP
746 errno = *saved_errno;
747}
748
2a371001 749#define PROTECT_ERRNO _cleanup_(_reset_errno_) __attribute__((unused)) int _saved_errno_ = errno
5c0d398d 750
d6dd604b 751struct _umask_struct_ {
5c0d398d
LP
752 mode_t mask;
753 bool quit;
754};
755
d6dd604b 756static inline void _reset_umask_(struct _umask_struct_ *s) {
5c0d398d
LP
757 umask(s->mask);
758};
759
760#define RUN_WITH_UMASK(mask) \
d6dd604b 761 for (_cleanup_(_reset_umask_) struct _umask_struct_ _saved_umask_ = { umask(mask), false }; \
5c0d398d
LP
762 !_saved_umask_.quit ; \
763 _saved_umask_.quit = true)
144e51ec
CR
764
765static inline unsigned u64log2(uint64_t n) {
ec417ccc 766#if __SIZEOF_LONG_LONG__ == 8
693eb9a2 767 return (n > 1) ? (unsigned) __builtin_clzll(n) ^ 63U : 0;
ec417ccc
LP
768#else
769#error "Wut?"
770#endif
771}
772
773static inline unsigned u32ctz(uint32_t n) {
774#if __SIZEOF_INT__ == 4
775 return __builtin_ctz(n);
776#else
777#error "Wut?"
778#endif
144e51ec 779}
79d860fe
MP
780
781static inline bool logind_running(void) {
782 return access("/run/systemd/seats/", F_OK) >= 0;
783}
4b73a0c0 784
82da66fb
LP
785#define DECIMAL_STR_WIDTH(x) \
786 ({ \
787 typeof(x) _x_ = (x); \
788 unsigned ans = 1; \
789 while (_x_ /= 10) \
790 ans++; \
791 ans; \
792 })
75add28a 793
4b73a0c0 794int unlink_noerrno(const char *path);
ed5c5dbd 795
82da66fb
LP
796#define alloca0(n) \
797 ({ \
798 char *_new_; \
799 size_t _len_ = n; \
800 _new_ = alloca(_len_); \
801 (void *) memset(_new_, 0, _len_); \
ed5c5dbd 802 })
66060897
LP
803
804#define strappenda(a, b) \
805 ({ \
806 const char *_a_ = (a), *_b_ = (b); \
807 char *_c_; \
808 size_t _x_, _y_; \
809 _x_ = strlen(_a_); \
810 _y_ = strlen(_b_); \
811 _c_ = alloca(_x_ + _y_ + 1); \
812 strcpy(stpcpy(_c_, _a_), _b_); \
813 _c_; \
814 })
31885cd5
ZJS
815
816#define procfs_file_alloca(pid, field) \
817 ({ \
818 pid_t _pid_ = (pid); \
b68fa010
SP
819 const char *_r_; \
820 if (_pid_ == 0) { \
821 _r_ = ("/proc/self/" field); \
822 } else { \
823 _r_ = alloca(strlen("/proc/") + DECIMAL_STR_MAX(pid_t) + 1 + sizeof(field)); \
824 sprintf((char*) _r_, "/proc/"PID_FMT"/" field, _pid_); \
825 } \
31885cd5
ZJS
826 _r_; \
827 })
d6dd604b
LP
828
829struct _locale_struct_ {
830 locale_t saved_locale;
831 locale_t new_locale;
832 bool quit;
833};
834
835static inline void _reset_locale_(struct _locale_struct_ *s) {
836 PROTECT_ERRNO;
837 if (s->saved_locale != (locale_t) 0)
838 uselocale(s->saved_locale);
839 if (s->new_locale != (locale_t) 0)
840 freelocale(s->new_locale);
841}
842
843#define RUN_WITH_LOCALE(mask, loc) \
844 for (_cleanup_(_reset_locale_) struct _locale_struct_ _saved_locale_ = { (locale_t) 0, (locale_t) 0, false }; \
845 ({ \
846 if (!_saved_locale_.quit) { \
847 PROTECT_ERRNO; \
848 _saved_locale_.new_locale = newlocale((mask), (loc), (locale_t) 0); \
849 if (_saved_locale_.new_locale != (locale_t) 0) \
850 _saved_locale_.saved_locale = uselocale(_saved_locale_.new_locale); \
851 } \
852 !_saved_locale_.quit; }) ; \
853 _saved_locale_.quit = true)
aa96c6cb 854
44a6b1b6 855bool id128_is_valid(const char *s) _pure_;
d4ac85c6
LP
856
857int split_pair(const char *s, const char *sep, char **l, char **r);
7ff7394d 858
74df0fca 859int shall_restore_state(void);
295edddf 860
7ff7394d
ZJS
861/**
862 * Normal qsort requires base to be nonnull. Here were require
863 * that only if nmemb > 0.
864 */
865static inline void qsort_safe(void *base, size_t nmemb, size_t size,
866 int (*compar)(const void *, const void *)) {
867 if (nmemb) {
868 assert(base);
869 qsort(base, nmemb, size, compar);
870 }
871}
74df0fca
LP
872
873int proc_cmdline(char **ret);
059cb385 874int parse_proc_cmdline(int (*parse_word)(const char *key, const char *value));
bc9fd78c
LP
875
876int container_get_leader(const char *machine, pid_t *pid);
877
a4475f57
LP
878int namespace_open(pid_t pid, int *pidns_fd, int *mntns_fd, int *root_fd);
879int namespace_enter(int pidns_fd, int mntns_fd, int root_fd);
bf108e55 880
9f5650ae
LP
881bool pid_is_alive(pid_t pid);
882bool pid_is_unwaited(pid_t pid);
eff05270
LP
883
884int getpeercred(int fd, struct ucred *ucred);
885int getpeersec(int fd, char **ret);
8e33886e 886
65b3903f
ZJS
887int writev_safe(int fd, const struct iovec *w, int j);
888
889int mkostemp_safe(char *pattern, int flags);
8e33886e 890int open_tmpfile(const char *path, int flags);
fdb9161c
LP
891
892int fd_warn_permissions(const char *path, int fd);
6afc95b7 893
ac45f971
LP
894unsigned long personality_from_string(const char *p);
895const char *personality_to_string(unsigned long);
1c231f56
LP
896
897uint64_t physical_memory(void);
6db615c1
LP
898
899char* mount_test_option(const char *haystack, const char *needle);