mirror of
https://sourceware.org/git/glibc.git
synced 2024-12-27 05:00:15 +00:00
dfe9aa9156
It allows parent process to wait for child state using a polling strategy over procfs on Linux. The polling is used over ptrace to avoid the need to handle signals on the target pid and to handle some system specific limitation (such as YAMA). The polling has some limitations, such as resource consumption due the procfs read in a loop and the lack of synchronization after the state is obtained. The interface idea is to simplify some sleep synchronization waitid tests and is to reduce timeouts by replacing arbitrary waits.
44 lines
1.8 KiB
C
44 lines
1.8 KiB
C
/* Wait for process state.
|
|
Copyright (C) 2020 Free Software Foundation, Inc.
|
|
This file is part of the GNU C Library.
|
|
|
|
The GNU C Library is free software; you can redistribute it and/or
|
|
modify it under the terms of the GNU Lesser General Public
|
|
License as published by the Free Software Foundation; either
|
|
version 2.1 of the License, or (at your option) any later version.
|
|
|
|
The GNU C Library is distributed in the hope that it will be useful,
|
|
but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
|
|
Lesser General Public License for more details.
|
|
|
|
You should have received a copy of the GNU Lesser General Public
|
|
License along with the GNU C Library; if not, see
|
|
<https://www.gnu.org/licenses/>. */
|
|
|
|
#ifndef SUPPORT_PROCESS_STATE_H
|
|
#define SUPPORT_PROCESS_STATE_H
|
|
|
|
#include <sys/types.h>
|
|
|
|
enum support_process_state
|
|
{
|
|
support_process_state_running = 0x01, /* R (running). */
|
|
support_process_state_sleeping = 0x02, /* S (sleeping). */
|
|
support_process_state_disk_sleep = 0x04, /* D (disk sleep). */
|
|
support_process_state_stopped = 0x08, /* T (stopped). */
|
|
support_process_state_tracing_stop = 0x10, /* t (tracing stop). */
|
|
support_process_state_dead = 0x20, /* X (dead). */
|
|
support_process_state_zombie = 0x40, /* Z (zombie). */
|
|
support_process_state_parked = 0x80, /* P (parked). */
|
|
};
|
|
|
|
/* Wait for process PID to reach state STATE. It can be a combination of
|
|
multiple possible states ('process_state_running | process_state_sleeping')
|
|
where the function return when any of these state are observed.
|
|
For an invalid state not represented by SUPPORT_PROCESS_STATE, it fallbacks
|
|
to a 2 second sleep. */
|
|
void support_process_state_wait (pid_t pid, enum support_process_state state);
|
|
|
|
#endif
|