1 /* cloexec.c - set or clear the close-on-exec descriptor flag
2 
3    Copyright (C) 2004, 2009-2020 Free Software Foundation, Inc.
4 
5    This program is free software: you can redistribute it and/or modify
6    it under the terms of the GNU General Public License as published by
7    the Free Software Foundation; either version 3 of the License, or
8    (at your option) any later version.
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
16    along with this program.  If not, see <https://www.gnu.org/licenses/>.
17 
18 */
19 
20 #include <stdbool.h>
21 
22 /* Set the 'FD_CLOEXEC' flag of DESC if VALUE is true,
23    or clear the flag if VALUE is false.
24    Return 0 on success, or -1 on error with 'errno' set.
25 
26    Note that on MingW, this function does NOT protect DESC from being
27    inherited into spawned children.  Instead, either use dup_cloexec
28    followed by closing the original DESC, or use interfaces such as
29    open or pipe2 that accept flags like O_CLOEXEC to create DESC
30    non-inheritable in the first place.  */
31 
32 int set_cloexec_flag (int desc, bool value);
33 
34 /* Duplicates a file handle FD, while marking the copy to be closed
35    prior to exec or spawn.  Returns -1 and sets errno if FD could not
36    be duplicated.  */
37 
38 int dup_cloexec (int fd);
39