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