xref: /linux/tools/perf/trace/beauty/include/uapi/linux/sched.h (revision ab5fce87a778cb780a05984a2ca448f2b41aafbf)
1 /* SPDX-License-Identifier: GPL-2.0 WITH Linux-syscall-note */
2 #ifndef _UAPI_LINUX_SCHED_H
3 #define _UAPI_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  */
102 struct 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 /* _UAPI_LINUX_SCHED_H */
163