cloexec.h 1.5 KB

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