]> git.ipfire.org Git - thirdparty/systemd.git/blob - src/basic/util.h
util-lib: split out IO related calls to io-util.[ch]
[thirdparty/systemd.git] / src / basic / util.h
1 /*-*- Mode: C; c-basic-offset: 8; indent-tabs-mode: nil -*-*/
2
3 #pragma once
4
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
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
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
18 Lesser General Public License for more details.
19
20 You should have received a copy of the GNU Lesser General Public License
21 along with systemd; If not, see <http://www.gnu.org/licenses/>.
22 ***/
23
24 #include <alloca.h>
25 #include <dirent.h>
26 #include <fcntl.h>
27 #include <inttypes.h>
28 #include <limits.h>
29 #include <locale.h>
30 #include <mntent.h>
31 #include <stdarg.h>
32 #include <stdbool.h>
33 #include <stddef.h>
34 #include <stdio.h>
35 #include <stdlib.h>
36 #include <sys/inotify.h>
37 #include <sys/socket.h>
38 #include <sys/stat.h>
39 #include <sys/statfs.h>
40 #include <sys/types.h>
41 #include <time.h>
42 #include <unistd.h>
43
44 #include "formats-util.h"
45 #include "macro.h"
46 #include "missing.h"
47 #include "time-util.h"
48
49 /* What is interpreted as whitespace? */
50 #define WHITESPACE " \t\n\r"
51 #define NEWLINE "\n\r"
52 #define QUOTES "\"\'"
53 #define COMMENTS "#;"
54 #define GLOB_CHARS "*?["
55
56 #define FORMAT_BYTES_MAX 8
57
58 size_t page_size(void) _pure_;
59 #define PAGE_ALIGN(l) ALIGN_TO((l), page_size())
60
61 #define new(t, n) ((t*) malloc_multiply(sizeof(t), (n)))
62
63 #define new0(t, n) ((t*) calloc((n), sizeof(t)))
64
65 #define newa(t, n) ((t*) alloca(sizeof(t)*(n)))
66
67 #define newa0(t, n) ((t*) alloca0(sizeof(t)*(n)))
68
69 #define newdup(t, p, n) ((t*) memdup_multiply(p, sizeof(t), (n)))
70
71 #define malloc0(n) (calloc(1, (n)))
72
73 static inline void *mfree(void *memory) {
74 free(memory);
75 return NULL;
76 }
77
78 static inline const char* yes_no(bool b) {
79 return b ? "yes" : "no";
80 }
81
82 static inline const char* true_false(bool b) {
83 return b ? "true" : "false";
84 }
85
86 static inline const char* one_zero(bool b) {
87 return b ? "1" : "0";
88 }
89
90 int parse_size(const char *t, uint64_t base, uint64_t *size);
91
92 int parse_boolean(const char *v) _pure_;
93 int parse_pid(const char *s, pid_t* ret_pid);
94 int parse_uid(const char *s, uid_t* ret_uid);
95 #define parse_gid(s, ret_gid) parse_uid(s, ret_gid)
96
97 bool uid_is_valid(uid_t uid);
98
99 static inline bool gid_is_valid(gid_t gid) {
100 return uid_is_valid((uid_t) gid);
101 }
102
103 int safe_atou(const char *s, unsigned *ret_u);
104 int safe_atoi(const char *s, int *ret_i);
105
106 int safe_atollu(const char *s, unsigned long long *ret_u);
107 int safe_atolli(const char *s, long long int *ret_i);
108
109 int safe_atod(const char *s, double *ret_d);
110
111 int safe_atou8(const char *s, uint8_t *ret);
112
113 #if LONG_MAX == INT_MAX
114 static inline int safe_atolu(const char *s, unsigned long *ret_u) {
115 assert_cc(sizeof(unsigned long) == sizeof(unsigned));
116 return safe_atou(s, (unsigned*) ret_u);
117 }
118 static inline int safe_atoli(const char *s, long int *ret_u) {
119 assert_cc(sizeof(long int) == sizeof(int));
120 return safe_atoi(s, (int*) ret_u);
121 }
122 #else
123 static inline int safe_atolu(const char *s, unsigned long *ret_u) {
124 assert_cc(sizeof(unsigned long) == sizeof(unsigned long long));
125 return safe_atollu(s, (unsigned long long*) ret_u);
126 }
127 static inline int safe_atoli(const char *s, long int *ret_u) {
128 assert_cc(sizeof(long int) == sizeof(long long int));
129 return safe_atolli(s, (long long int*) ret_u);
130 }
131 #endif
132
133 static inline int safe_atou32(const char *s, uint32_t *ret_u) {
134 assert_cc(sizeof(uint32_t) == sizeof(unsigned));
135 return safe_atou(s, (unsigned*) ret_u);
136 }
137
138 static inline int safe_atoi32(const char *s, int32_t *ret_i) {
139 assert_cc(sizeof(int32_t) == sizeof(int));
140 return safe_atoi(s, (int*) ret_i);
141 }
142
143 static inline int safe_atou64(const char *s, uint64_t *ret_u) {
144 assert_cc(sizeof(uint64_t) == sizeof(unsigned long long));
145 return safe_atollu(s, (unsigned long long*) ret_u);
146 }
147
148 static inline int safe_atoi64(const char *s, int64_t *ret_i) {
149 assert_cc(sizeof(int64_t) == sizeof(long long int));
150 return safe_atolli(s, (long long int*) ret_i);
151 }
152
153 int safe_atou16(const char *s, uint16_t *ret);
154 int safe_atoi16(const char *s, int16_t *ret);
155
156 int readlinkat_malloc(int fd, const char *p, char **ret);
157 int readlink_malloc(const char *p, char **r);
158 int readlink_value(const char *p, char **ret);
159 int readlink_and_make_absolute(const char *p, char **r);
160 int readlink_and_canonicalize(const char *p, char **r);
161
162 char *file_in_same_dir(const char *path, const char *filename);
163
164 int rmdir_parents(const char *path, const char *stop);
165
166 char hexchar(int x) _const_;
167 int unhexchar(char c) _const_;
168 char octchar(int x) _const_;
169 int unoctchar(char c) _const_;
170 char decchar(int x) _const_;
171 int undecchar(char c) _const_;
172 char base32hexchar(int x) _const_;
173 int unbase32hexchar(char c) _const_;
174 char base64char(int x) _const_;
175 int unbase64char(char c) _const_;
176
177 bool dirent_is_file(const struct dirent *de) _pure_;
178 bool dirent_is_file_with_suffix(const struct dirent *de, const char *suffix) _pure_;
179
180 bool hidden_file(const char *filename) _pure_;
181
182 /* For basic lookup tables with strictly enumerated entries */
183 #define _DEFINE_STRING_TABLE_LOOKUP_TO_STRING(name,type,scope) \
184 scope const char *name##_to_string(type i) { \
185 if (i < 0 || i >= (type) ELEMENTSOF(name##_table)) \
186 return NULL; \
187 return name##_table[i]; \
188 }
189
190 ssize_t string_table_lookup(const char * const *table, size_t len, const char *key);
191
192 #define _DEFINE_STRING_TABLE_LOOKUP_FROM_STRING(name,type,scope) \
193 scope type name##_from_string(const char *s) { \
194 return (type) string_table_lookup(name##_table, ELEMENTSOF(name##_table), s); \
195 }
196
197 #define _DEFINE_STRING_TABLE_LOOKUP(name,type,scope) \
198 _DEFINE_STRING_TABLE_LOOKUP_TO_STRING(name,type,scope) \
199 _DEFINE_STRING_TABLE_LOOKUP_FROM_STRING(name,type,scope) \
200 struct __useless_struct_to_allow_trailing_semicolon__
201
202 #define DEFINE_STRING_TABLE_LOOKUP(name,type) _DEFINE_STRING_TABLE_LOOKUP(name,type,)
203 #define DEFINE_PRIVATE_STRING_TABLE_LOOKUP(name,type) _DEFINE_STRING_TABLE_LOOKUP(name,type,static)
204 #define DEFINE_PRIVATE_STRING_TABLE_LOOKUP_TO_STRING(name,type) _DEFINE_STRING_TABLE_LOOKUP_TO_STRING(name,type,static)
205 #define DEFINE_PRIVATE_STRING_TABLE_LOOKUP_FROM_STRING(name,type) _DEFINE_STRING_TABLE_LOOKUP_FROM_STRING(name,type,static)
206
207 /* For string conversions where numbers are also acceptable */
208 #define DEFINE_STRING_TABLE_LOOKUP_WITH_FALLBACK(name,type,max) \
209 int name##_to_string_alloc(type i, char **str) { \
210 char *s; \
211 if (i < 0 || i > max) \
212 return -ERANGE; \
213 if (i < (type) ELEMENTSOF(name##_table)) { \
214 s = strdup(name##_table[i]); \
215 if (!s) \
216 return -ENOMEM; \
217 } else { \
218 if (asprintf(&s, "%i", i) < 0) \
219 return -ENOMEM; \
220 } \
221 *str = s; \
222 return 0; \
223 } \
224 type name##_from_string(const char *s) { \
225 type i; \
226 unsigned u = 0; \
227 if (!s) \
228 return (type) -1; \
229 for (i = 0; i < (type) ELEMENTSOF(name##_table); i++) \
230 if (streq_ptr(name##_table[i], s)) \
231 return i; \
232 if (safe_atou(s, &u) >= 0 && u <= max) \
233 return (type) u; \
234 return (type) -1; \
235 } \
236 struct __useless_struct_to_allow_trailing_semicolon__
237
238 bool fstype_is_network(const char *fstype);
239
240 int fopen_temporary(const char *path, FILE **_f, char **_temp_path);
241
242 bool is_device_path(const char *path);
243
244 int dir_is_empty(const char *path);
245 char* dirname_malloc(const char *path);
246
247 static inline int dir_is_populated(const char *path) {
248 int r;
249 r = dir_is_empty(path);
250 if (r < 0)
251 return r;
252 return !r;
253 }
254
255 char* lookup_uid(uid_t uid);
256 char* getlogname_malloc(void);
257 char* getusername_malloc(void);
258
259 int chmod_and_chown(const char *path, mode_t mode, uid_t uid, gid_t gid);
260 int fchmod_and_fchown(int fd, mode_t mode, uid_t uid, gid_t gid);
261
262 typedef long statfs_f_type_t;
263
264 bool is_fs_type(const struct statfs *s, statfs_f_type_t magic_value) _pure_;
265 int fd_check_fstype(int fd, statfs_f_type_t magic_value);
266 int path_check_fstype(const char *path, statfs_f_type_t magic_value);
267
268 bool is_temporary_fs(const struct statfs *s) _pure_;
269 int fd_is_temporary_fs(int fd);
270
271 #define xsprintf(buf, fmt, ...) \
272 assert_message_se((size_t) snprintf(buf, ELEMENTSOF(buf), fmt, __VA_ARGS__) < ELEMENTSOF(buf), \
273 "xsprintf: " #buf "[] must be big enough")
274
275 int files_same(const char *filea, const char *fileb);
276
277 int running_in_chroot(void);
278
279 int touch_file(const char *path, bool parents, usec_t stamp, uid_t uid, gid_t gid, mode_t mode);
280 int touch(const char *path);
281
282 noreturn void freeze(void);
283
284 bool null_or_empty(struct stat *st) _pure_;
285 int null_or_empty_path(const char *fn);
286 int null_or_empty_fd(int fd);
287
288 DIR *xopendirat(int dirfd, const char *name, int flags);
289
290 char *fstab_node_to_udev_node(const char *p);
291
292 void execute_directories(const char* const* directories, usec_t timeout, char *argv[]);
293
294 bool plymouth_running(void);
295
296 int symlink_idempotent(const char *from, const char *to);
297
298 int symlink_atomic(const char *from, const char *to);
299 int mknod_atomic(const char *path, mode_t mode, dev_t dev);
300 int mkfifo_atomic(const char *path, mode_t mode);
301
302 int fchmod_umask(int fd, mode_t mode);
303
304 bool display_is_local(const char *display) _pure_;
305 int socket_from_display(const char *display, char **path);
306
307 int get_user_creds(const char **username, uid_t *uid, gid_t *gid, const char **home, const char **shell);
308 int get_group_creds(const char **groupname, gid_t *gid);
309
310 int in_gid(gid_t gid);
311 int in_group(const char *name);
312
313 char* uid_to_name(uid_t uid);
314 char* gid_to_name(gid_t gid);
315
316 int glob_exists(const char *path);
317 int glob_extend(char ***strv, const char *path);
318
319 int dirent_ensure_type(DIR *d, struct dirent *de);
320
321 int get_files_in_directory(const char *path, char ***list);
322
323 bool is_main_thread(void);
324
325 int block_get_whole_disk(dev_t d, dev_t *ret);
326
327 #define NULSTR_FOREACH(i, l) \
328 for ((i) = (l); (i) && *(i); (i) = strchr((i), 0)+1)
329
330 #define NULSTR_FOREACH_PAIR(i, j, l) \
331 for ((i) = (l), (j) = strchr((i), 0)+1; (i) && *(i); (i) = strchr((j), 0)+1, (j) = *(i) ? strchr((i), 0)+1 : (i))
332
333 int ioprio_class_to_string_alloc(int i, char **s);
334 int ioprio_class_from_string(const char *s);
335
336 const char *sigchld_code_to_string(int i) _const_;
337 int sigchld_code_from_string(const char *s) _pure_;
338
339 int log_facility_unshifted_to_string_alloc(int i, char **s);
340 int log_facility_unshifted_from_string(const char *s);
341 bool log_facility_unshifted_is_valid(int faciliy);
342
343 int log_level_to_string_alloc(int i, char **s);
344 int log_level_from_string(const char *s);
345 bool log_level_is_valid(int level);
346
347 int sched_policy_to_string_alloc(int i, char **s);
348 int sched_policy_from_string(const char *s);
349
350 const char *rlimit_to_string(int i) _const_;
351 int rlimit_from_string(const char *s) _pure_;
352
353 int ip_tos_to_string_alloc(int i, char **s);
354 int ip_tos_from_string(const char *s);
355
356 extern int saved_argc;
357 extern char **saved_argv;
358
359 bool kexec_loaded(void);
360
361 int prot_from_flags(int flags) _const_;
362
363 char *format_bytes(char *buf, size_t l, uint64_t t);
364
365 void* memdup(const void *p, size_t l) _alloc_(2);
366
367 int fd_inc_sndbuf(int fd, size_t n);
368 int fd_inc_rcvbuf(int fd, size_t n);
369
370 int fork_agent(pid_t *pid, const int except[], unsigned n_except, const char *path, ...);
371
372 int setrlimit_closest(int resource, const struct rlimit *rlim);
373
374 bool http_url_is_valid(const char *url) _pure_;
375 bool documentation_url_is_valid(const char *url) _pure_;
376
377 bool http_etag_is_valid(const char *etag);
378
379 bool in_initrd(void);
380
381 int get_home_dir(char **ret);
382 int get_shell(char **_ret);
383
384 static inline void freep(void *p) {
385 free(*(void**) p);
386 }
387
388 static inline void umaskp(mode_t *u) {
389 umask(*u);
390 }
391
392 DEFINE_TRIVIAL_CLEANUP_FUNC(FILE*, endmntent);
393
394 #define _cleanup_free_ _cleanup_(freep)
395 #define _cleanup_umask_ _cleanup_(umaskp)
396 #define _cleanup_globfree_ _cleanup_(globfree)
397 #define _cleanup_endmntent_ _cleanup_(endmntentp)
398
399 _malloc_ _alloc_(1, 2) static inline void *malloc_multiply(size_t a, size_t b) {
400 if (_unlikely_(b != 0 && a > ((size_t) -1) / b))
401 return NULL;
402
403 return malloc(a * b);
404 }
405
406 _alloc_(2, 3) static inline void *realloc_multiply(void *p, size_t a, size_t b) {
407 if (_unlikely_(b != 0 && a > ((size_t) -1) / b))
408 return NULL;
409
410 return realloc(p, a * b);
411 }
412
413 _alloc_(2, 3) static inline void *memdup_multiply(const void *p, size_t a, size_t b) {
414 if (_unlikely_(b != 0 && a > ((size_t) -1) / b))
415 return NULL;
416
417 return memdup(p, a * b);
418 }
419
420 bool filename_is_valid(const char *p) _pure_;
421 bool path_is_safe(const char *p) _pure_;
422 bool string_is_safe(const char *p) _pure_;
423
424 /**
425 * Check if a string contains any glob patterns.
426 */
427 _pure_ static inline bool string_is_glob(const char *p) {
428 return !!strpbrk(p, GLOB_CHARS);
429 }
430
431 void *xbsearch_r(const void *key, const void *base, size_t nmemb, size_t size,
432 int (*compar) (const void *, const void *, void *),
433 void *arg);
434
435 #define _(String) gettext (String)
436 #define N_(String) String
437 void init_gettext(void);
438 bool is_locale_utf8(void);
439
440 typedef enum DrawSpecialChar {
441 DRAW_TREE_VERTICAL,
442 DRAW_TREE_BRANCH,
443 DRAW_TREE_RIGHT,
444 DRAW_TREE_SPACE,
445 DRAW_TRIANGULAR_BULLET,
446 DRAW_BLACK_CIRCLE,
447 DRAW_ARROW,
448 DRAW_DASH,
449 _DRAW_SPECIAL_CHAR_MAX
450 } DrawSpecialChar;
451
452 const char *draw_special_char(DrawSpecialChar ch);
453
454 int on_ac_power(void);
455
456 int search_and_fopen(const char *path, const char *mode, const char *root, const char **search, FILE **_f);
457 int search_and_fopen_nulstr(const char *path, const char *mode, const char *root, const char *search, FILE **_f);
458
459 #define FOREACH_LINE(line, f, on_error) \
460 for (;;) \
461 if (!fgets(line, sizeof(line), f)) { \
462 if (ferror(f)) { \
463 on_error; \
464 } \
465 break; \
466 } else
467
468 #define FOREACH_DIRENT(de, d, on_error) \
469 for (errno = 0, de = readdir(d);; errno = 0, de = readdir(d)) \
470 if (!de) { \
471 if (errno > 0) { \
472 on_error; \
473 } \
474 break; \
475 } else if (hidden_file((de)->d_name)) \
476 continue; \
477 else
478
479 #define FOREACH_DIRENT_ALL(de, d, on_error) \
480 for (errno = 0, de = readdir(d);; errno = 0, de = readdir(d)) \
481 if (!de) { \
482 if (errno > 0) { \
483 on_error; \
484 } \
485 break; \
486 } else
487
488 static inline void *mempset(void *s, int c, size_t n) {
489 memset(s, c, n);
490 return (uint8_t*)s + n;
491 }
492
493 char *hexmem(const void *p, size_t l);
494 int unhexmem(const char *p, size_t l, void **mem, size_t *len);
495
496 char *base32hexmem(const void *p, size_t l, bool padding);
497 int unbase32hexmem(const char *p, size_t l, bool padding, void **mem, size_t *len);
498
499 char *base64mem(const void *p, size_t l);
500 int unbase64mem(const char *p, size_t l, void **mem, size_t *len);
501
502 void* greedy_realloc(void **p, size_t *allocated, size_t need, size_t size);
503 void* greedy_realloc0(void **p, size_t *allocated, size_t need, size_t size);
504 #define GREEDY_REALLOC(array, allocated, need) \
505 greedy_realloc((void**) &(array), &(allocated), (need), sizeof((array)[0]))
506
507 #define GREEDY_REALLOC0(array, allocated, need) \
508 greedy_realloc0((void**) &(array), &(allocated), (need), sizeof((array)[0]))
509
510 static inline void _reset_errno_(int *saved_errno) {
511 errno = *saved_errno;
512 }
513
514 #define PROTECT_ERRNO _cleanup_(_reset_errno_) __attribute__((unused)) int _saved_errno_ = errno
515
516 static inline int negative_errno(void) {
517 /* This helper should be used to shut up gcc if you know 'errno' is
518 * negative. Instead of "return -errno;", use "return negative_errno();"
519 * It will suppress bogus gcc warnings in case it assumes 'errno' might
520 * be 0 and thus the caller's error-handling might not be triggered. */
521 assert_return(errno > 0, -EINVAL);
522 return -errno;
523 }
524
525 struct _umask_struct_ {
526 mode_t mask;
527 bool quit;
528 };
529
530 static inline void _reset_umask_(struct _umask_struct_ *s) {
531 umask(s->mask);
532 };
533
534 #define RUN_WITH_UMASK(mask) \
535 for (_cleanup_(_reset_umask_) struct _umask_struct_ _saved_umask_ = { umask(mask), false }; \
536 !_saved_umask_.quit ; \
537 _saved_umask_.quit = true)
538
539 static inline unsigned u64log2(uint64_t n) {
540 #if __SIZEOF_LONG_LONG__ == 8
541 return (n > 1) ? (unsigned) __builtin_clzll(n) ^ 63U : 0;
542 #else
543 #error "Wut?"
544 #endif
545 }
546
547 static inline unsigned u32ctz(uint32_t n) {
548 #if __SIZEOF_INT__ == 4
549 return __builtin_ctz(n);
550 #else
551 #error "Wut?"
552 #endif
553 }
554
555 static inline unsigned log2i(int x) {
556 assert(x > 0);
557
558 return __SIZEOF_INT__ * 8 - __builtin_clz(x) - 1;
559 }
560
561 static inline unsigned log2u(unsigned x) {
562 assert(x > 0);
563
564 return sizeof(unsigned) * 8 - __builtin_clz(x) - 1;
565 }
566
567 static inline unsigned log2u_round_up(unsigned x) {
568 assert(x > 0);
569
570 if (x == 1)
571 return 0;
572
573 return log2u(x - 1) + 1;
574 }
575
576 #define DECIMAL_STR_WIDTH(x) \
577 ({ \
578 typeof(x) _x_ = (x); \
579 unsigned ans = 1; \
580 while (_x_ /= 10) \
581 ans++; \
582 ans; \
583 })
584
585 int unlink_noerrno(const char *path);
586
587 #define alloca0(n) \
588 ({ \
589 char *_new_; \
590 size_t _len_ = n; \
591 _new_ = alloca(_len_); \
592 (void *) memset(_new_, 0, _len_); \
593 })
594
595 /* It's not clear what alignment glibc/gcc alloca() guarantee, hence provide a guaranteed safe version */
596 #define alloca_align(size, align) \
597 ({ \
598 void *_ptr_; \
599 size_t _mask_ = (align) - 1; \
600 _ptr_ = alloca((size) + _mask_); \
601 (void*)(((uintptr_t)_ptr_ + _mask_) & ~_mask_); \
602 })
603
604 #define alloca0_align(size, align) \
605 ({ \
606 void *_new_; \
607 size_t _size_ = (size); \
608 _new_ = alloca_align(_size_, (align)); \
609 (void*)memset(_new_, 0, _size_); \
610 })
611
612 bool id128_is_valid(const char *s) _pure_;
613
614 int shall_restore_state(void);
615
616 /**
617 * Normal qsort requires base to be nonnull. Here were require
618 * that only if nmemb > 0.
619 */
620 static inline void qsort_safe(void *base, size_t nmemb, size_t size, comparison_fn_t compar) {
621 if (nmemb <= 1)
622 return;
623
624 assert(base);
625 qsort(base, nmemb, size, compar);
626 }
627
628 int proc_cmdline(char **ret);
629 int parse_proc_cmdline(int (*parse_word)(const char *key, const char *value));
630 int get_proc_cmdline_key(const char *parameter, char **value);
631
632 int container_get_leader(const char *machine, pid_t *pid);
633
634 int namespace_open(pid_t pid, int *pidns_fd, int *mntns_fd, int *netns_fd, int *userns_fd, int *root_fd);
635 int namespace_enter(int pidns_fd, int mntns_fd, int netns_fd, int userns_fd, int root_fd);
636
637 int getpeercred(int fd, struct ucred *ucred);
638 int getpeersec(int fd, char **ret);
639
640 int mkostemp_safe(char *pattern, int flags);
641 int open_tmpfile(const char *path, int flags);
642
643 int fd_warn_permissions(const char *path, int fd);
644
645 #ifndef PERSONALITY_INVALID
646 /* personality(7) documents that 0xffffffffUL is used for querying the
647 * current personality, hence let's use that here as error
648 * indicator. */
649 #define PERSONALITY_INVALID 0xffffffffLU
650 #endif
651
652 unsigned long personality_from_string(const char *p);
653 const char *personality_to_string(unsigned long);
654
655 uint64_t physical_memory(void);
656
657 void hexdump(FILE *f, const void *p, size_t s);
658
659 union file_handle_union {
660 struct file_handle handle;
661 char padding[sizeof(struct file_handle) + MAX_HANDLE_SZ];
662 };
663 #define FILE_HANDLE_INIT { .handle.handle_bytes = MAX_HANDLE_SZ }
664
665 int update_reboot_param_file(const char *param);
666
667 int umount_recursive(const char *target, int flags);
668
669 int bind_remount_recursive(const char *prefix, bool ro);
670
671 int fflush_and_check(FILE *f);
672
673 int tempfn_xxxxxx(const char *p, const char *extra, char **ret);
674 int tempfn_random(const char *p, const char *extra, char **ret);
675 int tempfn_random_child(const char *p, const char *extra, char **ret);
676
677 int take_password_lock(const char *root);
678
679 int is_symlink(const char *path);
680 int is_dir(const char *path, bool follow);
681 int is_device_node(const char *path);
682
683 #define INOTIFY_EVENT_MAX (sizeof(struct inotify_event) + NAME_MAX + 1)
684
685 #define FOREACH_INOTIFY_EVENT(e, buffer, sz) \
686 for ((e) = &buffer.ev; \
687 (uint8_t*) (e) < (uint8_t*) (buffer.raw) + (sz); \
688 (e) = (struct inotify_event*) ((uint8_t*) (e) + sizeof(struct inotify_event) + (e)->len))
689
690 union inotify_event_buffer {
691 struct inotify_event ev;
692 uint8_t raw[INOTIFY_EVENT_MAX];
693 };
694
695 #define laccess(path, mode) faccessat(AT_FDCWD, (path), (mode), AT_SYMLINK_NOFOLLOW)
696
697 ssize_t fgetxattrat_fake(int dirfd, const char *filename, const char *attribute, void *value, size_t size, int flags);
698
699 int fd_setcrtime(int fd, usec_t usec);
700 int fd_getcrtime(int fd, usec_t *usec);
701 int path_getcrtime(const char *p, usec_t *usec);
702 int fd_getcrtime_at(int dirfd, const char *name, usec_t *usec, int flags);
703
704 int chattr_fd(int fd, unsigned value, unsigned mask);
705 int chattr_path(const char *p, unsigned value, unsigned mask);
706
707 int read_attr_fd(int fd, unsigned *ret);
708 int read_attr_path(const char *p, unsigned *ret);
709
710 #define RLIMIT_MAKE_CONST(lim) ((struct rlimit) { lim, lim })
711
712 void sigkill_wait(pid_t *pid);
713 #define _cleanup_sigkill_wait_ _cleanup_(sigkill_wait)
714
715 int syslog_parse_priority(const char **p, int *priority, bool with_facility);
716
717 int rename_noreplace(int olddirfd, const char *oldpath, int newdirfd, const char *newpath);
718
719 int parse_mode(const char *s, mode_t *ret);
720
721 int mount_move_root(const char *path);
722
723 int reset_uid_gid(void);
724
725 int getxattr_malloc(const char *path, const char *name, char **value, bool allow_symlink);
726 int fgetxattr_malloc(int fd, const char *name, char **value);
727
728 int send_one_fd(int transport_fd, int fd, int flags);
729 int receive_one_fd(int transport_fd, int flags);
730
731 void nop_signal_handler(int sig);
732
733 int version(void);
734
735 bool fdname_is_valid(const char *s);
736
737 bool oom_score_adjust_is_valid(int oa);