summaryrefslogtreecommitdiff
path: root/lib/wait-process.h
diff options
context:
space:
mode:
Diffstat (limited to 'lib/wait-process.h')
-rw-r--r--lib/wait-process.h74
1 files changed, 0 insertions, 74 deletions
diff --git a/lib/wait-process.h b/lib/wait-process.h
deleted file mode 100644
index 6d8f0d2b..00000000
--- a/lib/wait-process.h
+++ /dev/null
@@ -1,74 +0,0 @@
-/* Waiting for a subprocess to finish.
- Copyright (C) 2001-2003, 2006, 2008-2013 Free Software Foundation, Inc.
- Written by Bruno Haible <haible@clisp.cons.org>, 2001.
-
- This program is free software: you can redistribute it and/or modify
- it under the terms of the GNU General Public License as published by
- the Free Software Foundation; either version 3 of the License, or
- (at your option) any later version.
-
- 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 General Public License for more details.
-
- You should have received a copy of the GNU General Public License
- along with this program. If not, see <http://www.gnu.org/licenses/>. */
-
-#ifndef _WAIT_PROCESS_H
-#define _WAIT_PROCESS_H
-
-/* Get pid_t. */
-#include <stdlib.h>
-#include <unistd.h>
-#include <sys/types.h>
-
-#include <stdbool.h>
-
-
-#ifdef __cplusplus
-extern "C" {
-#endif
-
-
-/* Wait for a subprocess to finish. Return its exit code.
- If it didn't terminate correctly, exit if exit_on_error is true, otherwise
- return 127.
- Arguments:
- - child is the pid of the subprocess.
- - progname is the name of the program executed by the subprocess, used for
- error messages.
- - If ignore_sigpipe is true, consider a subprocess termination due to
- SIGPIPE as equivalent to a success. This is suitable for processes whose
- only purpose is to write to standard output. This flag can be safely set
- to false when the process' standard output is known to go to DEV_NULL.
- - If null_stderr is true, the usual error message to stderr will be omitted.
- This is suitable when the subprocess does not fulfill an important task.
- - slave_process should be set to true if the process has been launched as a
- slave process.
- - If exit_on_error is true, any error will cause the main process to exit
- with an error status.
- - If termsigp is not NULL: *termsig will be set to the signal that
- terminated the subprocess (if supported by the platform: not on native
- Windows platforms), otherwise 0, and the error message about the signal
- that terminated the subprocess will be omitted.
- Prerequisites: The signal handler for SIGCHLD should not be set to SIG_IGN,
- otherwise this function will not work. */
-extern int wait_subprocess (pid_t child, const char *progname,
- bool ignore_sigpipe, bool null_stderr,
- bool slave_process, bool exit_on_error,
- int *termsigp);
-
-/* Register a subprocess as being a slave process. This means that the
- subprocess will be terminated when its creator receives a catchable fatal
- signal or exits normally. Registration ends when wait_subprocess()
- notices that the subprocess has exited. */
-extern void register_slave_subprocess (pid_t child);
-
-
-#ifdef __cplusplus
-}
-#endif
-
-
-#endif /* _WAIT_PROCESS_H */