posix/sched.h

   1 /* Definitions for POSIX 1003.1b-1993 (aka POSIX.4) scheduling interface.
   2    Copyright (C) 1996-2020 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 _SCHED_H
  20 #define _SCHED_H        1
  21
  22 #include <features.h>
  23
  24 /* Get type definitions.  */
  25 #include <bits/types.h>
  26
  27 #define __need_size_t
  28 #define __need_NULL
  29 #include <stddef.h>
  30
  31 #include <bits/types/time_t.h>
  32 #include <bits/types/struct_timespec.h>
  33 #ifndef __USE_XOPEN2K
  34 # include <time.h>
  35 #endif
  36
  37 #ifndef __pid_t_defined
  38 typedef __pid_t pid_t;
  39 # define __pid_t_defined
  40 #endif
  41
  42 /* Get system specific constant and data structure definitions.  */
  43 #include <bits/sched.h>
  44 #include <bits/cpu-set.h>
  45
  46 /* Backward compatibility.  */
  47 #define sched_priority    sched_priority
  48 #define __sched_priority  sched_priority
  49
  50
  51 __BEGIN_DECLS
  52
  53 /* Set scheduling parameters for a process.  */
  54 extern int sched_setparam (__pid_t __pid, const struct sched_param *__param)
  55      __THROW;
  56
  57 /* Retrieve scheduling parameters for a particular process.  */
  58 extern int sched_getparam (__pid_t __pid, struct sched_param *__param) __THROW;
  59
  60 /* Set scheduling algorithm and/or parameters for a process.  */
  61 extern int sched_setscheduler (__pid_t __pid, int __policy,
  62                                const struct sched_param *__param) __THROW;
  63
  64 /* Retrieve scheduling algorithm for a particular purpose.  */
  65 extern int sched_getscheduler (__pid_t __pid) __THROW;
  66
  67 /* Yield the processor.  */
  68 extern int sched_yield (void) __THROW;
  69
  70 /* Get maximum priority value for a scheduler.  */
  71 extern int sched_get_priority_max (int __algorithm) __THROW;
  72
  73 /* Get minimum priority value for a scheduler.  */
  74 extern int sched_get_priority_min (int __algorithm) __THROW;
  75
  76 /* Get the SCHED_RR interval for the named process.  */
  77 extern int sched_rr_get_interval (__pid_t __pid, struct timespec *__t) __THROW;
  78
  79
  80 #ifdef __USE_GNU
  81 /* Access macros for `cpu_set'.  */
  82 # define CPU_SETSIZE __CPU_SETSIZE
  83 # define CPU_SET(cpu, cpusetp)   __CPU_SET_S (cpu, sizeof (cpu_set_t), cpusetp)
  84 # define CPU_CLR(cpu, cpusetp)   __CPU_CLR_S (cpu, sizeof (cpu_set_t), cpusetp)
  85 # define CPU_ISSET(cpu, cpusetp) __CPU_ISSET_S (cpu, sizeof (cpu_set_t), \
  86                                                 cpusetp)
  87 # define CPU_ZERO(cpusetp)       __CPU_ZERO_S (sizeof (cpu_set_t), cpusetp)
  88 # define CPU_COUNT(cpusetp)      __CPU_COUNT_S (sizeof (cpu_set_t), cpusetp)
  89
  90 # define CPU_SET_S(cpu, setsize, cpusetp)   __CPU_SET_S (cpu, setsize, cpusetp)
  91 # define CPU_CLR_S(cpu, setsize, cpusetp)   __CPU_CLR_S (cpu, setsize, cpusetp)
  92 # define CPU_ISSET_S(cpu, setsize, cpusetp) __CPU_ISSET_S (cpu, setsize, \
  93                                                            cpusetp)
  94 # define CPU_ZERO_S(setsize, cpusetp)       __CPU_ZERO_S (setsize, cpusetp)
  95 # define CPU_COUNT_S(setsize, cpusetp)      __CPU_COUNT_S (setsize, cpusetp)
  96
  97 # define CPU_EQUAL(cpusetp1, cpusetp2) \
  98   __CPU_EQUAL_S (sizeof (cpu_set_t), cpusetp1, cpusetp2)
  99 # define CPU_EQUAL_S(setsize, cpusetp1, cpusetp2) \
 100   __CPU_EQUAL_S (setsize, cpusetp1, cpusetp2)
 101
 102 # define CPU_AND(destset, srcset1, srcset2) \
 103   __CPU_OP_S (sizeof (cpu_set_t), destset, srcset1, srcset2, &)
 104 # define CPU_OR(destset, srcset1, srcset2) \
 105   __CPU_OP_S (sizeof (cpu_set_t), destset, srcset1, srcset2, |)
 106 # define CPU_XOR(destset, srcset1, srcset2) \
 107   __CPU_OP_S (sizeof (cpu_set_t), destset, srcset1, srcset2, ^)
 108 # define CPU_AND_S(setsize, destset, srcset1, srcset2) \
 109   __CPU_OP_S (setsize, destset, srcset1, srcset2, &)
 110 # define CPU_OR_S(setsize, destset, srcset1, srcset2) \
 111   __CPU_OP_S (setsize, destset, srcset1, srcset2, |)
 112 # define CPU_XOR_S(setsize, destset, srcset1, srcset2) \
 113   __CPU_OP_S (setsize, destset, srcset1, srcset2, ^)
 114
 115 # define CPU_ALLOC_SIZE(count) __CPU_ALLOC_SIZE (count)
 116 # define CPU_ALLOC(count) __CPU_ALLOC (count)
 117 # define CPU_FREE(cpuset) __CPU_FREE (cpuset)
 118
 119
 120 /* Set the CPU affinity for a task */
 121 extern int sched_setaffinity (__pid_t __pid, size_t __cpusetsize,
 122                               const cpu_set_t *__cpuset) __THROW;
 123
 124 /* Get the CPU affinity for a task */
 125 extern int sched_getaffinity (__pid_t __pid, size_t __cpusetsize,
 126                               cpu_set_t *__cpuset) __THROW;
 127 #endif
 128
 129 __END_DECLS
 130
 131 #endif /* sched.h */