include/uapi/linux/sched.h

   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 0x100000000ULL /* Clear any signal handler and reset to SIG_DFL. */
  38 #define CLONE_INTO_CGROUP 0x200000000ULL /* Clone into a specific cgroup given the right permissions. */
  39
  40 /*
  41  * cloning flags intersect with CSIGNAL so can be used with unshare and clone3
  42  * syscalls only:
  43  */
  44 #define CLONE_NEWTIME   0x00000080      /* New time namespace */
  45
  46 #ifndef __ASSEMBLY__
  47 /**
  48  * struct clone_args - arguments for the clone3 syscall
  49  * @flags:        Flags for the new process as listed above.
  50  *                All flags are valid except for CSIGNAL and
  51  *                CLONE_DETACHED.
  52  * @pidfd:        If CLONE_PIDFD is set, a pidfd will be
  53  *                returned in this argument.
  54  * @child_tid:    If CLONE_CHILD_SETTID is set, the TID of the
  55  *                child process will be returned in the child's
  56  *                memory.
  57  * @parent_tid:   If CLONE_PARENT_SETTID is set, the TID of
  58  *                the child process will be returned in the
  59  *                parent's memory.
  60  * @exit_signal:  The exit_signal the parent process will be
  61  *                sent when the child exits.
  62  * @stack:        Specify the location of the stack for the
  63  *                child process.
  64  *                Note, @stack is expected to point to the
  65  *                lowest address. The stack direction will be
  66  *                determined by the kernel and set up
  67  *                appropriately based on @stack_size.
  68  * @stack_size:   The size of the stack for the child process.
  69  * @tls:          If CLONE_SETTLS is set, the tls descriptor
  70  *                is set to tls.
  71  * @set_tid:      Pointer to an array of type *pid_t. The size
  72  *                of the array is defined using @set_tid_size.
  73  *                This array is used to select PIDs/TIDs for
  74  *                newly created processes. The first element in
  75  *                this defines the PID in the most nested PID
  76  *                namespace. Each additional element in the array
  77  *                defines the PID in the parent PID namespace of
  78  *                the original PID namespace. If the array has
  79  *                less entries than the number of currently
  80  *                nested PID namespaces only the PIDs in the
  81  *                corresponding namespaces are set.
  82  * @set_tid_size: This defines the size of the array referenced
  83  *                in @set_tid. This cannot be larger than the
  84  *                kernel's limit of nested PID namespaces.
  85  * @cgroup:       If CLONE_INTO_CGROUP is specified set this to
  86  *                a file descriptor for the cgroup.
  87  *
  88  * The structure is versioned by size and thus extensible.
  89  * New struct members must go at the end of the struct and
  90  * must be properly 64bit aligned.
  91  */
  92 struct clone_args {
  93         __aligned_u64 flags;
  94         __aligned_u64 pidfd;
  95         __aligned_u64 child_tid;
  96         __aligned_u64 parent_tid;
  97         __aligned_u64 exit_signal;
  98         __aligned_u64 stack;
  99         __aligned_u64 stack_size;
 100         __aligned_u64 tls;
 101         __aligned_u64 set_tid;
 102         __aligned_u64 set_tid_size;
 103         __aligned_u64 cgroup;
 104 };
 105 #endif
 106
 107 #define CLONE_ARGS_SIZE_VER0 64 /* sizeof first published struct */
 108 #define CLONE_ARGS_SIZE_VER1 80 /* sizeof second published struct */
 109 #define CLONE_ARGS_SIZE_VER2 88 /* sizeof third published struct */
 110
 111 /*
 112  * Scheduling policies
 113  */
 114 #define SCHED_NORMAL            0
 115 #define SCHED_FIFO              1
 116 #define SCHED_RR                2
 117 #define SCHED_BATCH             3
 118 /* SCHED_ISO: reserved but not implemented yet */
 119 #define SCHED_IDLE              5
 120 #define SCHED_DEADLINE          6
 121
 122 /* Can be ORed in to make sure the process is reverted back to SCHED_NORMAL on fork */
 123 #define SCHED_RESET_ON_FORK     0x40000000
 124
 125 /*
 126  * For the sched_{set,get}attr() calls
 127  */
 128 #define SCHED_FLAG_RESET_ON_FORK        0x01
 129 #define SCHED_FLAG_RECLAIM              0x02
 130 #define SCHED_FLAG_DL_OVERRUN           0x04
 131 #define SCHED_FLAG_KEEP_POLICY          0x08
 132 #define SCHED_FLAG_KEEP_PARAMS          0x10
 133 #define SCHED_FLAG_UTIL_CLAMP_MIN       0x20
 134 #define SCHED_FLAG_UTIL_CLAMP_MAX       0x40
 135
 136 #define SCHED_FLAG_KEEP_ALL     (SCHED_FLAG_KEEP_POLICY | \
 137                                  SCHED_FLAG_KEEP_PARAMS)
 138
 139 #define SCHED_FLAG_UTIL_CLAMP   (SCHED_FLAG_UTIL_CLAMP_MIN | \
 140                                  SCHED_FLAG_UTIL_CLAMP_MAX)
 141
 142 #define SCHED_FLAG_ALL  (SCHED_FLAG_RESET_ON_FORK       | \
 143                          SCHED_FLAG_RECLAIM             | \
 144                          SCHED_FLAG_DL_OVERRUN          | \
 145                          SCHED_FLAG_KEEP_ALL            | \
 146                          SCHED_FLAG_UTIL_CLAMP)
 147
 148 #endif /* _UAPI_LINUX_SCHED_H */