/* SPDX-License-Identifier: LGPL-2.1-or-later */

#pragma once

#include <errno.h>

#include <sched.h>

#include <signal.h>

#include <stdbool.h>

#include <stddef.h>

#include <stdio.h>

#include <string.h>

#include <sys/resource.h>

#include <sys/types.h>

#include "alloc-util.h"

#include "format-util.h"

#include "ioprio.h"

#include "macro.h"

#include "time-util.h"

#define procfs_file_alloca(pid, field)                                  \

        ({                                                              \

                pid_t _pid_ = (pid);                                    \

                const char *_field_ = (field);                          \

                char *_r_;                                              \

                if (_pid_ == 0) {                                       \

                        _r_ = newa(char, STRLEN("/proc/self/") + strlen(_field_) + 1); \

                        strcpy(stpcpy(_r_, "/proc/self/"), _field_);    \

                } else {                                                \

                        _r_ = newa(char, STRLEN("/proc/") + DECIMAL_STR_MAX(pid_t) + 1 + strlen(_field_) + 1); \

                        sprintf(_r_, "/proc/" PID_FMT "/%s", _pid_, _field_); \

                }                                                       \

                (const char*) _r_;                                      \

        })

typedef enum ProcessCmdlineFlags {

        PROCESS_CMDLINE_COMM_FALLBACK = 1 << 0,

        PROCESS_CMDLINE_USE_LOCALE    = 1 << 1,

} ProcessCmdlineFlags;

int get_process_comm(pid_t pid, char **name);

int get_process_cmdline(pid_t pid, size_t max_columns, ProcessCmdlineFlags flags, 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);

int get_process_capeff(pid_t pid, char **capeff);

int get_process_cwd(pid_t pid, char **cwd);

int get_process_root(pid_t pid, char **root);

int get_process_environ(pid_t pid, char **environ);

int get_process_ppid(pid_t pid, pid_t *ppid);

int get_process_umask(pid_t pid, mode_t *umask);

int wait_for_terminate(pid_t pid, siginfo_t *status);

typedef enum WaitFlags {

        WAIT_LOG_ABNORMAL             = 1 << 0,

        WAIT_LOG_NON_ZERO_EXIT_STATUS = 1 << 1,

        /* A shortcut for requesting the most complete logging */

        WAIT_LOG = WAIT_LOG_ABNORMAL|WAIT_LOG_NON_ZERO_EXIT_STATUS,

} WaitFlags;

int wait_for_terminate_and_check(const char *name, pid_t pid, WaitFlags flags);

int wait_for_terminate_with_timeout(pid_t pid, usec_t timeout);

void sigkill_wait(pid_t pid);

void sigkill_waitp(pid_t *pid);

void sigterm_wait(pid_t pid);

int kill_and_sigcont(pid_t pid, int sig);

int rename_process(const char name[]);

int is_kernel_thread(pid_t pid);

int getenv_for_pid(pid_t pid, const char *field, char **_value);

bool pid_is_alive(pid_t pid);

bool pid_is_unwaited(pid_t pid);

int pid_is_my_child(pid_t pid);

int pid_from_same_root_fs(pid_t pid);

bool is_main_thread(void);

_noreturn_ void freeze(void);

bool oom_score_adjust_is_valid(int oa);

#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);

int safe_personality(unsigned long p);

int opinionated_personality(unsigned long *ret);

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 sched_policy_to_string_alloc(int i, char **s);

int sched_policy_from_string(const char *s);

static inline pid_t PTR_TO_PID(const void *p) {

        return (pid_t) ((uintptr_t) p);

}

static inline void* PID_TO_PTR(pid_t pid) {

        return (void*) ((uintptr_t) pid);

}

void valgrind_summary_hack(void);

int pid_compare_func(const pid_t *a, const pid_t *b);

#if 0 /* NM_IGNORED */

static inline bool nice_is_valid(int n) {

        return n >= PRIO_MIN && n < PRIO_MAX;

}

static inline bool sched_policy_is_valid(int i) {

        return IN_SET(i, SCHED_OTHER, SCHED_BATCH, SCHED_IDLE, SCHED_FIFO, SCHED_RR);

}

