mirror of git://sourceware.org/git/glibc.git
88 lines
3.4 KiB
C
88 lines
3.4 KiB
C
/* 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
|