Mercurial > hg > octave-shane > gnulib-hg
annotate lib/execute.h @ 17616:cae23a655793
autoupdate
| author | Karl Berry <karl@freefriends.org> |
|---|---|
| date | Sat, 25 Jan 2014 06:40:43 -0800 (2014-01-25) |
| parents | 344018b6e5d7 |
| children |
| rev | line source |
|---|---|
| 4936 | 1 /* Creation of autonomous subprocesses. |
| 17587 | 2 Copyright (C) 2001-2003, 2008-2014 Free Software Foundation, Inc. |
| 4936 | 3 Written by Bruno Haible <haible@clisp.cons.org>, 2001. |
| 4 | |
|
9309
bbbbbf4cd1c5
Change copyright notice from GPLv2+ to GPLv3+.
Bruno Haible <bruno@clisp.org>
parents:
5848
diff
changeset
|
5 This program is free software: you can redistribute it and/or modify |
| 4936 | 6 it under the terms of the GNU General Public License as published by |
|
9309
bbbbbf4cd1c5
Change copyright notice from GPLv2+ to GPLv3+.
Bruno Haible <bruno@clisp.org>
parents:
5848
diff
changeset
|
7 the Free Software Foundation; either version 3 of the License, or |
|
bbbbbf4cd1c5
Change copyright notice from GPLv2+ to GPLv3+.
Bruno Haible <bruno@clisp.org>
parents:
5848
diff
changeset
|
8 (at your option) any later version. |
| 4936 | 9 |
| 10 This program is distributed in the hope that it will be useful, | |
| 11 but WITHOUT ANY WARRANTY; without even the implied warranty of | |
| 12 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the | |
| 13 GNU General Public License for more details. | |
| 14 | |
| 15 You should have received a copy of the GNU General Public License | |
|
9309
bbbbbf4cd1c5
Change copyright notice from GPLv2+ to GPLv3+.
Bruno Haible <bruno@clisp.org>
parents:
5848
diff
changeset
|
16 along with this program. If not, see <http://www.gnu.org/licenses/>. */ |
| 4936 | 17 |
| 18 #ifndef _EXECUTE_H | |
| 19 #define _EXECUTE_H | |
| 20 | |
| 21 #include <stdbool.h> | |
| 22 | |
| 23 /* Execute a command, optionally redirecting any of the three standard file | |
| 24 descriptors to /dev/null. Return its exit code. | |
| 25 If it didn't terminate correctly, exit if exit_on_error is true, otherwise | |
| 26 return 127. | |
| 27 If ignore_sigpipe is true, consider a subprocess termination due to SIGPIPE | |
| 28 as equivalent to a success. This is suitable for processes whose only | |
| 29 purpose is to write to standard output. | |
| 30 If slave_process is true, the child process will be terminated when its | |
| 31 creator receives a catchable fatal signal. | |
|
10197
d079dd7b69bc
Add termsigp argument to execute() and wait_process().
Bruno Haible <bruno@clisp.org>
parents:
9309
diff
changeset
|
32 If termsigp is not NULL, *termsig will be set to the signal that terminated |
|
d079dd7b69bc
Add termsigp argument to execute() and wait_process().
Bruno Haible <bruno@clisp.org>
parents:
9309
diff
changeset
|
33 the subprocess (if supported by the platform: not on native Windows |
|
d079dd7b69bc
Add termsigp argument to execute() and wait_process().
Bruno Haible <bruno@clisp.org>
parents:
9309
diff
changeset
|
34 platforms), otherwise 0. |
| 4936 | 35 It is recommended that no signal is blocked or ignored while execute() |
| 36 is called. See pipe.h for the reason. */ | |
| 37 extern int execute (const char *progname, | |
|
12421
e8d2c6fc33ad
Use spaces for indentation, not tabs.
Bruno Haible <bruno@clisp.org>
parents:
10197
diff
changeset
|
38 const char *prog_path, char **prog_argv, |
|
e8d2c6fc33ad
Use spaces for indentation, not tabs.
Bruno Haible <bruno@clisp.org>
parents:
10197
diff
changeset
|
39 bool ignore_sigpipe, |
|
e8d2c6fc33ad
Use spaces for indentation, not tabs.
Bruno Haible <bruno@clisp.org>
parents:
10197
diff
changeset
|
40 bool null_stdin, bool null_stdout, bool null_stderr, |
|
e8d2c6fc33ad
Use spaces for indentation, not tabs.
Bruno Haible <bruno@clisp.org>
parents:
10197
diff
changeset
|
41 bool slave_process, bool exit_on_error, |
|
e8d2c6fc33ad
Use spaces for indentation, not tabs.
Bruno Haible <bruno@clisp.org>
parents:
10197
diff
changeset
|
42 int *termsigp); |
| 4936 | 43 |
| 44 #endif /* _EXECUTE_H */ |