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
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
|
/*-------------------------------------------------------------------------
*
* wait_error.c
* Convert a wait/waitpid(2) result code to a human-readable string
*
*
* Portions Copyright (c) 1996-2022, PostgreSQL Global Development Group
* Portions Copyright (c) 1994, Regents of the University of California
*
*
* IDENTIFICATION
* src/common/wait_error.c
*
*-------------------------------------------------------------------------
*/
#ifndef FRONTEND
#include "postgres.h"
#else
#include "postgres_fe.h"
#endif
#include <signal.h>
#include <sys/wait.h>
/*
* Return a human-readable string explaining the reason a child process
* terminated. The argument is a return code returned by wait(2) or
* waitpid(2). The result is a translated, palloc'd or malloc'd string.
*/
char *
wait_result_to_str(int exitstatus)
{
char str[512];
if (WIFEXITED(exitstatus))
{
/*
* Give more specific error message for some common exit codes that
* have a special meaning in shells.
*/
switch (WEXITSTATUS(exitstatus))
{
case 126:
snprintf(str, sizeof(str), _("command not executable"));
break;
case 127:
snprintf(str, sizeof(str), _("command not found"));
break;
default:
snprintf(str, sizeof(str),
_("child process exited with exit code %d"),
WEXITSTATUS(exitstatus));
}
}
else if (WIFSIGNALED(exitstatus))
{
#if defined(WIN32)
snprintf(str, sizeof(str),
_("child process was terminated by exception 0x%X"),
WTERMSIG(exitstatus));
#else
snprintf(str, sizeof(str),
_("child process was terminated by signal %d: %s"),
WTERMSIG(exitstatus), pg_strsignal(WTERMSIG(exitstatus)));
#endif
}
else
snprintf(str, sizeof(str),
_("child process exited with unrecognized status %d"),
exitstatus);
return pstrdup(str);
}
/*
* Return true if a wait(2) result indicates that the child process
* died due to the specified signal.
*
* The reason this is worth having a wrapper function for is that
* there are two cases: the signal might have been received by our
* immediate child process, or there might've been a shell process
* between us and the child that died. The shell will, per POSIX,
* report the child death using exit code 128 + signal number.
*
* If there is no possibility of an intermediate shell, this function
* need not (and probably should not) be used.
*/
bool
wait_result_is_signal(int exit_status, int signum)
{
if (WIFSIGNALED(exit_status) && WTERMSIG(exit_status) == signum)
return true;
if (WIFEXITED(exit_status) && WEXITSTATUS(exit_status) == 128 + signum)
return true;
return false;
}
/*
* Return true if a wait(2) result indicates that the child process
* died due to any signal. We consider either direct child death
* or a shell report of child process death as matching the condition.
*
* If include_command_not_found is true, also return true for shell
* exit codes indicating "command not found" and the like
* (specifically, exit codes 126 and 127; see above).
*/
bool
wait_result_is_any_signal(int exit_status, bool include_command_not_found)
{
if (WIFSIGNALED(exit_status))
return true;
if (WIFEXITED(exit_status) &&
WEXITSTATUS(exit_status) > (include_command_not_found ? 125 : 128))
return true;
return false;
}
|
