]>
Commit | Line | Data |
---|---|---|
53e1b683 | 1 | /* SPDX-License-Identifier: LGPL-2.1+ */ |
0b452006 RC |
2 | #pragma once |
3 | ||
0b452006 | 4 | #include <alloca.h> |
dccca82b | 5 | #include <errno.h> |
29ea9f0f | 6 | #include <sched.h> |
71d35b6b TA |
7 | #include <signal.h> |
8 | #include <stdbool.h> | |
11c3a366 | 9 | #include <stddef.h> |
0b452006 RC |
10 | #include <stdio.h> |
11 | #include <string.h> | |
41bf0590 | 12 | #include <sys/resource.h> |
7f452159 | 13 | #include <sys/types.h> |
0b452006 | 14 | |
f97b34a6 | 15 | #include "format-util.h" |
7f452159 | 16 | #include "ioprio.h" |
7b3e062c | 17 | #include "macro.h" |
d5641e0d | 18 | #include "time-util.h" |
0b452006 RC |
19 | |
20 | #define procfs_file_alloca(pid, field) \ | |
21 | ({ \ | |
22 | pid_t _pid_ = (pid); \ | |
23 | const char *_r_; \ | |
24 | if (_pid_ == 0) { \ | |
25 | _r_ = ("/proc/self/" field); \ | |
26 | } else { \ | |
fbd0b64f | 27 | _r_ = alloca(STRLEN("/proc/") + DECIMAL_STR_MAX(pid_t) + 1 + sizeof(field)); \ |
0b452006 RC |
28 | sprintf((char*) _r_, "/proc/"PID_FMT"/" field, _pid_); \ |
29 | } \ | |
30 | _r_; \ | |
31 | }) | |
32 | ||
33 | int get_process_state(pid_t pid); | |
34 | int get_process_comm(pid_t pid, char **name); | |
35 | int get_process_cmdline(pid_t pid, size_t max_length, bool comm_fallback, char **line); | |
36 | int get_process_exe(pid_t pid, char **name); | |
37 | int get_process_uid(pid_t pid, uid_t *uid); | |
38 | int get_process_gid(pid_t pid, gid_t *gid); | |
39 | int get_process_capeff(pid_t pid, char **capeff); | |
40 | int get_process_cwd(pid_t pid, char **cwd); | |
41 | int get_process_root(pid_t pid, char **root); | |
42 | int get_process_environ(pid_t pid, char **environ); | |
6bc73acb | 43 | int get_process_ppid(pid_t pid, pid_t *ppid); |
0b452006 RC |
44 | |
45 | int wait_for_terminate(pid_t pid, siginfo_t *status); | |
7d4904fe LP |
46 | |
47 | typedef enum WaitFlags { | |
ef31828d LP |
48 | WAIT_LOG_ABNORMAL = 1 << 0, |
49 | WAIT_LOG_NON_ZERO_EXIT_STATUS = 1 << 1, | |
7d4904fe LP |
50 | |
51 | /* A shortcut for requesting the most complete logging */ | |
52 | WAIT_LOG = WAIT_LOG_ABNORMAL|WAIT_LOG_NON_ZERO_EXIT_STATUS, | |
53 | } WaitFlags; | |
54 | ||
55 | int wait_for_terminate_and_check(const char *name, pid_t pid, WaitFlags flags); | |
d5641e0d | 56 | int wait_for_terminate_with_timeout(pid_t pid, usec_t timeout); |
0b452006 | 57 | |
89c9030d LP |
58 | void sigkill_wait(pid_t pid); |
59 | void sigkill_waitp(pid_t *pid); | |
392cf1d0 | 60 | void sigterm_wait(pid_t pid); |
4d0d3d41 | 61 | |
0b452006 | 62 | int kill_and_sigcont(pid_t pid, int sig); |
405f8907 | 63 | |
9bfaffd5 | 64 | int rename_process(const char name[]); |
0b452006 | 65 | int is_kernel_thread(pid_t pid); |
405f8907 | 66 | |
0b452006 RC |
67 | int getenv_for_pid(pid_t pid, const char *field, char **_value); |
68 | ||
69 | bool pid_is_alive(pid_t pid); | |
70 | bool pid_is_unwaited(pid_t pid); | |
1359fffa | 71 | int pid_from_same_root_fs(pid_t pid); |
d4510856 LP |
72 | |
73 | bool is_main_thread(void); | |
ceee6d3a | 74 | |
848e863a | 75 | _noreturn_ void freeze(void); |
7b3e062c LP |
76 | |
77 | bool oom_score_adjust_is_valid(int oa); | |
78 | ||
79 | #ifndef PERSONALITY_INVALID | |
80 | /* personality(7) documents that 0xffffffffUL is used for querying the | |
81 | * current personality, hence let's use that here as error | |
82 | * indicator. */ | |
83 | #define PERSONALITY_INVALID 0xffffffffLU | |
84 | #endif | |
85 | ||
86 | unsigned long personality_from_string(const char *p); | |
87 | const char *personality_to_string(unsigned long); | |
88 | ||
21022b9d | 89 | int safe_personality(unsigned long p); |
e8132d63 LP |
90 | int opinionated_personality(unsigned long *ret); |
91 | ||
7b3e062c LP |
92 | int ioprio_class_to_string_alloc(int i, char **s); |
93 | int ioprio_class_from_string(const char *s); | |
94 | ||
95 | const char *sigchld_code_to_string(int i) _const_; | |
96 | int sigchld_code_from_string(const char *s) _pure_; | |
97 | ||
98 | int sched_policy_to_string_alloc(int i, char **s); | |
99 | int sched_policy_from_string(const char *s); | |
100 | ||
bc2fcf7f LP |
101 | static inline pid_t PTR_TO_PID(const void *p) { |
102 | return (pid_t) ((uintptr_t) p); | |
103 | } | |
104 | ||
105 | static inline void* PID_TO_PTR(pid_t pid) { | |
106 | return (void*) ((uintptr_t) pid); | |
107 | } | |
dcadc967 EV |
108 | |
109 | void valgrind_summary_hack(void); | |
291d565a LP |
110 | |
111 | int pid_compare_func(const void *a, const void *b); | |
41bf0590 LP |
112 | |
113 | static inline bool nice_is_valid(int n) { | |
114 | return n >= PRIO_MIN && n < PRIO_MAX; | |
115 | } | |
7f452159 | 116 | |
29ea9f0f YW |
117 | static inline bool sched_policy_is_valid(int i) { |
118 | return IN_SET(i, SCHED_OTHER, SCHED_BATCH, SCHED_IDLE, SCHED_FIFO, SCHED_RR); | |
119 | } | |
120 | ||
121 | static inline bool sched_priority_is_valid(int i) { | |
122 | return i >= 0 && i <= sched_get_priority_max(SCHED_RR); | |
123 | } | |
124 | ||
7f452159 LP |
125 | static inline bool ioprio_class_is_valid(int i) { |
126 | return IN_SET(i, IOPRIO_CLASS_NONE, IOPRIO_CLASS_RT, IOPRIO_CLASS_BE, IOPRIO_CLASS_IDLE); | |
127 | } | |
128 | ||
129 | static inline bool ioprio_priority_is_valid(int i) { | |
130 | return i >= 0 && i < IOPRIO_BE_NR; | |
131 | } | |
132 | ||
54191eb3 LP |
133 | static inline bool pid_is_valid(pid_t p) { |
134 | return p > 0; | |
135 | } | |
136 | ||
33d12153 YW |
137 | static inline int sched_policy_to_string_alloc_with_check(int n, char **s) { |
138 | if (!sched_policy_is_valid(n)) | |
139 | return -EINVAL; | |
140 | ||
141 | return sched_policy_to_string_alloc(n, s); | |
142 | } | |
143 | ||
7f452159 | 144 | int ioprio_parse_priority(const char *s, int *ret); |
5c30a6d2 LP |
145 | |
146 | pid_t getpid_cached(void); | |
799a960d | 147 | void reset_cached_pid(void); |
fba868fa LP |
148 | |
149 | int must_be_root(void); | |
4c253ed1 LP |
150 | |
151 | typedef enum ForkFlags { | |
ef31828d LP |
152 | FORK_RESET_SIGNALS = 1 << 0, |
153 | FORK_CLOSE_ALL_FDS = 1 << 1, | |
154 | FORK_DEATHSIG = 1 << 2, | |
155 | FORK_NULL_STDIO = 1 << 3, | |
156 | FORK_REOPEN_LOG = 1 << 4, | |
157 | FORK_LOG = 1 << 5, | |
158 | FORK_WAIT = 1 << 6, | |
159 | FORK_NEW_MOUNTNS = 1 << 7, | |
160 | FORK_MOUNTNS_SLAVE = 1 << 8, | |
4c253ed1 LP |
161 | } ForkFlags; |
162 | ||
163 | int safe_fork_full(const char *name, const int except_fds[], size_t n_except_fds, ForkFlags flags, pid_t *ret_pid); | |
164 | ||
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); | |
167 | } | |
78752f2e | 168 | |
da6053d0 | 169 | int fork_agent(const char *name, const int except[], size_t n_except, pid_t *pid, const char *path, ...); |
f3a367d6 | 170 | |
9f8168eb LP |
171 | int set_oom_score_adjust(int value); |
172 | ||
f3a367d6 LP |
173 | #if SIZEOF_PID_T == 4 |
174 | /* The highest possibly (theoretic) pid_t value on this architecture. */ | |
175 | #define PID_T_MAX ((pid_t) INT32_MAX) | |
176 | /* The maximum number of concurrent processes Linux allows on this architecture, as well as the highest valid PID value | |
177 | * the kernel will potentially assign. This reflects a value compiled into the kernel (PID_MAX_LIMIT), and sets the | |
178 | * upper boundary on what may be written to the /proc/sys/kernel/pid_max sysctl (but do note that the sysctl is off by | |
179 | * 1, since PID 0 can never exist and there can hence only be one process less than the limit would suggest). Since | |
180 | * these values are documented in proc(5) we feel quite confident that they are stable enough for the near future at | |
181 | * least to define them here too. */ | |
182 | #define TASKS_MAX 4194303U | |
183 | #elif SIZEOF_PID_T == 2 | |
184 | #define PID_T_MAX ((pid_t) INT16_MAX) | |
185 | #define TASKS_MAX 32767U | |
186 | #else | |
187 | #error "Unknown pid_t size" | |
188 | #endif | |
189 | ||
190 | assert_cc(TASKS_MAX <= (unsigned long) PID_T_MAX) | |
342f6f80 LP |
191 | |
192 | /* Like TAKE_PTR() but for child PIDs, resetting them to 0 */ | |
193 | #define TAKE_PID(pid) \ | |
194 | ({ \ | |
195 | pid_t _pid_ = (pid); \ | |
196 | (pid) = 0; \ | |
197 | _pid_; \ | |
198 | }) |