static inline bool sched_priority_is_valid(int i) {

        return i >= 0 && i <= sched_get_priority_max(SCHED_RR);

}

static inline bool ioprio_class_is_valid(int i) {

        return IN_SET(i, IOPRIO_CLASS_NONE, IOPRIO_CLASS_RT, IOPRIO_CLASS_BE, IOPRIO_CLASS_IDLE);

}

static inline bool ioprio_priority_is_valid(int i) {

        return i >= 0 && i < IOPRIO_BE_NR;

}

static inline bool pid_is_valid(pid_t p) {

        return p > 0;

}

#endif /* NM_IGNORED */

int ioprio_parse_priority(const char *s, int *ret);

pid_t getpid_cached(void);

void reset_cached_pid(void);

int must_be_root(void);

typedef enum ForkFlags {

        FORK_RESET_SIGNALS      = 1 <<  0, /* Reset all signal handlers and signal mask */

        FORK_CLOSE_ALL_FDS      = 1 <<  1, /* Close all open file descriptors in the child, except for 0,1,2 */

        FORK_DEATHSIG           = 1 <<  2, /* Set PR_DEATHSIG in the child to SIGTERM */

        FORK_DEATHSIG_SIGINT    = 1 <<  3, /* Set PR_DEATHSIG in the child to SIGINT */

        FORK_NULL_STDIO         = 1 <<  4, /* Connect 0,1,2 to /dev/null */

        FORK_REOPEN_LOG         = 1 <<  5, /* Reopen log connection */

        FORK_LOG                = 1 <<  6, /* Log above LOG_DEBUG log level about failures */

        FORK_WAIT               = 1 <<  7, /* Wait until child exited */

        FORK_NEW_MOUNTNS        = 1 <<  8, /* Run child in its own mount namespace */

        FORK_MOUNTNS_SLAVE      = 1 <<  9, /* Make child's mount namespace MS_SLAVE */

        FORK_RLIMIT_NOFILE_SAFE = 1 << 10, /* Set RLIMIT_NOFILE soft limit to 1K for select() compat */

        FORK_STDOUT_TO_STDERR   = 1 << 11, /* Make stdout a copy of stderr */

} ForkFlags;

int safe_fork_full(const char *name, const int except_fds[], size_t n_except_fds, ForkFlags flags, pid_t *ret_pid);

static inline int safe_fork(const char *name, ForkFlags flags, pid_t *ret_pid) {

        return safe_fork_full(name, NULL, 0, flags, ret_pid);

}

int namespace_fork(const char *outer_name, const char *inner_name, const int except_fds[], size_t n_except_fds, ForkFlags flags, int pidns_fd, int mntns_fd, int netns_fd, int userns_fd, int root_fd, pid_t *ret_pid);

int fork_agent(const char *name, const int except[], size_t n_except, pid_t *pid, const char *path, ...) _sentinel_;

int set_oom_score_adjust(int value);

/* The highest possibly (theoretic) pid_t value on this architecture. */

#define PID_T_MAX ((pid_t) INT32_MAX)

/* The maximum number of concurrent processes Linux allows on this architecture, as well as the highest valid PID value

 * the kernel will potentially assign. This reflects a value compiled into the kernel (PID_MAX_LIMIT), and sets the

 * upper boundary on what may be written to the /proc/sys/kernel/pid_max sysctl (but do note that the sysctl is off by

 * 1, since PID 0 can never exist and there can hence only be one process less than the limit would suggest). Since

 * these values are documented in proc(5) we feel quite confident that they are stable enough for the near future at

 * least to define them here too. */

#define TASKS_MAX 4194303U

assert_cc(TASKS_MAX <= (unsigned long) PID_T_MAX);

/* Like TAKE_PTR() but for child PIDs, resetting them to 0 */

#define TAKE_PID(pid)                           \

        ({                                      \

                pid_t _pid_ = (pid);            \

                (pid) = 0;                      \

                _pid_;                          \

        })

int pidfd_get_pid(int fd, pid_t *ret);

int setpriority_closest(int priority);