| /*-*- Mode: C; c-basic-offset: 8; indent-tabs-mode: nil -*-*/ |
| |
| #pragma once |
| |
| /*** |
| This file is part of systemd. |
| |
| Copyright 2010 Lennart Poettering |
| |
| systemd is free software; you can redistribute it and/or modify it |
| under the terms of the GNU Lesser General Public License as published by |
| the Free Software Foundation; either version 2.1 of the License, or |
| (at your option) any later version. |
| |
| systemd is distributed in the hope that it will be useful, but |
| WITHOUT ANY WARRANTY; without even the implied warranty of |
| MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU |
| Lesser General Public License for more details. |
| |
| You should have received a copy of the GNU Lesser General Public License |
| along with systemd; If not, see <http://www.gnu.org/licenses/>. |
| ***/ |
| |
| #include <alloca.h> |
| #include <dirent.h> |
| #include <fcntl.h> |
| #include <inttypes.h> |
| #include <limits.h> |
| #include <locale.h> |
| #include <mntent.h> |
| #include <stdarg.h> |
| #include <stdbool.h> |
| #include <stddef.h> |
| #include <stdio.h> |
| #include <stdlib.h> |
| #include <sys/inotify.h> |
| #include <sys/socket.h> |
| #include <sys/stat.h> |
| #include <sys/statfs.h> |
| #include <sys/types.h> |
| #include <time.h> |
| #include <unistd.h> |
| |
| #include "formats-util.h" |
| #include "macro.h" |
| #include "missing.h" |
| #include "time-util.h" |
| |
| /* What is interpreted as whitespace? */ |
| #define WHITESPACE " \t\n\r" |
| #define NEWLINE "\n\r" |
| #define QUOTES "\"\'" |
| #define COMMENTS "#;" |
| #define GLOB_CHARS "*?[" |
| |
| /* What characters are special in the shell? */ |
| /* must be escaped outside and inside double-quotes */ |
| #define SHELL_NEED_ESCAPE "\"\\`$" |
| /* can be escaped or double-quoted */ |
| #define SHELL_NEED_QUOTES SHELL_NEED_ESCAPE GLOB_CHARS "'()<>|&;" |
| |
| #define FORMAT_BYTES_MAX 8 |
| |
| size_t page_size(void) _pure_; |
| #define PAGE_ALIGN(l) ALIGN_TO((l), page_size()) |
| |
| #define streq(a,b) (strcmp((a),(b)) == 0) |
| #define strneq(a, b, n) (strncmp((a), (b), (n)) == 0) |
| #define strcaseeq(a,b) (strcasecmp((a),(b)) == 0) |
| #define strncaseeq(a, b, n) (strncasecmp((a), (b), (n)) == 0) |
| |
| bool streq_ptr(const char *a, const char *b) _pure_; |
| int strcmp_ptr(const char *a, const char *b) _pure_; |
| |
| #define new(t, n) ((t*) malloc_multiply(sizeof(t), (n))) |
| |
| #define new0(t, n) ((t*) calloc((n), sizeof(t))) |
| |
| #define newa(t, n) ((t*) alloca(sizeof(t)*(n))) |
| |
| #define newa0(t, n) ((t*) alloca0(sizeof(t)*(n))) |
| |
| #define newdup(t, p, n) ((t*) memdup_multiply(p, sizeof(t), (n))) |
| |
| #define malloc0(n) (calloc(1, (n))) |
| |
| static inline void *mfree(void *memory) { |
| free(memory); |
| return NULL; |
| } |
| |
| static inline const char* yes_no(bool b) { |
| return b ? "yes" : "no"; |
| } |
| |
| static inline const char* true_false(bool b) { |
| return b ? "true" : "false"; |
| } |
| |
| static inline const char* one_zero(bool b) { |
| return b ? "1" : "0"; |
| } |
| |
| static inline const char* strempty(const char *s) { |
| return s ? s : ""; |
| } |
| |
| static inline const char* strnull(const char *s) { |
| return s ? s : "(null)"; |
| } |
| |
| static inline const char *strna(const char *s) { |
| return s ? s : "n/a"; |
| } |
| |
| static inline bool isempty(const char *p) { |
| return !p || !p[0]; |
| } |
| |
| static inline char *startswith(const char *s, const char *prefix) { |
| size_t l; |
| |
| l = strlen(prefix); |
| if (strncmp(s, prefix, l) == 0) |
| return (char*) s + l; |
| |
| return NULL; |
| } |
| |
| static inline char *startswith_no_case(const char *s, const char *prefix) { |
| size_t l; |
| |
| l = strlen(prefix); |
| if (strncasecmp(s, prefix, l) == 0) |
| return (char*) s + l; |
| |
| return NULL; |
| } |
| |
| char *endswith(const char *s, const char *postfix) _pure_; |
| char *endswith_no_case(const char *s, const char *postfix) _pure_; |
| |
| char *first_word(const char *s, const char *word) _pure_; |
| |
| int close_nointr(int fd); |
| int safe_close(int fd); |
| void safe_close_pair(int p[]); |
| |
| void close_many(const int fds[], unsigned n_fd); |
| |
| int fclose_nointr(FILE *f); |
| FILE* safe_fclose(FILE *f); |
| DIR* safe_closedir(DIR *f); |
| |
| int parse_size(const char *t, uint64_t base, uint64_t *size); |
| |
| int parse_boolean(const char *v) _pure_; |
| int parse_pid(const char *s, pid_t* ret_pid); |
| int parse_uid(const char *s, uid_t* ret_uid); |
| #define parse_gid(s, ret_gid) parse_uid(s, ret_gid) |
| |
| bool uid_is_valid(uid_t uid); |
| |
| static inline bool gid_is_valid(gid_t gid) { |
| return uid_is_valid((uid_t) gid); |
| } |
| |
| int safe_atou(const char *s, unsigned *ret_u); |
| int safe_atoi(const char *s, int *ret_i); |
| |
| int safe_atollu(const char *s, unsigned long long *ret_u); |
| int safe_atolli(const char *s, long long int *ret_i); |
| |
| int safe_atod(const char *s, double *ret_d); |
| |
| int safe_atou8(const char *s, uint8_t *ret); |
| |
| #if LONG_MAX == INT_MAX |
| static inline int safe_atolu(const char *s, unsigned long *ret_u) { |
| assert_cc(sizeof(unsigned long) == sizeof(unsigned)); |
| return safe_atou(s, (unsigned*) ret_u); |
| } |
| static inline int safe_atoli(const char *s, long int *ret_u) { |
| assert_cc(sizeof(long int) == sizeof(int)); |
| return safe_atoi(s, (int*) ret_u); |
| } |
| #else |
| static inline int safe_atolu(const char *s, unsigned long *ret_u) { |
| assert_cc(sizeof(unsigned long) == sizeof(unsigned long long)); |
| return safe_atollu(s, (unsigned long long*) ret_u); |
| } |
| static inline int safe_atoli(const char *s, long int *ret_u) { |
| assert_cc(sizeof(long int) == sizeof(long long int)); |
| return safe_atolli(s, (long long int*) ret_u); |
| } |
| #endif |
| |
| static inline int safe_atou32(const char *s, uint32_t *ret_u) { |
| assert_cc(sizeof(uint32_t) == sizeof(unsigned)); |
| return safe_atou(s, (unsigned*) ret_u); |
| } |
| |
| static inline int safe_atoi32(const char *s, int32_t *ret_i) { |
| assert_cc(sizeof(int32_t) == sizeof(int)); |
| return safe_atoi(s, (int*) ret_i); |
| } |
| |
| static inline int safe_atou64(const char *s, uint64_t *ret_u) { |
| assert_cc(sizeof(uint64_t) == sizeof(unsigned long long)); |
| return safe_atollu(s, (unsigned long long*) ret_u); |
| } |
| |
| static inline int safe_atoi64(const char *s, int64_t *ret_i) { |
| assert_cc(sizeof(int64_t) == sizeof(long long int)); |
| return safe_atolli(s, (long long int*) ret_i); |
| } |
| |
| int safe_atou16(const char *s, uint16_t *ret); |
| int safe_atoi16(const char *s, int16_t *ret); |
| |
| const char* split(const char **state, size_t *l, const char *separator, bool quoted); |
| |
| #define FOREACH_WORD(word, length, s, state) \ |
| _FOREACH_WORD(word, length, s, WHITESPACE, false, state) |
| |
| #define FOREACH_WORD_SEPARATOR(word, length, s, separator, state) \ |
| _FOREACH_WORD(word, length, s, separator, false, state) |
| |
| #define FOREACH_WORD_QUOTED(word, length, s, state) \ |
| _FOREACH_WORD(word, length, s, WHITESPACE, true, state) |
| |
| #define _FOREACH_WORD(word, length, s, separator, quoted, state) \ |
| for ((state) = (s), (word) = split(&(state), &(length), (separator), (quoted)); (word); (word) = split(&(state), &(length), (separator), (quoted))) |
| |
| char *strappend(const char *s, const char *suffix); |
| char *strnappend(const char *s, const char *suffix, size_t length); |
| |
| int readlinkat_malloc(int fd, const char *p, char **ret); |
| int readlink_malloc(const char *p, char **r); |
| int readlink_value(const char *p, char **ret); |
| int readlink_and_make_absolute(const char *p, char **r); |
| int readlink_and_canonicalize(const char *p, char **r); |
| |
| char *strstrip(char *s); |
| char *delete_chars(char *s, const char *bad); |
| char *truncate_nl(char *s); |
| |
| char *file_in_same_dir(const char *path, const char *filename); |
| |
| int rmdir_parents(const char *path, const char *stop); |
| |
| char hexchar(int x) _const_; |
| int unhexchar(char c) _const_; |
| char octchar(int x) _const_; |
| int unoctchar(char c) _const_; |
| char decchar(int x) _const_; |
| int undecchar(char c) _const_; |
| char base32hexchar(int x) _const_; |
| int unbase32hexchar(char c) _const_; |
| char base64char(int x) _const_; |
| int unbase64char(char c) _const_; |
| |
| char *cescape(const char *s); |
| size_t cescape_char(char c, char *buf); |
| |
| typedef enum UnescapeFlags { |
| UNESCAPE_RELAX = 1, |
| } UnescapeFlags; |
| |
| int cunescape(const char *s, UnescapeFlags flags, char **ret); |
| int cunescape_length(const char *s, size_t length, UnescapeFlags flags, char **ret); |
| int cunescape_length_with_prefix(const char *s, size_t length, const char *prefix, UnescapeFlags flags, char **ret); |
| |
| char *xescape(const char *s, const char *bad); |
| |
| char *ascii_strlower(char *path); |
| |
| bool dirent_is_file(const struct dirent *de) _pure_; |
| bool dirent_is_file_with_suffix(const struct dirent *de, const char *suffix) _pure_; |
| |
| bool hidden_file(const char *filename) _pure_; |
| |
| bool chars_intersect(const char *a, const char *b) _pure_; |
| |
| /* For basic lookup tables with strictly enumerated entries */ |
| #define _DEFINE_STRING_TABLE_LOOKUP_TO_STRING(name,type,scope) \ |
| scope const char *name##_to_string(type i) { \ |
| if (i < 0 || i >= (type) ELEMENTSOF(name##_table)) \ |
| return NULL; \ |
| return name##_table[i]; \ |
| } |
| |
| ssize_t string_table_lookup(const char * const *table, size_t len, const char *key); |
| |
| #define _DEFINE_STRING_TABLE_LOOKUP_FROM_STRING(name,type,scope) \ |
| scope type name##_from_string(const char *s) { \ |
| return (type) string_table_lookup(name##_table, ELEMENTSOF(name##_table), s); \ |
| } |
| |
| #define _DEFINE_STRING_TABLE_LOOKUP(name,type,scope) \ |
| _DEFINE_STRING_TABLE_LOOKUP_TO_STRING(name,type,scope) \ |
| _DEFINE_STRING_TABLE_LOOKUP_FROM_STRING(name,type,scope) \ |
| struct __useless_struct_to_allow_trailing_semicolon__ |
| |
| #define DEFINE_STRING_TABLE_LOOKUP(name,type) _DEFINE_STRING_TABLE_LOOKUP(name,type,) |
| #define DEFINE_PRIVATE_STRING_TABLE_LOOKUP(name,type) _DEFINE_STRING_TABLE_LOOKUP(name,type,static) |
| #define DEFINE_PRIVATE_STRING_TABLE_LOOKUP_TO_STRING(name,type) _DEFINE_STRING_TABLE_LOOKUP_TO_STRING(name,type,static) |
| #define DEFINE_PRIVATE_STRING_TABLE_LOOKUP_FROM_STRING(name,type) _DEFINE_STRING_TABLE_LOOKUP_FROM_STRING(name,type,static) |
| |
| /* For string conversions where numbers are also acceptable */ |
| #define DEFINE_STRING_TABLE_LOOKUP_WITH_FALLBACK(name,type,max) \ |
| int name##_to_string_alloc(type i, char **str) { \ |
| char *s; \ |
| if (i < 0 || i > max) \ |
| return -ERANGE; \ |
| if (i < (type) ELEMENTSOF(name##_table)) { \ |
| s = strdup(name##_table[i]); \ |
| if (!s) \ |
| return -ENOMEM; \ |
| } else { \ |
| if (asprintf(&s, "%i", i) < 0) \ |
| return -ENOMEM; \ |
| } \ |
| *str = s; \ |
| return 0; \ |
| } \ |
| type name##_from_string(const char *s) { \ |
| type i; \ |
| unsigned u = 0; \ |
| if (!s) \ |
| return (type) -1; \ |
| for (i = 0; i < (type) ELEMENTSOF(name##_table); i++) \ |
| if (streq_ptr(name##_table[i], s)) \ |
| return i; \ |
| if (safe_atou(s, &u) >= 0 && u <= max) \ |
| return (type) u; \ |
| return (type) -1; \ |
| } \ |
| struct __useless_struct_to_allow_trailing_semicolon__ |
| |
| int fd_nonblock(int fd, bool nonblock); |
| int fd_cloexec(int fd, bool cloexec); |
| |
| int close_all_fds(const int except[], unsigned n_except); |
| |
| bool fstype_is_network(const char *fstype); |
| |
| int flush_fd(int fd); |
| |
| int fopen_temporary(const char *path, FILE **_f, char **_temp_path); |
| |
| ssize_t loop_read(int fd, void *buf, size_t nbytes, bool do_poll); |
| int loop_read_exact(int fd, void *buf, size_t nbytes, bool do_poll); |
| int loop_write(int fd, const void *buf, size_t nbytes, bool do_poll); |
| |
| bool is_device_path(const char *path); |
| |
| int dir_is_empty(const char *path); |
| char* dirname_malloc(const char *path); |
| |
| char* lookup_uid(uid_t uid); |
| char* getlogname_malloc(void); |
| char* getusername_malloc(void); |
| |
| int chmod_and_chown(const char *path, mode_t mode, uid_t uid, gid_t gid); |
| int fchmod_and_fchown(int fd, mode_t mode, uid_t uid, gid_t gid); |
| |
| bool is_temporary_fs(const struct statfs *s) _pure_; |
| int fd_is_temporary_fs(int fd); |
| |
| int pipe_eof(int fd); |
| |
| #define xsprintf(buf, fmt, ...) \ |
| assert_message_se((size_t) snprintf(buf, ELEMENTSOF(buf), fmt, __VA_ARGS__) < ELEMENTSOF(buf), \ |
| "xsprintf: " #buf "[] must be big enough") |
| |
| int files_same(const char *filea, const char *fileb); |
| |
| int running_in_chroot(void); |
| |
| char *ellipsize(const char *s, size_t length, unsigned percent); |
| /* bytes columns */ |
| char *ellipsize_mem(const char *s, size_t old_length, size_t new_length, unsigned percent); |
| |
| int touch_file(const char *path, bool parents, usec_t stamp, uid_t uid, gid_t gid, mode_t mode); |
| int touch(const char *path); |
| |
| noreturn void freeze(void); |
| |
| bool null_or_empty(struct stat *st) _pure_; |
| int null_or_empty_path(const char *fn); |
| int null_or_empty_fd(int fd); |
| |
| DIR *xopendirat(int dirfd, const char *name, int flags); |
| |
| char *fstab_node_to_udev_node(const char *p); |
| |
| void execute_directories(const char* const* directories, usec_t timeout, char *argv[]); |
| |
| bool nulstr_contains(const char*nulstr, const char *needle); |
| |
| bool plymouth_running(void); |
| |
| char* strshorten(char *s, size_t l); |
| |
| int symlink_idempotent(const char *from, const char *to); |
| |
| int symlink_atomic(const char *from, const char *to); |
| int mknod_atomic(const char *path, mode_t mode, dev_t dev); |
| int mkfifo_atomic(const char *path, mode_t mode); |
| |
| int fchmod_umask(int fd, mode_t mode); |
| |
| bool display_is_local(const char *display) _pure_; |
| int socket_from_display(const char *display, char **path); |
| |
| int get_user_creds(const char **username, uid_t *uid, gid_t *gid, const char **home, const char **shell); |
| int get_group_creds(const char **groupname, gid_t *gid); |
| |
| int in_gid(gid_t gid); |
| int in_group(const char *name); |
| |
| char* uid_to_name(uid_t uid); |
| char* gid_to_name(gid_t gid); |
| |
| int glob_exists(const char *path); |
| int glob_extend(char ***strv, const char *path); |
| |
| int dirent_ensure_type(DIR *d, struct dirent *de); |
| |
| int get_files_in_directory(const char *path, char ***list); |
| |
| char *strjoin(const char *x, ...) _sentinel_; |
| |
| bool is_main_thread(void); |
| |
| static inline bool _pure_ in_charset(const char *s, const char* charset) { |
| assert(s); |
| assert(charset); |
| return s[strspn(s, charset)] == '\0'; |
| } |
| |
| int block_get_whole_disk(dev_t d, dev_t *ret); |
| |
| #define NULSTR_FOREACH(i, l) \ |
| for ((i) = (l); (i) && *(i); (i) = strchr((i), 0)+1) |
| |
| #define NULSTR_FOREACH_PAIR(i, j, l) \ |
| for ((i) = (l), (j) = strchr((i), 0)+1; (i) && *(i); (i) = strchr((j), 0)+1, (j) = *(i) ? strchr((i), 0)+1 : (i)) |
| |
| int ioprio_class_to_string_alloc(int i, char **s); |
| int ioprio_class_from_string(const char *s); |
| |
| const char *sigchld_code_to_string(int i) _const_; |
| int sigchld_code_from_string(const char *s) _pure_; |
| |
| int log_facility_unshifted_to_string_alloc(int i, char **s); |
| int log_facility_unshifted_from_string(const char *s); |
| |
| int log_level_to_string_alloc(int i, char **s); |
| int log_level_from_string(const char *s); |
| |
| int sched_policy_to_string_alloc(int i, char **s); |
| int sched_policy_from_string(const char *s); |
| |
| const char *rlimit_to_string(int i) _const_; |
| int rlimit_from_string(const char *s) _pure_; |
| |
| int ip_tos_to_string_alloc(int i, char **s); |
| int ip_tos_from_string(const char *s); |
| |
| extern int saved_argc; |
| extern char **saved_argv; |
| |
| bool kexec_loaded(void); |
| |
| int prot_from_flags(int flags) _const_; |
| |
| char *format_bytes(char *buf, size_t l, uint64_t t); |
| |
| int fd_wait_for_event(int fd, int event, usec_t timeout); |
| |
| void* memdup(const void *p, size_t l) _alloc_(2); |
| |
| int fd_inc_sndbuf(int fd, size_t n); |
| int fd_inc_rcvbuf(int fd, size_t n); |
| |
| int fork_agent(pid_t *pid, const int except[], unsigned n_except, const char *path, ...); |
| |
| int setrlimit_closest(int resource, const struct rlimit *rlim); |
| |
| bool http_url_is_valid(const char *url) _pure_; |
| bool documentation_url_is_valid(const char *url) _pure_; |
| |
| bool http_etag_is_valid(const char *etag); |
| |
| bool in_initrd(void); |
| |
| int get_home_dir(char **ret); |
| int get_shell(char **_ret); |
| |
| static inline void freep(void *p) { |
| free(*(void**) p); |
| } |
| |
| static inline void closep(int *fd) { |
| safe_close(*fd); |
| } |
| |
| static inline void umaskp(mode_t *u) { |
| umask(*u); |
| } |
| |
| static inline void close_pairp(int (*p)[2]) { |
| safe_close_pair(*p); |
| } |
| |
| static inline void fclosep(FILE **f) { |
| safe_fclose(*f); |
| } |
| |
| DEFINE_TRIVIAL_CLEANUP_FUNC(FILE*, pclose); |
| DEFINE_TRIVIAL_CLEANUP_FUNC(DIR*, closedir); |
| DEFINE_TRIVIAL_CLEANUP_FUNC(FILE*, endmntent); |
| |
| #define _cleanup_free_ _cleanup_(freep) |
| #define _cleanup_close_ _cleanup_(closep) |
| #define _cleanup_umask_ _cleanup_(umaskp) |
| #define _cleanup_globfree_ _cleanup_(globfree) |
| #define _cleanup_fclose_ _cleanup_(fclosep) |
| #define _cleanup_pclose_ _cleanup_(pclosep) |
| #define _cleanup_closedir_ _cleanup_(closedirp) |
| #define _cleanup_endmntent_ _cleanup_(endmntentp) |
| #define _cleanup_close_pair_ _cleanup_(close_pairp) |
| |
| _malloc_ _alloc_(1, 2) static inline void *malloc_multiply(size_t a, size_t b) { |
| if (_unlikely_(b != 0 && a > ((size_t) -1) / b)) |
| return NULL; |
| |
| return malloc(a * b); |
| } |
| |
| _alloc_(2, 3) static inline void *realloc_multiply(void *p, size_t a, size_t b) { |
| if (_unlikely_(b != 0 && a > ((size_t) -1) / b)) |
| return NULL; |
| |
| return realloc(p, a * b); |
| } |
| |
| _alloc_(2, 3) static inline void *memdup_multiply(const void *p, size_t a, size_t b) { |
| if (_unlikely_(b != 0 && a > ((size_t) -1) / b)) |
| return NULL; |
| |
| return memdup(p, a * b); |
| } |
| |
| bool filename_is_valid(const char *p) _pure_; |
| bool path_is_safe(const char *p) _pure_; |
| bool string_is_safe(const char *p) _pure_; |
| bool string_has_cc(const char *p, const char *ok) _pure_; |
| |
| /** |
| * Check if a string contains any glob patterns. |
| */ |
| _pure_ static inline bool string_is_glob(const char *p) { |
| return !!strpbrk(p, GLOB_CHARS); |
| } |
| |
| void *xbsearch_r(const void *key, const void *base, size_t nmemb, size_t size, |
| int (*compar) (const void *, const void *, void *), |
| void *arg); |
| |
| #define _(String) gettext (String) |
| #define N_(String) String |
| void init_gettext(void); |
| bool is_locale_utf8(void); |
| |
| typedef enum DrawSpecialChar { |
| DRAW_TREE_VERTICAL, |
| DRAW_TREE_BRANCH, |
| DRAW_TREE_RIGHT, |
| DRAW_TREE_SPACE, |
| DRAW_TRIANGULAR_BULLET, |
| DRAW_BLACK_CIRCLE, |
| DRAW_ARROW, |
| DRAW_DASH, |
| _DRAW_SPECIAL_CHAR_MAX |
| } DrawSpecialChar; |
| |
| const char *draw_special_char(DrawSpecialChar ch); |
| |
| char *strreplace(const char *text, const char *old_string, const char *new_string); |
| |
| char *strip_tab_ansi(char **p, size_t *l); |
| |
| int on_ac_power(void); |
| |
| int search_and_fopen(const char *path, const char *mode, const char *root, const char **search, FILE **_f); |
| int search_and_fopen_nulstr(const char *path, const char *mode, const char *root, const char *search, FILE **_f); |
| |
| #define FOREACH_LINE(line, f, on_error) \ |
| for (;;) \ |
| if (!fgets(line, sizeof(line), f)) { \ |
| if (ferror(f)) { \ |
| on_error; \ |
| } \ |
| break; \ |
| } else |
| |
| #define FOREACH_DIRENT(de, d, on_error) \ |
| for (errno = 0, de = readdir(d);; errno = 0, de = readdir(d)) \ |
| if (!de) { \ |
| if (errno > 0) { \ |
| on_error; \ |
| } \ |
| break; \ |
| } else if (hidden_file((de)->d_name)) \ |
| continue; \ |
| else |
| |
| #define FOREACH_DIRENT_ALL(de, d, on_error) \ |
| for (errno = 0, de = readdir(d);; errno = 0, de = readdir(d)) \ |
| if (!de) { \ |
| if (errno > 0) { \ |
| on_error; \ |
| } \ |
| break; \ |
| } else |
| |
| static inline void *mempset(void *s, int c, size_t n) { |
| memset(s, c, n); |
| return (uint8_t*)s + n; |
| } |
| |
| char *hexmem(const void *p, size_t l); |
| int unhexmem(const char *p, size_t l, void **mem, size_t *len); |
| |
| char *base32hexmem(const void *p, size_t l, bool padding); |
| int unbase32hexmem(const char *p, size_t l, bool padding, void **mem, size_t *len); |
| |
| char *base64mem(const void *p, size_t l); |
| int unbase64mem(const char *p, size_t l, void **mem, size_t *len); |
| |
| char *strextend(char **x, ...) _sentinel_; |
| char *strrep(const char *s, unsigned n); |
| |
| void* greedy_realloc(void **p, size_t *allocated, size_t need, size_t size); |
| void* greedy_realloc0(void **p, size_t *allocated, size_t need, size_t size); |
| #define GREEDY_REALLOC(array, allocated, need) \ |
| greedy_realloc((void**) &(array), &(allocated), (need), sizeof((array)[0])) |
| |
| #define GREEDY_REALLOC0(array, allocated, need) \ |
| greedy_realloc0((void**) &(array), &(allocated), (need), sizeof((array)[0])) |
| |
| static inline void _reset_errno_(int *saved_errno) { |
| errno = *saved_errno; |
| } |
| |
| #define PROTECT_ERRNO _cleanup_(_reset_errno_) __attribute__((unused)) int _saved_errno_ = errno |
| |
| static inline int negative_errno(void) { |
| /* This helper should be used to shut up gcc if you know 'errno' is |
| * negative. Instead of "return -errno;", use "return negative_errno();" |
| * It will suppress bogus gcc warnings in case it assumes 'errno' might |
| * be 0 and thus the caller's error-handling might not be triggered. */ |
| assert_return(errno > 0, -EINVAL); |
| return -errno; |
| } |
| |
| struct _umask_struct_ { |
| mode_t mask; |
| bool quit; |
| }; |
| |
| static inline void _reset_umask_(struct _umask_struct_ *s) { |
| umask(s->mask); |
| }; |
| |
| #define RUN_WITH_UMASK(mask) \ |
| for (_cleanup_(_reset_umask_) struct _umask_struct_ _saved_umask_ = { umask(mask), false }; \ |
| !_saved_umask_.quit ; \ |
| _saved_umask_.quit = true) |
| |
| static inline unsigned u64log2(uint64_t n) { |
| #if __SIZEOF_LONG_LONG__ == 8 |
| return (n > 1) ? (unsigned) __builtin_clzll(n) ^ 63U : 0; |
| #else |
| #error "Wut?" |
| #endif |
| } |
| |
| static inline unsigned u32ctz(uint32_t n) { |
| #if __SIZEOF_INT__ == 4 |
| return __builtin_ctz(n); |
| #else |
| #error "Wut?" |
| #endif |
| } |
| |
| static inline unsigned log2i(int x) { |
| assert(x > 0); |
| |
| return __SIZEOF_INT__ * 8 - __builtin_clz(x) - 1; |
| } |
| |
| static inline unsigned log2u(unsigned x) { |
| assert(x > 0); |
| |
| return sizeof(unsigned) * 8 - __builtin_clz(x) - 1; |
| } |
| |
| static inline unsigned log2u_round_up(unsigned x) { |
| assert(x > 0); |
| |
| if (x == 1) |
| return 0; |
| |
| return log2u(x - 1) + 1; |
| } |
| |
| static inline bool logind_running(void) { |
| return access("/run/systemd/seats/", F_OK) >= 0; |
| } |
| |
| #define DECIMAL_STR_WIDTH(x) \ |
| ({ \ |
| typeof(x) _x_ = (x); \ |
| unsigned ans = 1; \ |
| while (_x_ /= 10) \ |
| ans++; \ |
| ans; \ |
| }) |
| |
| int unlink_noerrno(const char *path); |
| |
| #define alloca0(n) \ |
| ({ \ |
| char *_new_; \ |
| size_t _len_ = n; \ |
| _new_ = alloca(_len_); \ |
| (void *) memset(_new_, 0, _len_); \ |
| }) |
| |
| /* It's not clear what alignment glibc/gcc alloca() guarantee, hence provide a guaranteed safe version */ |
| #define alloca_align(size, align) \ |
| ({ \ |
| void *_ptr_; \ |
| size_t _mask_ = (align) - 1; \ |
| _ptr_ = alloca((size) + _mask_); \ |
| (void*)(((uintptr_t)_ptr_ + _mask_) & ~_mask_); \ |
| }) |
| |
| #define alloca0_align(size, align) \ |
| ({ \ |
| void *_new_; \ |
| size_t _size_ = (size); \ |
| _new_ = alloca_align(_size_, (align)); \ |
| (void*)memset(_new_, 0, _size_); \ |
| }) |
| |
| #define strjoina(a, ...) \ |
| ({ \ |
| const char *_appendees_[] = { a, __VA_ARGS__ }; \ |
| char *_d_, *_p_; \ |
| int _len_ = 0; \ |
| unsigned _i_; \ |
| for (_i_ = 0; _i_ < ELEMENTSOF(_appendees_) && _appendees_[_i_]; _i_++) \ |
| _len_ += strlen(_appendees_[_i_]); \ |
| _p_ = _d_ = alloca(_len_ + 1); \ |
| for (_i_ = 0; _i_ < ELEMENTSOF(_appendees_) && _appendees_[_i_]; _i_++) \ |
| _p_ = stpcpy(_p_, _appendees_[_i_]); \ |
| *_p_ = 0; \ |
| _d_; \ |
| }) |
| |
| bool id128_is_valid(const char *s) _pure_; |
| |
| int split_pair(const char *s, const char *sep, char **l, char **r); |
| |
| int shall_restore_state(void); |
| |
| /** |
| * Normal qsort requires base to be nonnull. Here were require |
| * that only if nmemb > 0. |
| */ |
| static inline void qsort_safe(void *base, size_t nmemb, size_t size, comparison_fn_t compar) { |
| if (nmemb <= 1) |
| return; |
| |
| assert(base); |
| qsort(base, nmemb, size, compar); |
| } |
| |
| /* Normal memmem() requires haystack to be nonnull, which is annoying for zero-length buffers */ |
| static inline void *memmem_safe(const void *haystack, size_t haystacklen, const void *needle, size_t needlelen) { |
| |
| if (needlelen <= 0) |
| return (void*) haystack; |
| |
| if (haystacklen < needlelen) |
| return NULL; |
| |
| assert(haystack); |
| assert(needle); |
| |
| return memmem(haystack, haystacklen, needle, needlelen); |
| } |
| |
| int proc_cmdline(char **ret); |
| int parse_proc_cmdline(int (*parse_word)(const char *key, const char *value)); |
| int get_proc_cmdline_key(const char *parameter, char **value); |
| |
| int container_get_leader(const char *machine, pid_t *pid); |
| |
| int namespace_open(pid_t pid, int *pidns_fd, int *mntns_fd, int *netns_fd, int *userns_fd, int *root_fd); |
| int namespace_enter(int pidns_fd, int mntns_fd, int netns_fd, int userns_fd, int root_fd); |
| |
| int getpeercred(int fd, struct ucred *ucred); |
| int getpeersec(int fd, char **ret); |
| |
| int writev_safe(int fd, const struct iovec *w, int j); |
| |
| int mkostemp_safe(char *pattern, int flags); |
| int open_tmpfile(const char *path, int flags); |
| |
| int fd_warn_permissions(const char *path, int fd); |
| |
| #ifndef PERSONALITY_INVALID |
| /* personality(7) documents that 0xffffffffUL is used for querying the |
| * current personality, hence let's use that here as error |
| * indicator. */ |
| #define PERSONALITY_INVALID 0xffffffffLU |
| #endif |
| |
| unsigned long personality_from_string(const char *p); |
| const char *personality_to_string(unsigned long); |
| |
| uint64_t physical_memory(void); |
| |
| void hexdump(FILE *f, const void *p, size_t s); |
| |
| union file_handle_union { |
| struct file_handle handle; |
| char padding[sizeof(struct file_handle) + MAX_HANDLE_SZ]; |
| }; |
| #define FILE_HANDLE_INIT { .handle.handle_bytes = MAX_HANDLE_SZ } |
| |
| int update_reboot_param_file(const char *param); |
| |
| int umount_recursive(const char *target, int flags); |
| |
| int bind_remount_recursive(const char *prefix, bool ro); |
| |
| int fflush_and_check(FILE *f); |
| |
| int tempfn_xxxxxx(const char *p, const char *extra, char **ret); |
| int tempfn_random(const char *p, const char *extra, char **ret); |
| int tempfn_random_child(const char *p, const char *extra, char **ret); |
| |
| int take_password_lock(const char *root); |
| |
| int is_symlink(const char *path); |
| int is_dir(const char *path, bool follow); |
| int is_device_node(const char *path); |
| |
| typedef enum ExtractFlags { |
| EXTRACT_RELAX = 1, |
| EXTRACT_CUNESCAPE = 2, |
| EXTRACT_CUNESCAPE_RELAX = 4, |
| EXTRACT_QUOTES = 8, |
| EXTRACT_DONT_COALESCE_SEPARATORS = 16, |
| } ExtractFlags; |
| |
| int extract_first_word(const char **p, char **ret, const char *separators, ExtractFlags flags); |
| int extract_first_word_and_warn(const char **p, char **ret, const char *separators, ExtractFlags flags, const char *unit, const char *filename, unsigned line, const char *rvalue); |
| int extract_many_words(const char **p, const char *separators, ExtractFlags flags, ...) _sentinel_; |
| |
| int free_and_strdup(char **p, const char *s); |
| |
| #define INOTIFY_EVENT_MAX (sizeof(struct inotify_event) + NAME_MAX + 1) |
| |
| #define FOREACH_INOTIFY_EVENT(e, buffer, sz) \ |
| for ((e) = &buffer.ev; \ |
| (uint8_t*) (e) < (uint8_t*) (buffer.raw) + (sz); \ |
| (e) = (struct inotify_event*) ((uint8_t*) (e) + sizeof(struct inotify_event) + (e)->len)) |
| |
| union inotify_event_buffer { |
| struct inotify_event ev; |
| uint8_t raw[INOTIFY_EVENT_MAX]; |
| }; |
| |
| #define laccess(path, mode) faccessat(AT_FDCWD, (path), (mode), AT_SYMLINK_NOFOLLOW) |
| |
| int ptsname_malloc(int fd, char **ret); |
| |
| int openpt_in_namespace(pid_t pid, int flags); |
| |
| ssize_t fgetxattrat_fake(int dirfd, const char *filename, const char *attribute, void *value, size_t size, int flags); |
| |
| int fd_setcrtime(int fd, usec_t usec); |
| int fd_getcrtime(int fd, usec_t *usec); |
| int path_getcrtime(const char *p, usec_t *usec); |
| int fd_getcrtime_at(int dirfd, const char *name, usec_t *usec, int flags); |
| |
| int same_fd(int a, int b); |
| |
| int chattr_fd(int fd, unsigned value, unsigned mask); |
| int chattr_path(const char *p, unsigned value, unsigned mask); |
| |
| int read_attr_fd(int fd, unsigned *ret); |
| int read_attr_path(const char *p, unsigned *ret); |
| |
| #define RLIMIT_MAKE_CONST(lim) ((struct rlimit) { lim, lim }) |
| |
| ssize_t sparse_write(int fd, const void *p, size_t sz, size_t run_length); |
| |
| void sigkill_wait(pid_t *pid); |
| #define _cleanup_sigkill_wait_ _cleanup_(sigkill_wait) |
| |
| int syslog_parse_priority(const char **p, int *priority, bool with_facility); |
| |
| void cmsg_close_all(struct msghdr *mh); |
| |
| int rename_noreplace(int olddirfd, const char *oldpath, int newdirfd, const char *newpath); |
| |
| char *shell_escape(const char *s, const char *bad); |
| char *shell_maybe_quote(const char *s); |
| |
| int parse_mode(const char *s, mode_t *ret); |
| |
| int mount_move_root(const char *path); |
| |
| int reset_uid_gid(void); |
| |
| int getxattr_malloc(const char *path, const char *name, char **value, bool allow_symlink); |
| int fgetxattr_malloc(int fd, const char *name, char **value); |
| |
| int send_one_fd(int transport_fd, int fd, int flags); |
| int receive_one_fd(int transport_fd, int flags); |
| |
| void nop_signal_handler(int sig); |
| |
| int version(void); |
| |
| bool fdname_is_valid(const char *s); |