master
1/* POSIX spawn extensions. Linux version.
2 Copyright (C) 2023-2025 Free Software Foundation, Inc.
3 This file is part of the GNU C Library.
4
5 The GNU C Library is free software; you can redistribute it and/or
6 modify it under the terms of the GNU Lesser General Public
7 License as published by the Free Software Foundation; either
8 version 2.1 of the License, or (at your option) any later version.
9
10 The GNU C Library 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 GNU
13 Lesser General Public License for more details.
14
15 You should have received a copy of the GNU Lesser General Public
16 License along with the GNU C Library; if not, see
17 <https://www.gnu.org/licenses/>. */
18
19#ifndef _SPAWN_H
20# error "Never include <bits/spawn-ext.h> directly; use <spawn.h> instead."
21#endif
22
23__BEGIN_DECLS
24
25#ifdef __USE_MISC
26
27/* Get the cgroupsv2 the attribute structure. */
28extern int posix_spawnattr_getcgroup_np (const posix_spawnattr_t *
29 __restrict __attr,
30 int *__restrict __cgroup)
31 __THROW __nonnull ((1, 2));
32
33/* Sore the cgroupsv2 the attribute structure. */
34extern int posix_spawnattr_setcgroup_np (posix_spawnattr_t *__attr,
35 int __cgroup)
36 __THROW __nonnull ((1));
37
38// zig patch: check target glibc version
39#if (__GLIBC__ == 2 && __GLIBC_MINOR__ >= 39) || __GLIBC__ > 2
40/* Spawn a new process executing PATH with the attributes describes in *ATTRP.
41 Before running the process perform the actions described in FACTS. Return
42 a PID file descriptor in PIDFD if process creation was successful and the
43 argument is non-null.
44
45 This function is a possible cancellation point and therefore not
46 marked with __THROW. */
47extern int pidfd_spawn (int *__restrict __pidfd,
48 const char *__restrict __path,
49 const posix_spawn_file_actions_t *__restrict __facts,
50 const posix_spawnattr_t *__restrict __attrp,
51 char *const __argv[__restrict_arr],
52 char *const __envp[__restrict_arr])
53 __nonnull ((2, 5));
54
55/* Similar to `pidfd_spawn' but search for FILE in the PATH.
56
57 This function is a possible cancellation point and therefore not
58 marked with __THROW. */
59extern int pidfd_spawnp (int *__restrict __pidfd,
60 const char *__restrict __file,
61 const posix_spawn_file_actions_t *__restrict __facts,
62 const posix_spawnattr_t *__restrict __attrp,
63 char *const __argv[__restrict_arr],
64 char *const __envp[__restrict_arr])
65 __nonnull ((1, 2, 5));
66#endif /* (__GLIBC__ == 2 && __GLIBC_MINOR__ >= 39) || __GLIBC__ > 2 */
67
68#endif /* __USE_MISC */
69
70__END_DECLS