1 /* SPDX-License-Identifier: LGPL-2.1+ */
11 #include <sys/resource.h>
12 #include <sys/types.h>
14 #include "alloc-util.h"
15 #include "format-util.h"
18 #include "time-util.h"
20 #define procfs_file_alloca(pid, field) \
22 pid_t _pid_ = (pid); \
25 _r_ = ("/proc/self/" field); \
27 _r_ = newa(char, STRLEN("/proc/") + DECIMAL_STR_MAX(pid_t) + 1 + sizeof(field)); \
28 sprintf((char*) _r_, "/proc/"PID_FMT"/" field, _pid_); \
33 typedef enum ProcessCmdlineFlags
{
34 PROCESS_CMDLINE_COMM_FALLBACK
= 1 << 0,
35 PROCESS_CMDLINE_USE_LOCALE
= 1 << 1,
36 } ProcessCmdlineFlags
;
38 int get_process_comm(pid_t pid
, char **name
);
39 int get_process_cmdline(pid_t pid
, size_t max_columns
, ProcessCmdlineFlags flags
, char **line
);
40 int get_process_exe(pid_t pid
, char **name
);
41 int get_process_uid(pid_t pid
, uid_t
*uid
);
42 int get_process_gid(pid_t pid
, gid_t
*gid
);
43 int get_process_capeff(pid_t pid
, char **capeff
);
44 int get_process_cwd(pid_t pid
, char **cwd
);
45 int get_process_root(pid_t pid
, char **root
);
46 int get_process_environ(pid_t pid
, char **environ
);
47 int get_process_ppid(pid_t pid
, pid_t
*ppid
);
49 int wait_for_terminate(pid_t pid
, siginfo_t
*status
);
51 typedef enum WaitFlags
{
52 WAIT_LOG_ABNORMAL
= 1 << 0,
53 WAIT_LOG_NON_ZERO_EXIT_STATUS
= 1 << 1,
55 /* A shortcut for requesting the most complete logging */
56 WAIT_LOG
= WAIT_LOG_ABNORMAL
|WAIT_LOG_NON_ZERO_EXIT_STATUS
,
59 int wait_for_terminate_and_check(const char *name
, pid_t pid
, WaitFlags flags
);
60 int wait_for_terminate_with_timeout(pid_t pid
, usec_t timeout
);
62 void sigkill_wait(pid_t pid
);
63 void sigkill_waitp(pid_t
*pid
);
64 void sigterm_wait(pid_t pid
);
66 int kill_and_sigcont(pid_t pid
, int sig
);
68 int rename_process(const char name
[]);
69 int is_kernel_thread(pid_t pid
);
71 int getenv_for_pid(pid_t pid
, const char *field
, char **_value
);
73 bool pid_is_alive(pid_t pid
);
74 bool pid_is_unwaited(pid_t pid
);
75 int pid_is_my_child(pid_t pid
);
76 int pid_from_same_root_fs(pid_t pid
);
78 bool is_main_thread(void);
80 _noreturn_
void freeze(void);
82 bool oom_score_adjust_is_valid(int oa
);
84 #ifndef PERSONALITY_INVALID
85 /* personality(7) documents that 0xffffffffUL is used for querying the
86 * current personality, hence let's use that here as error
88 #define PERSONALITY_INVALID 0xffffffffLU
91 unsigned long personality_from_string(const char *p
);
92 const char *personality_to_string(unsigned long);
94 int safe_personality(unsigned long p
);
95 int opinionated_personality(unsigned long *ret
);
97 int ioprio_class_to_string_alloc(int i
, char **s
);
98 int ioprio_class_from_string(const char *s
);
100 const char *sigchld_code_to_string(int i
) _const_
;
101 int sigchld_code_from_string(const char *s
) _pure_
;
103 int sched_policy_to_string_alloc(int i
, char **s
);
104 int sched_policy_from_string(const char *s
);
106 static inline pid_t
PTR_TO_PID(const void *p
) {
107 return (pid_t
) ((uintptr_t) p
);
110 static inline void* PID_TO_PTR(pid_t pid
) {
111 return (void*) ((uintptr_t) pid
);
114 void valgrind_summary_hack(void);
116 int pid_compare_func(const pid_t
*a
, const pid_t
*b
);
118 static inline bool nice_is_valid(int n
) {
119 return n
>= PRIO_MIN
&& n
< PRIO_MAX
;
122 static inline bool sched_policy_is_valid(int i
) {
123 return IN_SET(i
, SCHED_OTHER
, SCHED_BATCH
, SCHED_IDLE
, SCHED_FIFO
, SCHED_RR
);
126 static inline bool sched_priority_is_valid(int i
) {
127 return i
>= 0 && i
<= sched_get_priority_max(SCHED_RR
);
130 static inline bool ioprio_class_is_valid(int i
) {
131 return IN_SET(i
, IOPRIO_CLASS_NONE
, IOPRIO_CLASS_RT
, IOPRIO_CLASS_BE
, IOPRIO_CLASS_IDLE
);
134 static inline bool ioprio_priority_is_valid(int i
) {
135 return i
>= 0 && i
< IOPRIO_BE_NR
;
138 static inline bool pid_is_valid(pid_t p
) {
142 int ioprio_parse_priority(const char *s
, int *ret
);
144 pid_t
getpid_cached(void);
145 void reset_cached_pid(void);
147 int must_be_root(void);
149 typedef enum ForkFlags
{
150 FORK_RESET_SIGNALS
= 1 << 0, /* Reset all signal handlers and signal mask */
151 FORK_CLOSE_ALL_FDS
= 1 << 1, /* Close all open file descriptors in the child, except for 0,1,2 */
152 FORK_DEATHSIG
= 1 << 2, /* Set PR_DEATHSIG in the child */
153 FORK_NULL_STDIO
= 1 << 3, /* Connect 0,1,2 to /dev/null */
154 FORK_REOPEN_LOG
= 1 << 4, /* Reopen log connection */
155 FORK_LOG
= 1 << 5, /* Log above LOG_DEBUG log level about failures */
156 FORK_WAIT
= 1 << 6, /* Wait until child exited */
157 FORK_NEW_MOUNTNS
= 1 << 7, /* Run child in its own mount namespace */
158 FORK_MOUNTNS_SLAVE
= 1 << 8, /* Make child's mount namespace MS_SLAVE */
159 FORK_RLIMIT_NOFILE_SAFE
= 1 << 9, /* Set RLIMIT_NOFILE soft limit to 1K for select() compat */
160 FORK_STDOUT_TO_STDERR
= 1 << 10, /* Make stdout a copy of stderr */
163 int safe_fork_full(const char *name
, const int except_fds
[], size_t n_except_fds
, ForkFlags flags
, pid_t
*ret_pid
);
165 static inline int safe_fork(const char *name
, ForkFlags flags
, pid_t
*ret_pid
) {
166 return safe_fork_full(name
, NULL
, 0, flags
, ret_pid
);
169 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
);
171 int fork_agent(const char *name
, const int except
[], size_t n_except
, pid_t
*pid
, const char *path
, ...) _sentinel_
;
173 int set_oom_score_adjust(int value
);
175 /* The highest possibly (theoretic) pid_t value on this architecture. */
176 #define PID_T_MAX ((pid_t) INT32_MAX)
177 /* The maximum number of concurrent processes Linux allows on this architecture, as well as the highest valid PID value
178 * the kernel will potentially assign. This reflects a value compiled into the kernel (PID_MAX_LIMIT), and sets the
179 * upper boundary on what may be written to the /proc/sys/kernel/pid_max sysctl (but do note that the sysctl is off by
180 * 1, since PID 0 can never exist and there can hence only be one process less than the limit would suggest). Since
181 * these values are documented in proc(5) we feel quite confident that they are stable enough for the near future at
182 * least to define them here too. */
183 #define TASKS_MAX 4194303U
185 assert_cc(TASKS_MAX
<= (unsigned long) PID_T_MAX
);
187 /* Like TAKE_PTR() but for child PIDs, resetting them to 0 */
188 #define TAKE_PID(pid) \
190 pid_t _pid_ = (pid); \
195 int pidfd_get_pid(int fd
, pid_t
*ret
);
197 int setpriority_closest(int priority
);