util.h revision 4b73a0c0612d26d49791f389e92f85d6444c36af
3fb2c57038cf8dad396421989f43697fcf4ac4a4Patrik Flykt/*-*- Mode: C; c-basic-offset: 8; indent-tabs-mode: nil -*-*/
3fb2c57038cf8dad396421989f43697fcf4ac4a4Patrik Flykt
3fb2c57038cf8dad396421989f43697fcf4ac4a4Patrik Flykt#pragma once
3fb2c57038cf8dad396421989f43697fcf4ac4a4Patrik Flykt
3fb2c57038cf8dad396421989f43697fcf4ac4a4Patrik Flykt/***
3fb2c57038cf8dad396421989f43697fcf4ac4a4Patrik Flykt This file is part of systemd.
3fb2c57038cf8dad396421989f43697fcf4ac4a4Patrik Flykt
3fb2c57038cf8dad396421989f43697fcf4ac4a4Patrik Flykt Copyright 2010 Lennart Poettering
3fb2c57038cf8dad396421989f43697fcf4ac4a4Patrik Flykt
3fb2c57038cf8dad396421989f43697fcf4ac4a4Patrik Flykt systemd is free software; you can redistribute it and/or modify it
3fb2c57038cf8dad396421989f43697fcf4ac4a4Patrik Flykt under the terms of the GNU Lesser General Public License as published by
3fb2c57038cf8dad396421989f43697fcf4ac4a4Patrik Flykt the Free Software Foundation; either version 2.1 of the License, or
3fb2c57038cf8dad396421989f43697fcf4ac4a4Patrik Flykt (at your option) any later version.
3fb2c57038cf8dad396421989f43697fcf4ac4a4Patrik Flykt
3fb2c57038cf8dad396421989f43697fcf4ac4a4Patrik Flykt systemd is distributed in the hope that it will be useful, but
3fb2c57038cf8dad396421989f43697fcf4ac4a4Patrik Flykt WITHOUT ANY WARRANTY; without even the implied warranty of
3fb2c57038cf8dad396421989f43697fcf4ac4a4Patrik Flykt MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
3fb2c57038cf8dad396421989f43697fcf4ac4a4Patrik Flykt Lesser General Public License for more details.
3fb2c57038cf8dad396421989f43697fcf4ac4a4Patrik Flykt
3fb2c57038cf8dad396421989f43697fcf4ac4a4Patrik Flykt You should have received a copy of the GNU Lesser General Public License
3fb2c57038cf8dad396421989f43697fcf4ac4a4Patrik Flykt along with systemd; If not, see <http://www.gnu.org/licenses/>.
3fb2c57038cf8dad396421989f43697fcf4ac4a4Patrik Flykt***/
3fb2c57038cf8dad396421989f43697fcf4ac4a4Patrik Flykt
3fb2c57038cf8dad396421989f43697fcf4ac4a4Patrik Flykt#include <inttypes.h>
3fb2c57038cf8dad396421989f43697fcf4ac4a4Patrik Flykt#include <time.h>
3fb2c57038cf8dad396421989f43697fcf4ac4a4Patrik Flykt#include <sys/time.h>
3fb2c57038cf8dad396421989f43697fcf4ac4a4Patrik Flykt#include <stdarg.h>
3fb2c57038cf8dad396421989f43697fcf4ac4a4Patrik Flykt#include <stdbool.h>
3fb2c57038cf8dad396421989f43697fcf4ac4a4Patrik Flykt#include <stdlib.h>
3fb2c57038cf8dad396421989f43697fcf4ac4a4Patrik Flykt#include <stdio.h>
3fb2c57038cf8dad396421989f43697fcf4ac4a4Patrik Flykt#include <signal.h>
3fb2c57038cf8dad396421989f43697fcf4ac4a4Patrik Flykt#include <sched.h>
3fb2c57038cf8dad396421989f43697fcf4ac4a4Patrik Flykt#include <limits.h>
3fb2c57038cf8dad396421989f43697fcf4ac4a4Patrik Flykt#include <sys/types.h>
3fb2c57038cf8dad396421989f43697fcf4ac4a4Patrik Flykt#include <sys/stat.h>
709d6710d047566c71f03e579a02c3d99fe15a3ePatrik Flykt#include <dirent.h>
709d6710d047566c71f03e579a02c3d99fe15a3ePatrik Flykt#include <sys/resource.h>
709d6710d047566c71f03e579a02c3d99fe15a3ePatrik Flykt#include <stddef.h>
709d6710d047566c71f03e579a02c3d99fe15a3ePatrik Flykt#include <unistd.h>
709d6710d047566c71f03e579a02c3d99fe15a3ePatrik Flykt
709d6710d047566c71f03e579a02c3d99fe15a3ePatrik Flykt#include <systemd/sd-journal.h>
709d6710d047566c71f03e579a02c3d99fe15a3ePatrik Flykt#include "macro.h"
709d6710d047566c71f03e579a02c3d99fe15a3ePatrik Flykt#include "time-util.h"
709d6710d047566c71f03e579a02c3d99fe15a3ePatrik Flykt
709d6710d047566c71f03e579a02c3d99fe15a3ePatrik Flyktunion dirent_storage {
709d6710d047566c71f03e579a02c3d99fe15a3ePatrik Flykt struct dirent de;
709d6710d047566c71f03e579a02c3d99fe15a3ePatrik Flykt uint8_t storage[offsetof(struct dirent, d_name) +
709d6710d047566c71f03e579a02c3d99fe15a3ePatrik Flykt ((NAME_MAX + 1 + sizeof(long)) & ~(sizeof(long) - 1))];
709d6710d047566c71f03e579a02c3d99fe15a3ePatrik Flykt};
709d6710d047566c71f03e579a02c3d99fe15a3ePatrik Flykt
709d6710d047566c71f03e579a02c3d99fe15a3ePatrik Flykt/* What is interpreted as whitespace? */
709d6710d047566c71f03e579a02c3d99fe15a3ePatrik Flykt#define WHITESPACE " \t\n\r"
709d6710d047566c71f03e579a02c3d99fe15a3ePatrik Flykt#define NEWLINE "\n\r"
709d6710d047566c71f03e579a02c3d99fe15a3ePatrik Flykt#define QUOTES "\"\'"
709d6710d047566c71f03e579a02c3d99fe15a3ePatrik Flykt#define COMMENTS "#;\n"
709d6710d047566c71f03e579a02c3d99fe15a3ePatrik Flykt
709d6710d047566c71f03e579a02c3d99fe15a3ePatrik Flykt#define FORMAT_BYTES_MAX 8
3fb2c57038cf8dad396421989f43697fcf4ac4a4Patrik Flykt
3fb2c57038cf8dad396421989f43697fcf4ac4a4Patrik Flykt#define ANSI_HIGHLIGHT_ON "\x1B[1;39m"
3fb2c57038cf8dad396421989f43697fcf4ac4a4Patrik Flykt#define ANSI_RED_ON "\x1B[31m"
3fb2c57038cf8dad396421989f43697fcf4ac4a4Patrik Flykt#define ANSI_HIGHLIGHT_RED_ON "\x1B[1;31m"
3fb2c57038cf8dad396421989f43697fcf4ac4a4Patrik Flykt#define ANSI_GREEN_ON "\x1B[32m"
3fb2c57038cf8dad396421989f43697fcf4ac4a4Patrik Flykt#define ANSI_HIGHLIGHT_GREEN_ON "\x1B[1;32m"
3fb2c57038cf8dad396421989f43697fcf4ac4a4Patrik Flykt#define ANSI_HIGHLIGHT_YELLOW_ON "\x1B[1;33m"
3fb2c57038cf8dad396421989f43697fcf4ac4a4Patrik Flykt#define ANSI_HIGHLIGHT_OFF "\x1B[0m"
3fb2c57038cf8dad396421989f43697fcf4ac4a4Patrik Flykt#define ANSI_ERASE_TO_END_OF_LINE "\x1B[K"
3fb2c57038cf8dad396421989f43697fcf4ac4a4Patrik Flykt
3fb2c57038cf8dad396421989f43697fcf4ac4a4Patrik Flyktsize_t page_size(void);
3fb2c57038cf8dad396421989f43697fcf4ac4a4Patrik Flykt#define PAGE_ALIGN(l) ALIGN_TO((l), page_size())
3fb2c57038cf8dad396421989f43697fcf4ac4a4Patrik Flykt
3fb2c57038cf8dad396421989f43697fcf4ac4a4Patrik Flykt#define streq(a,b) (strcmp((a),(b)) == 0)
3fb2c57038cf8dad396421989f43697fcf4ac4a4Patrik Flykt#define strneq(a, b, n) (strncmp((a), (b), (n)) == 0)
3fb2c57038cf8dad396421989f43697fcf4ac4a4Patrik Flykt#define strcaseeq(a,b) (strcasecmp((a),(b)) == 0)
3fb2c57038cf8dad396421989f43697fcf4ac4a4Patrik Flykt#define strncaseeq(a, b, n) (strncasecmp((a), (b), (n)) == 0)
3fb2c57038cf8dad396421989f43697fcf4ac4a4Patrik Flykt
3fb2c57038cf8dad396421989f43697fcf4ac4a4Patrik Flyktbool streq_ptr(const char *a, const char *b);
3fb2c57038cf8dad396421989f43697fcf4ac4a4Patrik Flykt
3fb2c57038cf8dad396421989f43697fcf4ac4a4Patrik Flykt#define new(t, n) ((t*) malloc_multiply(sizeof(t), (n)))
3fb2c57038cf8dad396421989f43697fcf4ac4a4Patrik Flykt
3fb2c57038cf8dad396421989f43697fcf4ac4a4Patrik Flykt#define new0(t, n) ((t*) calloc((n), sizeof(t)))
3fb2c57038cf8dad396421989f43697fcf4ac4a4Patrik Flykt
3fb2c57038cf8dad396421989f43697fcf4ac4a4Patrik Flykt#define newa(t, n) ((t*) alloca(sizeof(t)*(n)))
3fb2c57038cf8dad396421989f43697fcf4ac4a4Patrik Flykt
3fb2c57038cf8dad396421989f43697fcf4ac4a4Patrik Flykt#define newdup(t, p, n) ((t*) memdup_multiply(p, sizeof(t), (n)))
3fb2c57038cf8dad396421989f43697fcf4ac4a4Patrik Flykt
3fb2c57038cf8dad396421989f43697fcf4ac4a4Patrik Flykt#define malloc0(n) (calloc((n), 1))
3fb2c57038cf8dad396421989f43697fcf4ac4a4Patrik Flykt
3fb2c57038cf8dad396421989f43697fcf4ac4a4Patrik Flyktstatic inline const char* yes_no(bool b) {
3fb2c57038cf8dad396421989f43697fcf4ac4a4Patrik Flykt return b ? "yes" : "no";
3fb2c57038cf8dad396421989f43697fcf4ac4a4Patrik Flykt}
3fb2c57038cf8dad396421989f43697fcf4ac4a4Patrik Flykt
3fb2c57038cf8dad396421989f43697fcf4ac4a4Patrik Flyktstatic inline const char* strempty(const char *s) {
3fb2c57038cf8dad396421989f43697fcf4ac4a4Patrik Flykt return s ? s : "";
3fb2c57038cf8dad396421989f43697fcf4ac4a4Patrik Flykt}
3fb2c57038cf8dad396421989f43697fcf4ac4a4Patrik Flykt
3fb2c57038cf8dad396421989f43697fcf4ac4a4Patrik Flyktstatic inline const char* strnull(const char *s) {
3fb2c57038cf8dad396421989f43697fcf4ac4a4Patrik Flykt return s ? s : "(null)";
3fb2c57038cf8dad396421989f43697fcf4ac4a4Patrik Flykt}
3fb2c57038cf8dad396421989f43697fcf4ac4a4Patrik Flykt
3fb2c57038cf8dad396421989f43697fcf4ac4a4Patrik Flyktstatic inline const char *strna(const char *s) {
3fb2c57038cf8dad396421989f43697fcf4ac4a4Patrik Flykt return s ? s : "n/a";
3fb2c57038cf8dad396421989f43697fcf4ac4a4Patrik Flykt}
3fb2c57038cf8dad396421989f43697fcf4ac4a4Patrik Flykt
3fb2c57038cf8dad396421989f43697fcf4ac4a4Patrik Flyktstatic inline bool isempty(const char *p) {
3fb2c57038cf8dad396421989f43697fcf4ac4a4Patrik Flykt return !p || !p[0];
3fb2c57038cf8dad396421989f43697fcf4ac4a4Patrik Flykt}
3fb2c57038cf8dad396421989f43697fcf4ac4a4Patrik Flykt
3fb2c57038cf8dad396421989f43697fcf4ac4a4Patrik Flyktchar *endswith(const char *s, const char *postfix);
3fb2c57038cf8dad396421989f43697fcf4ac4a4Patrik Flyktchar *startswith(const char *s, const char *prefix);
3fb2c57038cf8dad396421989f43697fcf4ac4a4Patrik Flyktchar *startswith_no_case(const char *s, const char *prefix);
3fb2c57038cf8dad396421989f43697fcf4ac4a4Patrik Flykt
3fb2c57038cf8dad396421989f43697fcf4ac4a4Patrik Flyktbool first_word(const char *s, const char *word);
3fb2c57038cf8dad396421989f43697fcf4ac4a4Patrik Flykt
3fb2c57038cf8dad396421989f43697fcf4ac4a4Patrik Flyktint close_nointr(int fd);
3fb2c57038cf8dad396421989f43697fcf4ac4a4Patrik Flyktvoid close_nointr_nofail(int fd);
3fb2c57038cf8dad396421989f43697fcf4ac4a4Patrik Flyktvoid close_many(const int fds[], unsigned n_fd);
3fb2c57038cf8dad396421989f43697fcf4ac4a4Patrik Flykt
3fb2c57038cf8dad396421989f43697fcf4ac4a4Patrik Flyktint parse_boolean(const char *v);
3fb2c57038cf8dad396421989f43697fcf4ac4a4Patrik Flyktint parse_bytes(const char *t, off_t *bytes);
3fb2c57038cf8dad396421989f43697fcf4ac4a4Patrik Flyktint parse_pid(const char *s, pid_t* ret_pid);
3fb2c57038cf8dad396421989f43697fcf4ac4a4Patrik Flyktint parse_uid(const char *s, uid_t* ret_uid);
3fb2c57038cf8dad396421989f43697fcf4ac4a4Patrik Flykt#define parse_gid(s, ret_uid) parse_uid(s, ret_uid)
3fb2c57038cf8dad396421989f43697fcf4ac4a4Patrik Flykt
3fb2c57038cf8dad396421989f43697fcf4ac4a4Patrik Flyktint safe_atou(const char *s, unsigned *ret_u);
3fb2c57038cf8dad396421989f43697fcf4ac4a4Patrik Flyktint safe_atoi(const char *s, int *ret_i);
3fb2c57038cf8dad396421989f43697fcf4ac4a4Patrik Flykt
3fb2c57038cf8dad396421989f43697fcf4ac4a4Patrik Flyktint safe_atollu(const char *s, unsigned long long *ret_u);
3fb2c57038cf8dad396421989f43697fcf4ac4a4Patrik Flyktint safe_atolli(const char *s, long long int *ret_i);
3fb2c57038cf8dad396421989f43697fcf4ac4a4Patrik Flykt
ea3b3a75abb3f8b853f7da454b9b8e258a120eeaPatrik Flyktint safe_atod(const char *s, double *ret_d);
ea3b3a75abb3f8b853f7da454b9b8e258a120eeaPatrik Flykt
ea3b3a75abb3f8b853f7da454b9b8e258a120eeaPatrik Flykt#if __WORDSIZE == 32
ea3b3a75abb3f8b853f7da454b9b8e258a120eeaPatrik Flyktstatic inline int safe_atolu(const char *s, unsigned long *ret_u) {
ea3b3a75abb3f8b853f7da454b9b8e258a120eeaPatrik Flykt assert_cc(sizeof(unsigned long) == sizeof(unsigned));
ea3b3a75abb3f8b853f7da454b9b8e258a120eeaPatrik Flykt return safe_atou(s, (unsigned*) ret_u);
ea3b3a75abb3f8b853f7da454b9b8e258a120eeaPatrik Flykt}
ea3b3a75abb3f8b853f7da454b9b8e258a120eeaPatrik Flyktstatic inline int safe_atoli(const char *s, long int *ret_u) {
ea3b3a75abb3f8b853f7da454b9b8e258a120eeaPatrik Flykt assert_cc(sizeof(long int) == sizeof(int));
ea3b3a75abb3f8b853f7da454b9b8e258a120eeaPatrik Flykt return safe_atoi(s, (int*) ret_u);
ea3b3a75abb3f8b853f7da454b9b8e258a120eeaPatrik Flykt}
ea3b3a75abb3f8b853f7da454b9b8e258a120eeaPatrik Flykt#else
ea3b3a75abb3f8b853f7da454b9b8e258a120eeaPatrik Flyktstatic inline int safe_atolu(const char *s, unsigned long *ret_u) {
ea3b3a75abb3f8b853f7da454b9b8e258a120eeaPatrik Flykt assert_cc(sizeof(unsigned long) == sizeof(unsigned long long));
ea3b3a75abb3f8b853f7da454b9b8e258a120eeaPatrik Flykt return safe_atollu(s, (unsigned long long*) ret_u);
ea3b3a75abb3f8b853f7da454b9b8e258a120eeaPatrik Flykt}
ea3b3a75abb3f8b853f7da454b9b8e258a120eeaPatrik Flyktstatic inline int safe_atoli(const char *s, long int *ret_u) {
ea3b3a75abb3f8b853f7da454b9b8e258a120eeaPatrik Flykt assert_cc(sizeof(long int) == sizeof(long long int));
ea3b3a75abb3f8b853f7da454b9b8e258a120eeaPatrik Flykt return safe_atolli(s, (long long int*) ret_u);
ea3b3a75abb3f8b853f7da454b9b8e258a120eeaPatrik Flykt}
ea3b3a75abb3f8b853f7da454b9b8e258a120eeaPatrik Flykt#endif
ea3b3a75abb3f8b853f7da454b9b8e258a120eeaPatrik Flykt
ea3b3a75abb3f8b853f7da454b9b8e258a120eeaPatrik Flyktstatic inline int safe_atou32(const char *s, uint32_t *ret_u) {
ea3b3a75abb3f8b853f7da454b9b8e258a120eeaPatrik Flykt assert_cc(sizeof(uint32_t) == sizeof(unsigned));
ea3b3a75abb3f8b853f7da454b9b8e258a120eeaPatrik Flykt return safe_atou(s, (unsigned*) ret_u);
ea3b3a75abb3f8b853f7da454b9b8e258a120eeaPatrik Flykt}
ea3b3a75abb3f8b853f7da454b9b8e258a120eeaPatrik Flykt
ea3b3a75abb3f8b853f7da454b9b8e258a120eeaPatrik Flyktstatic inline int safe_atoi32(const char *s, int32_t *ret_i) {
ea3b3a75abb3f8b853f7da454b9b8e258a120eeaPatrik Flykt assert_cc(sizeof(int32_t) == sizeof(int));
ea3b3a75abb3f8b853f7da454b9b8e258a120eeaPatrik Flykt return safe_atoi(s, (int*) ret_i);
ea3b3a75abb3f8b853f7da454b9b8e258a120eeaPatrik Flykt}
ea3b3a75abb3f8b853f7da454b9b8e258a120eeaPatrik Flykt
ea3b3a75abb3f8b853f7da454b9b8e258a120eeaPatrik Flyktstatic inline int safe_atou64(const char *s, uint64_t *ret_u) {
ea3b3a75abb3f8b853f7da454b9b8e258a120eeaPatrik Flykt assert_cc(sizeof(uint64_t) == sizeof(unsigned long long));
ea3b3a75abb3f8b853f7da454b9b8e258a120eeaPatrik Flykt return safe_atollu(s, (unsigned long long*) ret_u);
ea3b3a75abb3f8b853f7da454b9b8e258a120eeaPatrik Flykt}
ea3b3a75abb3f8b853f7da454b9b8e258a120eeaPatrik Flykt
ea3b3a75abb3f8b853f7da454b9b8e258a120eeaPatrik Flyktstatic inline int safe_atoi64(const char *s, int64_t *ret_i) {
ea3b3a75abb3f8b853f7da454b9b8e258a120eeaPatrik Flykt assert_cc(sizeof(int64_t) == sizeof(long long int));
3fb2c57038cf8dad396421989f43697fcf4ac4a4Patrik Flykt return safe_atolli(s, (long long int*) ret_i);
3fb2c57038cf8dad396421989f43697fcf4ac4a4Patrik Flykt}
3fb2c57038cf8dad396421989f43697fcf4ac4a4Patrik Flykt
3fb2c57038cf8dad396421989f43697fcf4ac4a4Patrik Flyktchar *split(const char *c, size_t *l, const char *separator, char **state);
3fb2c57038cf8dad396421989f43697fcf4ac4a4Patrik Flyktchar *split_quoted(const char *c, size_t *l, char **state);
3fb2c57038cf8dad396421989f43697fcf4ac4a4Patrik Flykt
3fb2c57038cf8dad396421989f43697fcf4ac4a4Patrik Flykt#define FOREACH_WORD(word, length, s, state) \
3fb2c57038cf8dad396421989f43697fcf4ac4a4Patrik Flykt for ((state) = NULL, (word) = split((s), &(length), WHITESPACE, &(state)); (word); (word) = split((s), &(length), WHITESPACE, &(state)))
3fb2c57038cf8dad396421989f43697fcf4ac4a4Patrik Flykt
3fb2c57038cf8dad396421989f43697fcf4ac4a4Patrik Flykt#define FOREACH_WORD_SEPARATOR(word, length, s, separator, state) \
3fb2c57038cf8dad396421989f43697fcf4ac4a4Patrik Flykt for ((state) = NULL, (word) = split((s), &(length), (separator), &(state)); (word); (word) = split((s), &(length), (separator), &(state)))
3fb2c57038cf8dad396421989f43697fcf4ac4a4Patrik Flykt
3fb2c57038cf8dad396421989f43697fcf4ac4a4Patrik Flykt#define FOREACH_WORD_QUOTED(word, length, s, state) \
3fb2c57038cf8dad396421989f43697fcf4ac4a4Patrik Flykt for ((state) = NULL, (word) = split_quoted((s), &(length), &(state)); (word); (word) = split_quoted((s), &(length), &(state)))
3fb2c57038cf8dad396421989f43697fcf4ac4a4Patrik Flykt
3fb2c57038cf8dad396421989f43697fcf4ac4a4Patrik Flyktpid_t get_parent_of_pid(pid_t pid, pid_t *ppid);
3fb2c57038cf8dad396421989f43697fcf4ac4a4Patrik Flyktint get_starttime_of_pid(pid_t pid, unsigned long long *st);
3fb2c57038cf8dad396421989f43697fcf4ac4a4Patrik Flykt
3fb2c57038cf8dad396421989f43697fcf4ac4a4Patrik Flyktchar *strappend(const char *s, const char *suffix);
3fb2c57038cf8dad396421989f43697fcf4ac4a4Patrik Flyktchar *strnappend(const char *s, const char *suffix, size_t length);
3fb2c57038cf8dad396421989f43697fcf4ac4a4Patrik Flykt
3fb2c57038cf8dad396421989f43697fcf4ac4a4Patrik Flyktchar *replace_env(const char *format, char **env);
3fb2c57038cf8dad396421989f43697fcf4ac4a4Patrik Flyktchar **replace_env_argv(char **argv, char **env);
3fb2c57038cf8dad396421989f43697fcf4ac4a4Patrik Flykt
3fb2c57038cf8dad396421989f43697fcf4ac4a4Patrik Flyktint readlink_malloc(const char *p, char **r);
3fb2c57038cf8dad396421989f43697fcf4ac4a4Patrik Flyktint readlink_and_make_absolute(const char *p, char **r);
3fb2c57038cf8dad396421989f43697fcf4ac4a4Patrik Flyktint readlink_and_canonicalize(const char *p, char **r);
3fb2c57038cf8dad396421989f43697fcf4ac4a4Patrik Flykt
3fb2c57038cf8dad396421989f43697fcf4ac4a4Patrik Flyktint reset_all_signal_handlers(void);
3fb2c57038cf8dad396421989f43697fcf4ac4a4Patrik Flykt
3fb2c57038cf8dad396421989f43697fcf4ac4a4Patrik Flyktchar *strstrip(char *s);
3fb2c57038cf8dad396421989f43697fcf4ac4a4Patrik Flyktchar *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);
int get_process_comm(pid_t pid, char **name);
int get_process_cmdline(pid_t pid, size_t max_length, bool comm_fallback, char **line);
int get_process_exe(pid_t pid, char **name);
int get_process_uid(pid_t pid, uid_t *uid);
int get_process_gid(pid_t pid, gid_t *gid);
char hexchar(int x);
int unhexchar(char c);
char octchar(int x);
int unoctchar(char c);
char decchar(int x);
int undecchar(char c);
char *cescape(const char *s);
char *cunescape(const char *s);
char *cunescape_length(const char *s, size_t length);
char *cunescape_length_with_prefix(const char *s, size_t length, const char *prefix);
char *xescape(const char *s, const char *bad);
char *bus_path_escape(const char *s);
char *bus_path_unescape(const char *s);
char *ascii_strlower(char *path);
bool dirent_is_file(const struct dirent *de);
bool dirent_is_file_with_suffix(const struct dirent *de, const char *suffix);
bool ignore_file(const char *filename);
bool chars_intersect(const char *a, const char *b);
int make_stdio(int fd);
int make_null_stdio(void);
int make_console_stdio(void);
unsigned long long random_ull(void);
/* For basic lookup tables with strictly enumerated entries */
#define __DEFINE_STRING_TABLE_LOOKUP(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]; \
} \
scope type name##_from_string(const char *s) { \
type i; \
assert(s); \
for (i = 0; i < (type)ELEMENTSOF(name##_table); i++) \
if (name##_table[i] && \
streq(name##_table[i], s)) \
return i; \
return (type) -1; \
} \
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)
/* 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; \
int r; \
if (i < 0 || i > max) \
return -ERANGE; \
if (i < (type) ELEMENTSOF(name##_table)) { \
s = strdup(name##_table[i]); \
if (!s) \
return log_oom(); \
} else { \
r = asprintf(&s, "%u", i); \
if (r < 0) \
return log_oom(); \
} \
*str = s; \
return 0; \
} \
type name##_from_string(const char *s) { \
type i; \
unsigned u = 0; \
assert(s); \
for (i = 0; i < (type)ELEMENTSOF(name##_table); i++) \
if (name##_table[i] && \
streq(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 chvt(int vt);
int read_one_char(FILE *f, char *ret, usec_t timeout, bool *need_nl);
int ask(char *ret, const char *replies, const char *text, ...);
int reset_terminal_fd(int fd, bool switch_to_text);
int reset_terminal(const char *name);
int open_terminal(const char *name, int mode);
int acquire_terminal(const char *name, bool fail, bool force, bool ignore_tiocstty_eperm, usec_t timeout);
int release_terminal(void);
int flush_fd(int fd);
int ignore_signals(int sig, ...);
int default_signals(int sig, ...);
int sigaction_many(const struct sigaction *sa, ...);
int close_pipe(int p[]);
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);
ssize_t 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);
void rename_process(const char name[8]);
void sigset_add_many(sigset_t *ss, ...);
bool hostname_is_set(void);
char* gethostname_malloc(void);
char* getlogname_malloc(void);
char* getusername_malloc(void);
int getttyname_malloc(int fd, char **r);
int getttyname_harder(int fd, char **r);
int get_ctty_devnr(pid_t pid, dev_t *d);
int get_ctty(pid_t, dev_t *_devnr, char **r);
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);
int rm_rf_children(int fd, bool only_dirs, bool honour_sticky, struct stat *root_dev);
int rm_rf_children_dangerous(int fd, bool only_dirs, bool honour_sticky, struct stat *root_dev);
int rm_rf(const char *path, bool only_dirs, bool delete_root, bool honour_sticky);
int rm_rf_dangerous(const char *path, bool only_dirs, bool delete_root, bool honour_sticky);
int pipe_eof(int fd);
cpu_set_t* cpu_set_malloc(unsigned *ncpus);
int status_vprintf(const char *status, bool ellipse, bool ephemeral, const char *format, va_list ap);
int status_printf(const char *status, bool ellipse, bool ephemeral, const char *format, ...);
int status_welcome(void);
int fd_columns(int fd);
unsigned columns(void);
int fd_lines(int fd);
unsigned lines(void);
void columns_lines_cache_reset(int _unused_ signum);
bool on_tty(void);
int running_in_chroot(void);
char *ellipsize(const char *s, size_t length, unsigned percent);
char *ellipsize_mem(const char *s, size_t old_length, size_t new_length, unsigned percent);
int touch(const char *path);
char *unquote(const char *s, const char *quotes);
char *normalize_env_assignment(const char *s);
int wait_for_terminate(pid_t pid, siginfo_t *status);
int wait_for_terminate_and_warn(const char *name, pid_t pid);
_noreturn_ void freeze(void);
bool null_or_empty(struct stat *st);
int null_or_empty_path(const char *fn);
DIR *xopendirat(int dirfd, const char *name, int flags);
char *fstab_node_to_udev_node(const char *p);
char *resolve_dev_console(char **active);
bool tty_is_vc(const char *tty);
bool tty_is_vc_resolve(const char *tty);
bool tty_is_console(const char *tty);
int vtnr_from_tty(const char *tty);
const char *default_term_for_tty(const char *tty);
void execute_directory(const char *directory, DIR *_d, char *argv[]);
int kill_and_sigcont(pid_t pid, int sig);
bool nulstr_contains(const char*nulstr, const char *needle);
bool plymouth_running(void);
bool hostname_is_valid(const char *s);
char* hostname_cleanup(char *s);
char* strshorten(char *s, size_t l);
int terminal_vhangup_fd(int fd);
int terminal_vhangup(const char *name);
int vt_disallocate(const char *name);
int copy_file(const char *from, const char *to);
int symlink_atomic(const char *from, const char *to);
int fchmod_umask(int fd, mode_t mode);
bool display_is_local(const char *display);
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 dirent_ensure_type(DIR *d, struct dirent *de);
int in_search_path(const char *path, char **search);
int get_files_in_directory(const char *path, char ***list);
char *strjoin(const char *x, ...) _sentinel_;
bool is_main_thread(void);
bool in_charset(const char *s, const char* charset);
int block_get_whole_disk(dev_t d, dev_t *ret);
int file_is_priv_sticky(const char *p);
int strdup_or_null(const char *a, char **b);
#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);
int sigchld_code_from_string(const char *s);
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);
int rlimit_from_string(const char *s);
int ip_tos_to_string_alloc(int i, char **s);
int ip_tos_from_string(const char *s);
const char *signal_to_string(int i);
int signal_from_string(const char *s);
int signal_from_string_try_harder(const char *s);
extern int saved_argc;
extern char **saved_argv;
bool kexec_loaded(void);
int prot_from_flags(int flags);
char *format_bytes(char *buf, size_t l, off_t t);
int fd_wait_for_event(int fd, int event, usec_t timeout);
void* memdup(const void *p, size_t l) _malloc_;
int is_kernel_thread(pid_t pid);
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);
int getenv_for_pid(pid_t pid, const char *field, char **_value);
int can_sleep(const char *type);
int can_sleep_disk(const char *type);
bool is_valid_documentation_url(const char *url);
bool in_initrd(void);
void warn_melody(void);
int get_home_dir(char **ret);
static inline void freep(void *p) {
free(*(void**) p);
}
void fclosep(FILE **f);
void pclosep(FILE **f);
void closep(int *fd);
void closedirp(DIR **d);
static inline void umaskp(mode_t *u) {
umask(*u);
}
static inline void journal_closep(sd_journal **j) {
sd_journal_close(*j);
}
#define _cleanup_globfree_ __attribute__((cleanup(globfree)))
_malloc_ 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);
}
_malloc_ 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_safe(const char *p);
bool path_is_safe(const char *p);
bool string_is_safe(const char *p);
bool string_has_cc(const char *p);
void *xbsearch_r(const void *key, const void *base, size_t nmemb, size_t size,
int (*compar) (const void *, const void *, void *),
void *arg);
bool is_locale_utf8(void);
typedef enum DrawSpecialChar {
DRAW_TREE_VERT,
DRAW_TREE_BRANCH,
DRAW_TREE_RIGHT,
DRAW_TREE_SPACE,
DRAW_TRIANGULAR_BULLET,
_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 **search, FILE **_f);
int search_and_fopen_nulstr(const char *path, const char *mode, const char *search, FILE **_f);
int create_tmp_dir(char template[], char** dir_name);
#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 (ignore_file((de)->d_name)) \
continue; \
else
static inline void *mempset(void *s, int c, size_t n) {
memset(s, c, n);
return (char*)s + n;
}
char *hexmem(const void *p, size_t l);
void *unhexmem(const char *p, size_t l);
char *strextend(char **x, ...);
char *strrep(const char *s, unsigned n);
void* greedy_realloc(void **p, size_t *allocated, size_t need);
static inline void _reset_errno_(int *saved_errno) {
errno = *saved_errno;
}
#define PROTECT_ERRNO __attribute__((cleanup(_reset_errno_))) int _saved_errno_ = 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 (__attribute__((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) {
return (n > 1) ? __builtin_clzll(n) ^ 63U : 0;
}
static inline bool logind_running(void) {
return access("/run/systemd/seats/", F_OK) >= 0;
}
int unlink_noerrno(const char *path);