1/* SPDX-License-Identifier: GPL-2.0 WITH Linux-syscall-note */
2#ifndef _LINUX_SCHED_H
3#define _LINUX_SCHED_H
4
5#include <linux/types.h>
6
7/*
8 * cloning flags:
9 */
10#define CSIGNAL 0x000000ff /* signal mask to be sent at exit */
11#define CLONE_VM 0x00000100 /* set if VM shared between processes */
12#define CLONE_FS 0x00000200 /* set if fs info shared between processes */
13#define CLONE_FILES 0x00000400 /* set if open files shared between processes */
14#define CLONE_SIGHAND 0x00000800 /* set if signal handlers and blocked signals shared */
15#define CLONE_PIDFD 0x00001000 /* set if a pidfd should be placed in parent */
16#define CLONE_PTRACE 0x00002000 /* set if we want to let tracing continue on the child too */
17#define CLONE_VFORK 0x00004000 /* set if the parent wants the child to wake it up on mm_release */
18#define CLONE_PARENT 0x00008000 /* set if we want to have the same parent as the cloner */
19#define CLONE_THREAD 0x00010000 /* Same thread group? */
20#define CLONE_NEWNS 0x00020000 /* New mount namespace group */
21#define CLONE_SYSVSEM 0x00040000 /* share system V SEM_UNDO semantics */
22#define CLONE_SETTLS 0x00080000 /* create a new TLS for the child */
23#define CLONE_PARENT_SETTID 0x00100000 /* set the TID in the parent */
24#define CLONE_CHILD_CLEARTID 0x00200000 /* clear the TID in the child */
25#define CLONE_DETACHED 0x00400000 /* Unused, ignored */
26#define CLONE_UNTRACED 0x00800000 /* set if the tracing process can't force CLONE_PTRACE on this clone */
27#define CLONE_CHILD_SETTID 0x01000000 /* set the TID in the child */
28#define CLONE_NEWCGROUP 0x02000000 /* New cgroup namespace */
29#define CLONE_NEWUTS 0x04000000 /* New utsname namespace */
30#define CLONE_NEWIPC 0x08000000 /* New ipc namespace */
31#define CLONE_NEWUSER 0x10000000 /* New user namespace */
32#define CLONE_NEWPID 0x20000000 /* New pid namespace */
33#define CLONE_NEWNET 0x40000000 /* New network namespace */
34#define CLONE_IO 0x80000000 /* Clone io context */
35
36/* Flags for the clone3() syscall. */
37#define CLONE_CLEAR_SIGHAND (1ULL << 32) /* Clear any signal handler and reset to SIG_DFL. */
38#define CLONE_INTO_CGROUP (1ULL << 33) /* Clone into a specific cgroup given the right permissions. */
39#define CLONE_AUTOREAP (1ULL << 34) /* Auto-reap child on exit. */
40#define CLONE_NNP (1ULL << 35) /* Set no_new_privs on child. */
41#define CLONE_PIDFD_AUTOKILL (1ULL << 36) /* Kill child when clone pidfd closes. */
42#define CLONE_EMPTY_MNTNS (1ULL << 37) /* Create an empty mount namespace. */
43
44/*
45 * cloning flags intersect with CSIGNAL so can be used with unshare and clone3
46 * syscalls only:
47 */
48#define CLONE_NEWTIME 0x00000080 /* New time namespace */
49
50/*
51 * unshare flags share the bit space with clone flags but only apply to the
52 * unshare syscall:
53 */
54#define UNSHARE_EMPTY_MNTNS 0x00100000 /* Unshare an empty mount namespace. */
55
56#ifndef __ASSEMBLY__
57/**
58 * struct clone_args - arguments for the clone3 syscall
59 * @flags: Flags for the new process as listed above.
60 * All flags are valid except for CSIGNAL and
61 * CLONE_DETACHED.
62 * @pidfd: If CLONE_PIDFD is set, a pidfd will be
63 * returned in this argument.
64 * @child_tid: If CLONE_CHILD_SETTID is set, the TID of the
65 * child process will be returned in the child's
66 * memory.
67 * @parent_tid: If CLONE_PARENT_SETTID is set, the TID of
68 * the child process will be returned in the
69 * parent's memory.
70 * @exit_signal: The exit_signal the parent process will be
71 * sent when the child exits.
72 * @stack: Specify the location of the stack for the
73 * child process.
74 * Note, @stack is expected to point to the
75 * lowest address. The stack direction will be
76 * determined by the kernel and set up
77 * appropriately based on @stack_size.
78 * @stack_size: The size of the stack for the child process.
79 * @tls: If CLONE_SETTLS is set, the tls descriptor
80 * is set to tls.
81 * @set_tid: Pointer to an array of type *pid_t. The size
82 * of the array is defined using @set_tid_size.
83 * This array is used to select PIDs/TIDs for
84 * newly created processes. The first element in
85 * this defines the PID in the most nested PID
86 * namespace. Each additional element in the array
87 * defines the PID in the parent PID namespace of
88 * the original PID namespace. If the array has
89 * less entries than the number of currently
90 * nested PID namespaces only the PIDs in the
91 * corresponding namespaces are set.
92 * @set_tid_size: This defines the size of the array referenced
93 * in @set_tid. This cannot be larger than the
94 * kernel's limit of nested PID namespaces.
95 * @cgroup: If CLONE_INTO_CGROUP is specified set this to
96 * a file descriptor for the cgroup.
97 *
98 * The structure is versioned by size and thus extensible.
99 * New struct members must go at the end of the struct and
100 * must be properly 64bit aligned.
101 */
102struct clone_args {
103 __aligned_u64 flags;
104 __aligned_u64 pidfd;
105 __aligned_u64 child_tid;
106 __aligned_u64 parent_tid;
107 __aligned_u64 exit_signal;
108 __aligned_u64 stack;
109 __aligned_u64 stack_size;
110 __aligned_u64 tls;
111 __aligned_u64 set_tid;
112 __aligned_u64 set_tid_size;
113 __aligned_u64 cgroup;
114};
115#endif
116
117#define CLONE_ARGS_SIZE_VER0 64 /* sizeof first published struct */
118#define CLONE_ARGS_SIZE_VER1 80 /* sizeof second published struct */
119#define CLONE_ARGS_SIZE_VER2 88 /* sizeof third published struct */
120
121/*
122 * Scheduling policies
123 */
124#define SCHED_NORMAL 0
125#define SCHED_FIFO 1
126#define SCHED_RR 2
127#define SCHED_BATCH 3
128/* SCHED_ISO: reserved but not implemented yet */
129#define SCHED_IDLE 5
130#define SCHED_DEADLINE 6
131#define SCHED_EXT 7
132
133/* Can be ORed in to make sure the process is reverted back to SCHED_NORMAL on fork */
134#define SCHED_RESET_ON_FORK 0x40000000
135
136/*
137 * For the sched_{set,get}attr() calls
138 */
139#define SCHED_FLAG_RESET_ON_FORK 0x01
140#define SCHED_FLAG_RECLAIM 0x02
141#define SCHED_FLAG_DL_OVERRUN 0x04
142#define SCHED_FLAG_KEEP_POLICY 0x08
143#define SCHED_FLAG_KEEP_PARAMS 0x10
144#define SCHED_FLAG_UTIL_CLAMP_MIN 0x20
145#define SCHED_FLAG_UTIL_CLAMP_MAX 0x40
146
147#define SCHED_FLAG_KEEP_ALL (SCHED_FLAG_KEEP_POLICY | \
148 SCHED_FLAG_KEEP_PARAMS)
149
150#define SCHED_FLAG_UTIL_CLAMP (SCHED_FLAG_UTIL_CLAMP_MIN | \
151 SCHED_FLAG_UTIL_CLAMP_MAX)
152
153#define SCHED_FLAG_ALL (SCHED_FLAG_RESET_ON_FORK | \
154 SCHED_FLAG_RECLAIM | \
155 SCHED_FLAG_DL_OVERRUN | \
156 SCHED_FLAG_KEEP_ALL | \
157 SCHED_FLAG_UTIL_CLAMP)
158
159/* Only for sched_getattr() own flag param, if task is SCHED_DEADLINE */
160#define SCHED_GETATTR_FLAG_DL_DYNAMIC 0x01
161
162#endif /* _LINUX_SCHED_H */