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