1/* POSIX spawn extensions. Linux version.
2 Copyright (C) 2023-2024 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/* Spawn a new process executing PATH with the attributes describes in *ATTRP.
39 Before running the process perform the actions described in FACTS. Return
40 a PID file descriptor in PIDFD if process creation was successful and the
41 argument is non-null.
42
43 This function is a possible cancellation point and therefore not
44 marked with __THROW. */
45extern int pidfd_spawn (int *__restrict __pidfd,
46 const char *__restrict __path,
47 const posix_spawn_file_actions_t *__restrict __facts,
48 const posix_spawnattr_t *__restrict __attrp,
49 char *const __argv[__restrict_arr],
50 char *const __envp[__restrict_arr])
51 __nonnull ((2, 5));
52
53/* Similar to `pidfd_spawn' but search for FILE in the PATH.
54
55 This function is a possible cancellation point and therefore not
56 marked with __THROW. */
57extern int pidfd_spawnp (int *__restrict __pidfd,
58 const char *__restrict __file,
59 const posix_spawn_file_actions_t *__restrict __facts,
60 const posix_spawnattr_t *__restrict __attrp,
61 char *const __argv[__restrict_arr],
62 char *const __envp[__restrict_arr])
63 __nonnull ((1, 2, 5));
64
65#endif /* __USE_MISC */
66
67__END_DECLS
68