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
|
/* Create a subprocess.
Copyright (C) 2019-2026 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_SUBPROCESS_H
#define SUPPORT_SUBPROCESS_H
#include <sys/types.h>
struct support_subprocess
{
int stdout_pipe[2];
int stderr_pipe[2];
pid_t pid;
};
/* Invoke CALLBACK (CLOSURE) in a subprocess created with fork and return
its PID, a pipe redirected to STDOUT, and a pipe redirected to STDERR. */
struct support_subprocess support_subprocess
(void (*callback) (void *), void *closure);
/* Issue FILE with ARGV arguments and ENVP environments by using posix_spawn
and return is PID, a pipe redirected to STDOUT, and a pipe redirected to
STDERR. If ENVP is NULL the current environment variable is used. */
struct support_subprocess support_subprogram
(const char *file, char *const argv[], char *const envp[]);
/* Invoke program FILE with ARGV arguments by using posix_spawn and wait for it
to complete. Return program exit status. */
int support_subprogram_wait
(const char *file, char *const argv[]);
/* Wait for the subprocess indicated by PROC::PID. Return the status
indicate by waitpid call. */
int support_process_wait (struct support_subprocess *proc);
/* Terminate the subprocess indicated by PROC::PID, first with a SIGTERM and
then with a SIGKILL. Return the status as for waitpid call. */
int support_process_terminate (struct support_subprocess *proc);
/* Arguments to pass to posix_spawn and related functions to run a
process under the built glibc. This overrides the dynamic linker,
its search path, and other search paths, such as for locales. */
struct support_spawn_wrapped
{
const char *path;
char *const *argv;
char *const *envp;
};
enum support_spawn_wrap_flags
{
/* Always wrap the invocation, even if test binaries are linked
with overridden the default paths to point into the build tree
(--enable-hardcoded-path-in-tests). Can be used to run
non-test binaries. */
support_spawn_wrap_force = 1 << 0,
};
/* Wrap the invocation for invoking testing. PATH is the program
path. If ARGV is null, no arguments are passed. If ENVP is null,
environ is used instead. The result must not be modified. It is a
deep copy of the inputs. */
struct support_spawn_wrapped *support_spawn_wrap (const char *path,
char *const argv[],
char *const envp[],
enum
support_spawn_wrap_flags);
/* Deallocate the result of support_spawn_wrap. */
void support_spawn_wrapped_free (struct support_spawn_wrapped *);
#endif
|
