1 /* Wait for process state.
2    Copyright (C) 2020-2022 Free Software Foundation, Inc.
3    This file is part of the GNU C Library.
4 
5    The GNU C Library is free software; you can redistribute it and/or
6    modify it under the terms of the GNU Lesser General Public
7    License as published by the Free Software Foundation; either
8    version 2.1 of the License, or (at your option) any later version.
9 
10    The GNU C Library is distributed in the hope that it will be useful,
11    but WITHOUT ANY WARRANTY; without even the implied warranty of
12    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
13    Lesser General Public License for more details.
14 
15    You should have received a copy of the GNU Lesser General Public
16    License along with the GNU C Library; if not, see
17    <https://www.gnu.org/licenses/>.  */
18 
19 #ifndef SUPPORT_PROCESS_STATE_H
20 #define SUPPORT_PROCESS_STATE_H
21 
22 #include <sys/types.h>
23 
24 enum support_process_state
25 {
26   support_process_state_running      = 0x01,  /* R (running).  */
27   support_process_state_sleeping     = 0x02,  /* S (sleeping).  */
28   support_process_state_disk_sleep   = 0x04,  /* D (disk sleep).  */
29   support_process_state_stopped      = 0x08,  /* T (stopped).  */
30   support_process_state_tracing_stop = 0x10,  /* t (tracing stop).  */
31   support_process_state_dead         = 0x20,  /* X (dead).  */
32   support_process_state_zombie       = 0x40,  /* Z (zombie).  */
33   support_process_state_parked       = 0x80,  /* P (parked).  */
34 };
35 
36 /* Wait for process PID to reach state STATE.  It can be a combination of
37    multiple possible states ('process_state_running | process_state_sleeping')
38    where the function return when any of these state are observed.
39    For an invalid state not represented by SUPPORT_PROCESS_STATE, it fallbacks
40    to a 2 second sleep.  */
41 void support_process_state_wait (pid_t pid, enum support_process_state state);
42 
43 #endif
44