src/basic/process-util.h

   1 #pragma once
   2
   3 /***
   4   This file is part of systemd.
   5
   6   Copyright 2010 Lennart Poettering
   7
   8   systemd is free software; you can redistribute it and/or modify it
   9   under the terms of the GNU Lesser General Public License as published by
  10   the Free Software Foundation; either version 2.1 of the License, or
  11   (at your option) any later version.
  12
  13   systemd is distributed in the hope that it will be useful, but
  14   WITHOUT ANY WARRANTY; without even the implied warranty of
  15   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
  16   Lesser General Public License for more details.
  17
  18   You should have received a copy of the GNU Lesser General Public License
  19   along with systemd; If not, see <http://www.gnu.org/licenses/>.
  20 ***/
  21
  22 #include <alloca.h>
  23 #include <signal.h>
  24 #include <stdbool.h>
  25 #include <stddef.h>
  26 #include <stdio.h>
  27 #include <string.h>
  28 #include <sys/types.h>
  29
  30 #include "formats-util.h"
  31 #include "macro.h"
  32
  33 #define procfs_file_alloca(pid, field)                                  \
  34         ({                                                              \
  35                 pid_t _pid_ = (pid);                                    \
  36                 const char *_r_;                                        \
  37                 if (_pid_ == 0) {                                       \
  38                         _r_ = ("/proc/self/" field);                    \
  39                 } else {                                                \
  40                         _r_ = alloca(strlen("/proc/") + DECIMAL_STR_MAX(pid_t) + 1 + sizeof(field)); \
  41                         sprintf((char*) _r_, "/proc/"PID_FMT"/" field, _pid_);                       \
  42                 }                                                       \
  43                 _r_;                                                    \
  44         })
  45
  46 int get_process_state(pid_t pid);
  47 int get_process_comm(pid_t pid, char **name);
  48 int get_process_cmdline(pid_t pid, size_t max_length, bool comm_fallback, char **line);
  49 int get_process_exe(pid_t pid, char **name);
  50
  51 #if 0 /// UNNEEDED by elogind
  52 int get_process_uid(pid_t pid, uid_t *uid);
  53 int get_process_gid(pid_t pid, gid_t *gid);
  54 int get_process_capeff(pid_t pid, char **capeff);
  55 int get_process_cwd(pid_t pid, char **cwd);
  56 int get_process_root(pid_t pid, char **root);
  57 int get_process_environ(pid_t pid, char **environ);
  58 int get_process_ppid(pid_t pid, pid_t *ppid);
  59 #endif // 0
  60
  61 int wait_for_terminate(pid_t pid, siginfo_t *status);
  62 int wait_for_terminate_and_warn(const char *name, pid_t pid, bool check_exit_code);
  63
  64 void sigkill_wait(pid_t *pid);
  65 #define _cleanup_sigkill_wait_ _cleanup_(sigkill_wait)
  66
  67 #if 0 /// UNNEEDED by elogind
  68 int kill_and_sigcont(pid_t pid, int sig);
  69
  70 void rename_process(const char name[8]);
  71 #endif // 0
  72
  73 int is_kernel_thread(pid_t pid);
  74
  75 int getenv_for_pid(pid_t pid, const char *field, char **_value);
  76
  77 bool pid_is_alive(pid_t pid);
  78 bool pid_is_unwaited(pid_t pid);
  79 #if 0 /// UNNEEDED by elogind
  80 int pid_from_same_root_fs(pid_t pid);
  81 #endif // 0
  82
  83 bool is_main_thread(void);
  84
  85 #if 0 /// UNNEEDED by elogind
  86 noreturn void freeze(void);
  87
  88 bool oom_score_adjust_is_valid(int oa);
  89 #endif // 0
  90
  91 #ifndef PERSONALITY_INVALID
  92 /* personality(7) documents that 0xffffffffUL is used for querying the
  93  * current personality, hence let's use that here as error
  94  * indicator. */
  95 #define PERSONALITY_INVALID 0xffffffffLU
  96 #endif
  97
  98 #if 0 /// UNNEEDED by elogind
  99 unsigned long personality_from_string(const char *p);
 100 const char *personality_to_string(unsigned long);
 101
 102 int ioprio_class_to_string_alloc(int i, char **s);
 103 int ioprio_class_from_string(const char *s);
 104
 105 const char *sigchld_code_to_string(int i) _const_;
 106 int sigchld_code_from_string(const char *s) _pure_;
 107
 108 int sched_policy_to_string_alloc(int i, char **s);
 109 int sched_policy_from_string(const char *s);
 110 #endif // 0
 111
 112 #define PTR_TO_PID(p) ((pid_t) ((uintptr_t) p))
 113 #define PID_TO_PTR(p) ((void*) ((uintptr_t) p))
 114
 115 void valgrind_summary_hack(void);