1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
|
/*
* Copyright © 2013 Canonical Ltd.
*
* This program is free software: you can redistribute it and/or modify it
* under the terms of the GNU Lesser General Public License version 3,
* as published by the Free Software Foundation.
*
* This program 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 this program. If not, see <http://www.gnu.org/licenses/>.
*
* Authored by: Thomas Voß <thomas.voss@canonical.com>
*/
#ifndef CORE_POSIX_WAIT_H_
#define CORE_POSIX_WAIT_H_
#include <core/posix/exit.h>
#include <core/posix/signal.h>
#include <core/posix/visibility.h>
#include <bitset>
#include <cstdint>
#include <sys/wait.h>
namespace core
{
namespace posix
{
namespace wait
{
/**
* @brief Flags enumerates different behavior when waiting for a child process to change state.
*/
enum class Flags : std::uint8_t
{
continued = WCONTINUED, ///< Also wait for a child to continue after having been stopped.
untraced = WUNTRACED, ///< Also wait for state changes in untraced children.
no_hang = WNOHANG ///< Do not block if a child process hasn't changed state.
};
CORE_POSIX_DLL_PUBLIC Flags operator|(Flags l, Flags r);
/**
* @brief The Result struct encapsulates the result of waiting for a process state change.
*/
struct CORE_POSIX_DLL_PUBLIC Result
{
/**
* @brief The status of the process/wait operation.
*/
enum class Status
{
undefined, ///< Marks an undefined state.
no_state_change, ///< No state change occurred.
exited, ///< The process exited normally.
signaled, ///< The process was signalled and terminated.
stopped, ///< The process was signalled and stopped.
continued ///< The process resumed operation.
} status = Status::undefined;
/**
* @brief Union of result-specific details.
*/
union
{
/**
* Contains the exit status of the process if status == Status::exited.
*/
struct
{
exit::Status status; ///< Exit status of the process.
} if_exited;
/**
* Contains the signal that caused the process to terminate if status == Status::signaled.
*/
struct
{
Signal signal; ///< Signal that caused the process to terminate.
bool core_dumped; ///< true if the process termination resulted in a core dump.
} if_signaled;
/**
* Contains the signal that caused the process to terminate if status == Status::stopped.
*/
struct
{
Signal signal; ///< Signal that caused the process to terminate.
} if_stopped;
} detail;
};
}
}
}
#endif // CORE_POSIX_WAIT_H_
|
