sched.h 43 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394959697989910010110210310410510610710810911011111211311411511611711811912012112212312412512612712812913013113213313413513613713813914014114214314414514614714814915015115215315415515615715815916016116216316416516616716816917017117217317417517617717817918018118218318418518618718818919019119219319419519619719819920020120220320420520620720820921021121221321421521621721821922022122222322422522622722822923023123223323423523623723823924024124224324424524624724824925025125225325425525625725825926026126226326426526626726826927027127227327427527627727827928028128228328428528628728828929029129229329429529629729829930030130230330430530630730830931031131231331431531631731831932032132232332432532632732832933033133233333433533633733833934034134234334434534634734834935035135235335435535635735835936036136236336436536636736836937037137237337437537637737837938038138238338438538638738838939039139239339439539639739839940040140240340440540640740840941041141241341441541641741841942042142242342442542642742842943043143243343443543643743843944044144244344444544644744844945045145245345445545645745845946046146246346446546646746846947047147247347447547647747847948048148248348448548648748848949049149249349449549649749849950050150250350450550650750850951051151251351451551651751851952052152252352452552652752852953053153253353453553653753853954054154254354454554654754854955055155255355455555655755855956056156256356456556656756856957057157257357457557657757857958058158258358458558658758858959059159259359459559659759859960060160260360460560660760860961061161261361461561661761861962062162262362462562662762862963063163263363463563663763863964064164264364464564664764864965065165265365465565665765865966066166266366466566666766866967067167267367467567667767867968068168268368468568668768868969069169269369469569669769869970070170270370470570670770870971071171271371471571671771871972072172272372472572672772872973073173273373473573673773873974074174274374474574674774874975075175275375475575675775875976076176276376476576676776876977077177277377477577677777877978078178278378478578678778878979079179279379479579679779879980080180280380480580680780880981081181281381481581681781881982082182282382482582682782882983083183283383483583683783883984084184284384484584684784884985085185285385485585685785885986086186286386486586686786886987087187287387487587687787887988088188288388488588688788888989089189289389489589689789889990090190290390490590690790890991091191291391491591691791891992092192292392492592692792892993093193293393493593693793893994094194294394494594694794894995095195295395495595695795895996096196296396496596696796896997097197297397497597697797897998098198298398498598698798898999099199299399499599699799899910001001100210031004100510061007100810091010101110121013101410151016101710181019102010211022102310241025102610271028102910301031103210331034103510361037103810391040104110421043104410451046104710481049105010511052105310541055105610571058105910601061106210631064106510661067106810691070107110721073107410751076107710781079108010811082108310841085108610871088108910901091109210931094109510961097109810991100110111021103110411051106110711081109111011111112111311141115111611171118111911201121112211231124112511261127112811291130113111321133113411351136113711381139114011411142114311441145114611471148114911501151115211531154115511561157115811591160116111621163116411651166116711681169117011711172117311741175117611771178117911801181118211831184118511861187118811891190119111921193119411951196119711981199120012011202120312041205120612071208120912101211121212131214121512161217121812191220122112221223122412251226122712281229123012311232123312341235123612371238123912401241124212431244124512461247124812491250125112521253125412551256125712581259126012611262126312641265126612671268126912701271127212731274127512761277127812791280128112821283128412851286128712881289129012911292129312941295129612971298129913001301130213031304130513061307130813091310131113121313131413151316131713181319132013211322132313241325132613271328132913301331133213331334133513361337133813391340134113421343134413451346134713481349135013511352135313541355135613571358135913601361136213631364136513661367136813691370137113721373137413751376137713781379138013811382138313841385138613871388138913901391139213931394139513961397139813991400140114021403140414051406140714081409141014111412141314141415141614171418141914201421142214231424142514261427142814291430143114321433143414351436143714381439144014411442144314441445144614471448144914501451145214531454145514561457145814591460146114621463146414651466146714681469147014711472147314741475147614771478147914801481148214831484148514861487148814891490149114921493149414951496149714981499150015011502150315041505150615071508150915101511151215131514151515161517151815191520152115221523152415251526152715281529153015311532153315341535153615371538153915401541154215431544154515461547154815491550155115521553155415551556155715581559156015611562156315641565156615671568156915701571157215731574157515761577157815791580158115821583158415851586158715881589159015911592
  1. #ifndef _LINUX_SCHED_H
  2. #define _LINUX_SCHED_H
  3. /*
  4. * Define 'struct task_struct' and provide the main scheduler
  5. * APIs (schedule(), wakeup variants, etc.)
  6. */
  7. #include <uapi/linux/sched.h>
  8. #include <asm/current.h>
  9. #include <linux/pid.h>
  10. #include <linux/sem.h>
  11. #include <linux/shm.h>
  12. #include <linux/kcov.h>
  13. #include <linux/mutex.h>
  14. #include <linux/plist.h>
  15. #include <linux/hrtimer.h>
  16. #include <linux/seccomp.h>
  17. #include <linux/nodemask.h>
  18. #include <linux/rcupdate.h>
  19. #include <linux/resource.h>
  20. #include <linux/latencytop.h>
  21. #include <linux/sched/prio.h>
  22. #include <linux/signal_types.h>
  23. #include <linux/mm_types_task.h>
  24. #include <linux/task_io_accounting.h>
  25. /* task_struct member predeclarations (sorted alphabetically): */
  26. struct audit_context;
  27. struct backing_dev_info;
  28. struct bio_list;
  29. struct blk_plug;
  30. struct cfs_rq;
  31. struct fs_struct;
  32. struct futex_pi_state;
  33. struct io_context;
  34. struct mempolicy;
  35. struct nameidata;
  36. struct nsproxy;
  37. struct perf_event_context;
  38. struct pid_namespace;
  39. struct pipe_inode_info;
  40. struct rcu_node;
  41. struct reclaim_state;
  42. struct robust_list_head;
  43. struct sched_attr;
  44. struct sched_param;
  45. struct seq_file;
  46. struct sighand_struct;
  47. struct signal_struct;
  48. struct task_delay_info;
  49. struct task_group;
  50. /*
  51. * Task state bitmask. NOTE! These bits are also
  52. * encoded in fs/proc/array.c: get_task_state().
  53. *
  54. * We have two separate sets of flags: task->state
  55. * is about runnability, while task->exit_state are
  56. * about the task exiting. Confusing, but this way
  57. * modifying one set can't modify the other one by
  58. * mistake.
  59. */
  60. /* Used in tsk->state: */
  61. #define TASK_RUNNING 0
  62. #define TASK_INTERRUPTIBLE 1
  63. #define TASK_UNINTERRUPTIBLE 2
  64. #define __TASK_STOPPED 4
  65. #define __TASK_TRACED 8
  66. /* Used in tsk->exit_state: */
  67. #define EXIT_DEAD 16
  68. #define EXIT_ZOMBIE 32
  69. #define EXIT_TRACE (EXIT_ZOMBIE | EXIT_DEAD)
  70. /* Used in tsk->state again: */
  71. #define TASK_DEAD 64
  72. #define TASK_WAKEKILL 128
  73. #define TASK_WAKING 256
  74. #define TASK_PARKED 512
  75. #define TASK_NOLOAD 1024
  76. #define TASK_NEW 2048
  77. #define TASK_STATE_MAX 4096
  78. #define TASK_STATE_TO_CHAR_STR "RSDTtXZxKWPNn"
  79. /* Convenience macros for the sake of set_current_state: */
  80. #define TASK_KILLABLE (TASK_WAKEKILL | TASK_UNINTERRUPTIBLE)
  81. #define TASK_STOPPED (TASK_WAKEKILL | __TASK_STOPPED)
  82. #define TASK_TRACED (TASK_WAKEKILL | __TASK_TRACED)
  83. #define TASK_IDLE (TASK_UNINTERRUPTIBLE | TASK_NOLOAD)
  84. /* Convenience macros for the sake of wake_up(): */
  85. #define TASK_NORMAL (TASK_INTERRUPTIBLE | TASK_UNINTERRUPTIBLE)
  86. #define TASK_ALL (TASK_NORMAL | __TASK_STOPPED | __TASK_TRACED)
  87. /* get_task_state(): */
  88. #define TASK_REPORT (TASK_RUNNING | TASK_INTERRUPTIBLE | \
  89. TASK_UNINTERRUPTIBLE | __TASK_STOPPED | \
  90. __TASK_TRACED | EXIT_ZOMBIE | EXIT_DEAD)
  91. #define task_is_traced(task) ((task->state & __TASK_TRACED) != 0)
  92. #define task_is_stopped(task) ((task->state & __TASK_STOPPED) != 0)
  93. #define task_is_stopped_or_traced(task) ((task->state & (__TASK_STOPPED | __TASK_TRACED)) != 0)
  94. #define task_contributes_to_load(task) ((task->state & TASK_UNINTERRUPTIBLE) != 0 && \
  95. (task->flags & PF_FROZEN) == 0 && \
  96. (task->state & TASK_NOLOAD) == 0)
  97. #ifdef CONFIG_DEBUG_ATOMIC_SLEEP
  98. #define __set_current_state(state_value) \
  99. do { \
  100. current->task_state_change = _THIS_IP_; \
  101. current->state = (state_value); \
  102. } while (0)
  103. #define set_current_state(state_value) \
  104. do { \
  105. current->task_state_change = _THIS_IP_; \
  106. smp_store_mb(current->state, (state_value)); \
  107. } while (0)
  108. #else
  109. /*
  110. * set_current_state() includes a barrier so that the write of current->state
  111. * is correctly serialised wrt the caller's subsequent test of whether to
  112. * actually sleep:
  113. *
  114. * for (;;) {
  115. * set_current_state(TASK_UNINTERRUPTIBLE);
  116. * if (!need_sleep)
  117. * break;
  118. *
  119. * schedule();
  120. * }
  121. * __set_current_state(TASK_RUNNING);
  122. *
  123. * If the caller does not need such serialisation (because, for instance, the
  124. * condition test and condition change and wakeup are under the same lock) then
  125. * use __set_current_state().
  126. *
  127. * The above is typically ordered against the wakeup, which does:
  128. *
  129. * need_sleep = false;
  130. * wake_up_state(p, TASK_UNINTERRUPTIBLE);
  131. *
  132. * Where wake_up_state() (and all other wakeup primitives) imply enough
  133. * barriers to order the store of the variable against wakeup.
  134. *
  135. * Wakeup will do: if (@state & p->state) p->state = TASK_RUNNING, that is,
  136. * once it observes the TASK_UNINTERRUPTIBLE store the waking CPU can issue a
  137. * TASK_RUNNING store which can collide with __set_current_state(TASK_RUNNING).
  138. *
  139. * This is obviously fine, since they both store the exact same value.
  140. *
  141. * Also see the comments of try_to_wake_up().
  142. */
  143. #define __set_current_state(state_value) do { current->state = (state_value); } while (0)
  144. #define set_current_state(state_value) smp_store_mb(current->state, (state_value))
  145. #endif
  146. /* Task command name length: */
  147. #define TASK_COMM_LEN 16
  148. extern cpumask_var_t cpu_isolated_map;
  149. extern void scheduler_tick(void);
  150. #define MAX_SCHEDULE_TIMEOUT LONG_MAX
  151. extern long schedule_timeout(long timeout);
  152. extern long schedule_timeout_interruptible(long timeout);
  153. extern long schedule_timeout_killable(long timeout);
  154. extern long schedule_timeout_uninterruptible(long timeout);
  155. extern long schedule_timeout_idle(long timeout);
  156. asmlinkage void schedule(void);
  157. extern void schedule_preempt_disabled(void);
  158. extern int __must_check io_schedule_prepare(void);
  159. extern void io_schedule_finish(int token);
  160. extern long io_schedule_timeout(long timeout);
  161. extern void io_schedule(void);
  162. /**
  163. * struct prev_cputime - snapshot of system and user cputime
  164. * @utime: time spent in user mode
  165. * @stime: time spent in system mode
  166. * @lock: protects the above two fields
  167. *
  168. * Stores previous user/system time values such that we can guarantee
  169. * monotonicity.
  170. */
  171. struct prev_cputime {
  172. #ifndef CONFIG_VIRT_CPU_ACCOUNTING_NATIVE
  173. u64 utime;
  174. u64 stime;
  175. raw_spinlock_t lock;
  176. #endif
  177. };
  178. /**
  179. * struct task_cputime - collected CPU time counts
  180. * @utime: time spent in user mode, in nanoseconds
  181. * @stime: time spent in kernel mode, in nanoseconds
  182. * @sum_exec_runtime: total time spent on the CPU, in nanoseconds
  183. *
  184. * This structure groups together three kinds of CPU time that are tracked for
  185. * threads and thread groups. Most things considering CPU time want to group
  186. * these counts together and treat all three of them in parallel.
  187. */
  188. struct task_cputime {
  189. u64 utime;
  190. u64 stime;
  191. unsigned long long sum_exec_runtime;
  192. };
  193. /* Alternate field names when used on cache expirations: */
  194. #define virt_exp utime
  195. #define prof_exp stime
  196. #define sched_exp sum_exec_runtime
  197. struct sched_info {
  198. #ifdef CONFIG_SCHED_INFO
  199. /* Cumulative counters: */
  200. /* # of times we have run on this CPU: */
  201. unsigned long pcount;
  202. /* Time spent waiting on a runqueue: */
  203. unsigned long long run_delay;
  204. /* Timestamps: */
  205. /* When did we last run on a CPU? */
  206. unsigned long long last_arrival;
  207. /* When were we last queued to run? */
  208. unsigned long long last_queued;
  209. #endif /* CONFIG_SCHED_INFO */
  210. };
  211. /*
  212. * Integer metrics need fixed point arithmetic, e.g., sched/fair
  213. * has a few: load, load_avg, util_avg, freq, and capacity.
  214. *
  215. * We define a basic fixed point arithmetic range, and then formalize
  216. * all these metrics based on that basic range.
  217. */
  218. # define SCHED_FIXEDPOINT_SHIFT 10
  219. # define SCHED_FIXEDPOINT_SCALE (1L << SCHED_FIXEDPOINT_SHIFT)
  220. struct load_weight {
  221. unsigned long weight;
  222. u32 inv_weight;
  223. };
  224. /*
  225. * The load_avg/util_avg accumulates an infinite geometric series
  226. * (see __update_load_avg() in kernel/sched/fair.c).
  227. *
  228. * [load_avg definition]
  229. *
  230. * load_avg = runnable% * scale_load_down(load)
  231. *
  232. * where runnable% is the time ratio that a sched_entity is runnable.
  233. * For cfs_rq, it is the aggregated load_avg of all runnable and
  234. * blocked sched_entities.
  235. *
  236. * load_avg may also take frequency scaling into account:
  237. *
  238. * load_avg = runnable% * scale_load_down(load) * freq%
  239. *
  240. * where freq% is the CPU frequency normalized to the highest frequency.
  241. *
  242. * [util_avg definition]
  243. *
  244. * util_avg = running% * SCHED_CAPACITY_SCALE
  245. *
  246. * where running% is the time ratio that a sched_entity is running on
  247. * a CPU. For cfs_rq, it is the aggregated util_avg of all runnable
  248. * and blocked sched_entities.
  249. *
  250. * util_avg may also factor frequency scaling and CPU capacity scaling:
  251. *
  252. * util_avg = running% * SCHED_CAPACITY_SCALE * freq% * capacity%
  253. *
  254. * where freq% is the same as above, and capacity% is the CPU capacity
  255. * normalized to the greatest capacity (due to uarch differences, etc).
  256. *
  257. * N.B., the above ratios (runnable%, running%, freq%, and capacity%)
  258. * themselves are in the range of [0, 1]. To do fixed point arithmetics,
  259. * we therefore scale them to as large a range as necessary. This is for
  260. * example reflected by util_avg's SCHED_CAPACITY_SCALE.
  261. *
  262. * [Overflow issue]
  263. *
  264. * The 64-bit load_sum can have 4353082796 (=2^64/47742/88761) entities
  265. * with the highest load (=88761), always runnable on a single cfs_rq,
  266. * and should not overflow as the number already hits PID_MAX_LIMIT.
  267. *
  268. * For all other cases (including 32-bit kernels), struct load_weight's
  269. * weight will overflow first before we do, because:
  270. *
  271. * Max(load_avg) <= Max(load.weight)
  272. *
  273. * Then it is the load_weight's responsibility to consider overflow
  274. * issues.
  275. */
  276. struct sched_avg {
  277. u64 last_update_time;
  278. u64 load_sum;
  279. u32 util_sum;
  280. u32 period_contrib;
  281. unsigned long load_avg;
  282. unsigned long util_avg;
  283. };
  284. struct sched_statistics {
  285. #ifdef CONFIG_SCHEDSTATS
  286. u64 wait_start;
  287. u64 wait_max;
  288. u64 wait_count;
  289. u64 wait_sum;
  290. u64 iowait_count;
  291. u64 iowait_sum;
  292. u64 sleep_start;
  293. u64 sleep_max;
  294. s64 sum_sleep_runtime;
  295. u64 block_start;
  296. u64 block_max;
  297. u64 exec_max;
  298. u64 slice_max;
  299. u64 nr_migrations_cold;
  300. u64 nr_failed_migrations_affine;
  301. u64 nr_failed_migrations_running;
  302. u64 nr_failed_migrations_hot;
  303. u64 nr_forced_migrations;
  304. u64 nr_wakeups;
  305. u64 nr_wakeups_sync;
  306. u64 nr_wakeups_migrate;
  307. u64 nr_wakeups_local;
  308. u64 nr_wakeups_remote;
  309. u64 nr_wakeups_affine;
  310. u64 nr_wakeups_affine_attempts;
  311. u64 nr_wakeups_passive;
  312. u64 nr_wakeups_idle;
  313. #endif
  314. };
  315. struct sched_entity {
  316. /* For load-balancing: */
  317. struct load_weight load;
  318. struct rb_node run_node;
  319. struct list_head group_node;
  320. unsigned int on_rq;
  321. u64 exec_start;
  322. u64 sum_exec_runtime;
  323. u64 vruntime;
  324. u64 prev_sum_exec_runtime;
  325. u64 nr_migrations;
  326. struct sched_statistics statistics;
  327. #ifdef CONFIG_FAIR_GROUP_SCHED
  328. int depth;
  329. struct sched_entity *parent;
  330. /* rq on which this entity is (to be) queued: */
  331. struct cfs_rq *cfs_rq;
  332. /* rq "owned" by this entity/group: */
  333. struct cfs_rq *my_q;
  334. #endif
  335. #ifdef CONFIG_SMP
  336. /*
  337. * Per entity load average tracking.
  338. *
  339. * Put into separate cache line so it does not
  340. * collide with read-mostly values above.
  341. */
  342. struct sched_avg avg ____cacheline_aligned_in_smp;
  343. #endif
  344. };
  345. struct sched_rt_entity {
  346. struct list_head run_list;
  347. unsigned long timeout;
  348. unsigned long watchdog_stamp;
  349. unsigned int time_slice;
  350. unsigned short on_rq;
  351. unsigned short on_list;
  352. struct sched_rt_entity *back;
  353. #ifdef CONFIG_RT_GROUP_SCHED
  354. struct sched_rt_entity *parent;
  355. /* rq on which this entity is (to be) queued: */
  356. struct rt_rq *rt_rq;
  357. /* rq "owned" by this entity/group: */
  358. struct rt_rq *my_q;
  359. #endif
  360. };
  361. struct sched_dl_entity {
  362. struct rb_node rb_node;
  363. /*
  364. * Original scheduling parameters. Copied here from sched_attr
  365. * during sched_setattr(), they will remain the same until
  366. * the next sched_setattr().
  367. */
  368. u64 dl_runtime; /* Maximum runtime for each instance */
  369. u64 dl_deadline; /* Relative deadline of each instance */
  370. u64 dl_period; /* Separation of two instances (period) */
  371. u64 dl_bw; /* dl_runtime / dl_period */
  372. u64 dl_density; /* dl_runtime / dl_deadline */
  373. /*
  374. * Actual scheduling parameters. Initialized with the values above,
  375. * they are continously updated during task execution. Note that
  376. * the remaining runtime could be < 0 in case we are in overrun.
  377. */
  378. s64 runtime; /* Remaining runtime for this instance */
  379. u64 deadline; /* Absolute deadline for this instance */
  380. unsigned int flags; /* Specifying the scheduler behaviour */
  381. /*
  382. * Some bool flags:
  383. *
  384. * @dl_throttled tells if we exhausted the runtime. If so, the
  385. * task has to wait for a replenishment to be performed at the
  386. * next firing of dl_timer.
  387. *
  388. * @dl_boosted tells if we are boosted due to DI. If so we are
  389. * outside bandwidth enforcement mechanism (but only until we
  390. * exit the critical section);
  391. *
  392. * @dl_yielded tells if task gave up the CPU before consuming
  393. * all its available runtime during the last job.
  394. *
  395. * @dl_non_contending tells if the task is inactive while still
  396. * contributing to the active utilization. In other words, it
  397. * indicates if the inactive timer has been armed and its handler
  398. * has not been executed yet. This flag is useful to avoid race
  399. * conditions between the inactive timer handler and the wakeup
  400. * code.
  401. */
  402. int dl_throttled;
  403. int dl_boosted;
  404. int dl_yielded;
  405. int dl_non_contending;
  406. /*
  407. * Bandwidth enforcement timer. Each -deadline task has its
  408. * own bandwidth to be enforced, thus we need one timer per task.
  409. */
  410. struct hrtimer dl_timer;
  411. /*
  412. * Inactive timer, responsible for decreasing the active utilization
  413. * at the "0-lag time". When a -deadline task blocks, it contributes
  414. * to GRUB's active utilization until the "0-lag time", hence a
  415. * timer is needed to decrease the active utilization at the correct
  416. * time.
  417. */
  418. struct hrtimer inactive_timer;
  419. };
  420. union rcu_special {
  421. struct {
  422. u8 blocked;
  423. u8 need_qs;
  424. u8 exp_need_qs;
  425. /* Otherwise the compiler can store garbage here: */
  426. u8 pad;
  427. } b; /* Bits. */
  428. u32 s; /* Set of bits. */
  429. };
  430. enum perf_event_task_context {
  431. perf_invalid_context = -1,
  432. perf_hw_context = 0,
  433. perf_sw_context,
  434. perf_nr_task_contexts,
  435. };
  436. struct wake_q_node {
  437. struct wake_q_node *next;
  438. };
  439. struct task_struct {
  440. #ifdef CONFIG_THREAD_INFO_IN_TASK
  441. /*
  442. * For reasons of header soup (see current_thread_info()), this
  443. * must be the first element of task_struct.
  444. */
  445. struct thread_info thread_info;
  446. #endif
  447. /* -1 unrunnable, 0 runnable, >0 stopped: */
  448. volatile long state;
  449. void *stack;
  450. atomic_t usage;
  451. /* Per task flags (PF_*), defined further below: */
  452. unsigned int flags;
  453. unsigned int ptrace;
  454. #ifdef CONFIG_SMP
  455. struct llist_node wake_entry;
  456. int on_cpu;
  457. #ifdef CONFIG_THREAD_INFO_IN_TASK
  458. /* Current CPU: */
  459. unsigned int cpu;
  460. #endif
  461. unsigned int wakee_flips;
  462. unsigned long wakee_flip_decay_ts;
  463. struct task_struct *last_wakee;
  464. int wake_cpu;
  465. #endif
  466. int on_rq;
  467. int prio;
  468. int static_prio;
  469. int normal_prio;
  470. unsigned int rt_priority;
  471. const struct sched_class *sched_class;
  472. struct sched_entity se;
  473. struct sched_rt_entity rt;
  474. #ifdef CONFIG_CGROUP_SCHED
  475. struct task_group *sched_task_group;
  476. #endif
  477. struct sched_dl_entity dl;
  478. #ifdef CONFIG_PREEMPT_NOTIFIERS
  479. /* List of struct preempt_notifier: */
  480. struct hlist_head preempt_notifiers;
  481. #endif
  482. #ifdef CONFIG_BLK_DEV_IO_TRACE
  483. unsigned int btrace_seq;
  484. #endif
  485. unsigned int policy;
  486. int nr_cpus_allowed;
  487. cpumask_t cpus_allowed;
  488. #ifdef CONFIG_PREEMPT_RCU
  489. int rcu_read_lock_nesting;
  490. union rcu_special rcu_read_unlock_special;
  491. struct list_head rcu_node_entry;
  492. struct rcu_node *rcu_blocked_node;
  493. #endif /* #ifdef CONFIG_PREEMPT_RCU */
  494. #ifdef CONFIG_TASKS_RCU
  495. unsigned long rcu_tasks_nvcsw;
  496. bool rcu_tasks_holdout;
  497. struct list_head rcu_tasks_holdout_list;
  498. int rcu_tasks_idle_cpu;
  499. #endif /* #ifdef CONFIG_TASKS_RCU */
  500. struct sched_info sched_info;
  501. struct list_head tasks;
  502. #ifdef CONFIG_SMP
  503. struct plist_node pushable_tasks;
  504. struct rb_node pushable_dl_tasks;
  505. #endif
  506. struct mm_struct *mm;
  507. struct mm_struct *active_mm;
  508. /* Per-thread vma caching: */
  509. struct vmacache vmacache;
  510. #ifdef SPLIT_RSS_COUNTING
  511. struct task_rss_stat rss_stat;
  512. #endif
  513. int exit_state;
  514. int exit_code;
  515. int exit_signal;
  516. /* The signal sent when the parent dies: */
  517. int pdeath_signal;
  518. /* JOBCTL_*, siglock protected: */
  519. unsigned long jobctl;
  520. /* Used for emulating ABI behavior of previous Linux versions: */
  521. unsigned int personality;
  522. /* Scheduler bits, serialized by scheduler locks: */
  523. unsigned sched_reset_on_fork:1;
  524. unsigned sched_contributes_to_load:1;
  525. unsigned sched_migrated:1;
  526. unsigned sched_remote_wakeup:1;
  527. /* Force alignment to the next boundary: */
  528. unsigned :0;
  529. /* Unserialized, strictly 'current' */
  530. /* Bit to tell LSMs we're in execve(): */
  531. unsigned in_execve:1;
  532. unsigned in_iowait:1;
  533. #ifndef TIF_RESTORE_SIGMASK
  534. unsigned restore_sigmask:1;
  535. #endif
  536. #ifdef CONFIG_MEMCG
  537. unsigned memcg_may_oom:1;
  538. #ifndef CONFIG_SLOB
  539. unsigned memcg_kmem_skip_account:1;
  540. #endif
  541. #endif
  542. #ifdef CONFIG_COMPAT_BRK
  543. unsigned brk_randomized:1;
  544. #endif
  545. #ifdef CONFIG_CGROUPS
  546. /* disallow userland-initiated cgroup migration */
  547. unsigned no_cgroup_migration:1;
  548. #endif
  549. unsigned long atomic_flags; /* Flags requiring atomic access. */
  550. struct restart_block restart_block;
  551. pid_t pid;
  552. pid_t tgid;
  553. #ifdef CONFIG_CC_STACKPROTECTOR
  554. /* Canary value for the -fstack-protector GCC feature: */
  555. unsigned long stack_canary;
  556. #endif
  557. /*
  558. * Pointers to the (original) parent process, youngest child, younger sibling,
  559. * older sibling, respectively. (p->father can be replaced with
  560. * p->real_parent->pid)
  561. */
  562. /* Real parent process: */
  563. struct task_struct __rcu *real_parent;
  564. /* Recipient of SIGCHLD, wait4() reports: */
  565. struct task_struct __rcu *parent;
  566. /*
  567. * Children/sibling form the list of natural children:
  568. */
  569. struct list_head children;
  570. struct list_head sibling;
  571. struct task_struct *group_leader;
  572. /*
  573. * 'ptraced' is the list of tasks this task is using ptrace() on.
  574. *
  575. * This includes both natural children and PTRACE_ATTACH targets.
  576. * 'ptrace_entry' is this task's link on the p->parent->ptraced list.
  577. */
  578. struct list_head ptraced;
  579. struct list_head ptrace_entry;
  580. /* PID/PID hash table linkage. */
  581. struct pid_link pids[PIDTYPE_MAX];
  582. struct list_head thread_group;
  583. struct list_head thread_node;
  584. struct completion *vfork_done;
  585. /* CLONE_CHILD_SETTID: */
  586. int __user *set_child_tid;
  587. /* CLONE_CHILD_CLEARTID: */
  588. int __user *clear_child_tid;
  589. u64 utime;
  590. u64 stime;
  591. #ifdef CONFIG_ARCH_HAS_SCALED_CPUTIME
  592. u64 utimescaled;
  593. u64 stimescaled;
  594. #endif
  595. u64 gtime;
  596. struct prev_cputime prev_cputime;
  597. #ifdef CONFIG_VIRT_CPU_ACCOUNTING_GEN
  598. seqcount_t vtime_seqcount;
  599. unsigned long long vtime_snap;
  600. enum {
  601. /* Task is sleeping or running in a CPU with VTIME inactive: */
  602. VTIME_INACTIVE = 0,
  603. /* Task runs in userspace in a CPU with VTIME active: */
  604. VTIME_USER,
  605. /* Task runs in kernelspace in a CPU with VTIME active: */
  606. VTIME_SYS,
  607. } vtime_snap_whence;
  608. #endif
  609. #ifdef CONFIG_NO_HZ_FULL
  610. atomic_t tick_dep_mask;
  611. #endif
  612. /* Context switch counts: */
  613. unsigned long nvcsw;
  614. unsigned long nivcsw;
  615. /* Monotonic time in nsecs: */
  616. u64 start_time;
  617. /* Boot based time in nsecs: */
  618. u64 real_start_time;
  619. /* MM fault and swap info: this can arguably be seen as either mm-specific or thread-specific: */
  620. unsigned long min_flt;
  621. unsigned long maj_flt;
  622. #ifdef CONFIG_POSIX_TIMERS
  623. struct task_cputime cputime_expires;
  624. struct list_head cpu_timers[3];
  625. #endif
  626. /* Process credentials: */
  627. /* Tracer's credentials at attach: */
  628. const struct cred __rcu *ptracer_cred;
  629. /* Objective and real subjective task credentials (COW): */
  630. const struct cred __rcu *real_cred;
  631. /* Effective (overridable) subjective task credentials (COW): */
  632. const struct cred __rcu *cred;
  633. /*
  634. * executable name, excluding path.
  635. *
  636. * - normally initialized setup_new_exec()
  637. * - access it with [gs]et_task_comm()
  638. * - lock it with task_lock()
  639. */
  640. char comm[TASK_COMM_LEN];
  641. struct nameidata *nameidata;
  642. #ifdef CONFIG_SYSVIPC
  643. struct sysv_sem sysvsem;
  644. struct sysv_shm sysvshm;
  645. #endif
  646. #ifdef CONFIG_DETECT_HUNG_TASK
  647. unsigned long last_switch_count;
  648. #endif
  649. /* Filesystem information: */
  650. struct fs_struct *fs;
  651. /* Open file information: */
  652. struct files_struct *files;
  653. /* Namespaces: */
  654. struct nsproxy *nsproxy;
  655. /* Signal handlers: */
  656. struct signal_struct *signal;
  657. struct sighand_struct *sighand;
  658. sigset_t blocked;
  659. sigset_t real_blocked;
  660. /* Restored if set_restore_sigmask() was used: */
  661. sigset_t saved_sigmask;
  662. struct sigpending pending;
  663. unsigned long sas_ss_sp;
  664. size_t sas_ss_size;
  665. unsigned int sas_ss_flags;
  666. struct callback_head *task_works;
  667. struct audit_context *audit_context;
  668. #ifdef CONFIG_AUDITSYSCALL
  669. kuid_t loginuid;
  670. unsigned int sessionid;
  671. #endif
  672. struct seccomp seccomp;
  673. /* Thread group tracking: */
  674. u32 parent_exec_id;
  675. u32 self_exec_id;
  676. /* Protection against (de-)allocation: mm, files, fs, tty, keyrings, mems_allowed, mempolicy: */
  677. spinlock_t alloc_lock;
  678. /* Protection of the PI data structures: */
  679. raw_spinlock_t pi_lock;
  680. struct wake_q_node wake_q;
  681. #ifdef CONFIG_RT_MUTEXES
  682. /* PI waiters blocked on a rt_mutex held by this task: */
  683. struct rb_root pi_waiters;
  684. struct rb_node *pi_waiters_leftmost;
  685. /* Updated under owner's pi_lock and rq lock */
  686. struct task_struct *pi_top_task;
  687. /* Deadlock detection and priority inheritance handling: */
  688. struct rt_mutex_waiter *pi_blocked_on;
  689. #endif
  690. #ifdef CONFIG_DEBUG_MUTEXES
  691. /* Mutex deadlock detection: */
  692. struct mutex_waiter *blocked_on;
  693. #endif
  694. #ifdef CONFIG_TRACE_IRQFLAGS
  695. unsigned int irq_events;
  696. unsigned long hardirq_enable_ip;
  697. unsigned long hardirq_disable_ip;
  698. unsigned int hardirq_enable_event;
  699. unsigned int hardirq_disable_event;
  700. int hardirqs_enabled;
  701. int hardirq_context;
  702. unsigned long softirq_disable_ip;
  703. unsigned long softirq_enable_ip;
  704. unsigned int softirq_disable_event;
  705. unsigned int softirq_enable_event;
  706. int softirqs_enabled;
  707. int softirq_context;
  708. #endif
  709. #ifdef CONFIG_LOCKDEP
  710. # define MAX_LOCK_DEPTH 48UL
  711. u64 curr_chain_key;
  712. int lockdep_depth;
  713. unsigned int lockdep_recursion;
  714. struct held_lock held_locks[MAX_LOCK_DEPTH];
  715. gfp_t lockdep_reclaim_gfp;
  716. #endif
  717. #ifdef CONFIG_UBSAN
  718. unsigned int in_ubsan;
  719. #endif
  720. /* Journalling filesystem info: */
  721. void *journal_info;
  722. /* Stacked block device info: */
  723. struct bio_list *bio_list;
  724. #ifdef CONFIG_BLOCK
  725. /* Stack plugging: */
  726. struct blk_plug *plug;
  727. #endif
  728. /* VM state: */
  729. struct reclaim_state *reclaim_state;
  730. struct backing_dev_info *backing_dev_info;
  731. struct io_context *io_context;
  732. /* Ptrace state: */
  733. unsigned long ptrace_message;
  734. siginfo_t *last_siginfo;
  735. struct task_io_accounting ioac;
  736. #ifdef CONFIG_TASK_XACCT
  737. /* Accumulated RSS usage: */
  738. u64 acct_rss_mem1;
  739. /* Accumulated virtual memory usage: */
  740. u64 acct_vm_mem1;
  741. /* stime + utime since last update: */
  742. u64 acct_timexpd;
  743. #endif
  744. #ifdef CONFIG_CPUSETS
  745. /* Protected by ->alloc_lock: */
  746. nodemask_t mems_allowed;
  747. /* Seqence number to catch updates: */
  748. seqcount_t mems_allowed_seq;
  749. int cpuset_mem_spread_rotor;
  750. int cpuset_slab_spread_rotor;
  751. #endif
  752. #ifdef CONFIG_CGROUPS
  753. /* Control Group info protected by css_set_lock: */
  754. struct css_set __rcu *cgroups;
  755. /* cg_list protected by css_set_lock and tsk->alloc_lock: */
  756. struct list_head cg_list;
  757. #endif
  758. #ifdef CONFIG_INTEL_RDT_A
  759. int closid;
  760. #endif
  761. #ifdef CONFIG_FUTEX
  762. struct robust_list_head __user *robust_list;
  763. #ifdef CONFIG_COMPAT
  764. struct compat_robust_list_head __user *compat_robust_list;
  765. #endif
  766. struct list_head pi_state_list;
  767. struct futex_pi_state *pi_state_cache;
  768. #endif
  769. #ifdef CONFIG_PERF_EVENTS
  770. struct perf_event_context *perf_event_ctxp[perf_nr_task_contexts];
  771. struct mutex perf_event_mutex;
  772. struct list_head perf_event_list;
  773. #endif
  774. #ifdef CONFIG_DEBUG_PREEMPT
  775. unsigned long preempt_disable_ip;
  776. #endif
  777. #ifdef CONFIG_NUMA
  778. /* Protected by alloc_lock: */
  779. struct mempolicy *mempolicy;
  780. short il_next;
  781. short pref_node_fork;
  782. #endif
  783. #ifdef CONFIG_NUMA_BALANCING
  784. int numa_scan_seq;
  785. unsigned int numa_scan_period;
  786. unsigned int numa_scan_period_max;
  787. int numa_preferred_nid;
  788. unsigned long numa_migrate_retry;
  789. /* Migration stamp: */
  790. u64 node_stamp;
  791. u64 last_task_numa_placement;
  792. u64 last_sum_exec_runtime;
  793. struct callback_head numa_work;
  794. struct list_head numa_entry;
  795. struct numa_group *numa_group;
  796. /*
  797. * numa_faults is an array split into four regions:
  798. * faults_memory, faults_cpu, faults_memory_buffer, faults_cpu_buffer
  799. * in this precise order.
  800. *
  801. * faults_memory: Exponential decaying average of faults on a per-node
  802. * basis. Scheduling placement decisions are made based on these
  803. * counts. The values remain static for the duration of a PTE scan.
  804. * faults_cpu: Track the nodes the process was running on when a NUMA
  805. * hinting fault was incurred.
  806. * faults_memory_buffer and faults_cpu_buffer: Record faults per node
  807. * during the current scan window. When the scan completes, the counts
  808. * in faults_memory and faults_cpu decay and these values are copied.
  809. */
  810. unsigned long *numa_faults;
  811. unsigned long total_numa_faults;
  812. /*
  813. * numa_faults_locality tracks if faults recorded during the last
  814. * scan window were remote/local or failed to migrate. The task scan
  815. * period is adapted based on the locality of the faults with different
  816. * weights depending on whether they were shared or private faults
  817. */
  818. unsigned long numa_faults_locality[3];
  819. unsigned long numa_pages_migrated;
  820. #endif /* CONFIG_NUMA_BALANCING */
  821. struct tlbflush_unmap_batch tlb_ubc;
  822. struct rcu_head rcu;
  823. /* Cache last used pipe for splice(): */
  824. struct pipe_inode_info *splice_pipe;
  825. struct page_frag task_frag;
  826. #ifdef CONFIG_TASK_DELAY_ACCT
  827. struct task_delay_info *delays;
  828. #endif
  829. #ifdef CONFIG_FAULT_INJECTION
  830. int make_it_fail;
  831. #endif
  832. /*
  833. * When (nr_dirtied >= nr_dirtied_pause), it's time to call
  834. * balance_dirty_pages() for a dirty throttling pause:
  835. */
  836. int nr_dirtied;
  837. int nr_dirtied_pause;
  838. /* Start of a write-and-pause period: */
  839. unsigned long dirty_paused_when;
  840. #ifdef CONFIG_LATENCYTOP
  841. int latency_record_count;
  842. struct latency_record latency_record[LT_SAVECOUNT];
  843. #endif
  844. /*
  845. * Time slack values; these are used to round up poll() and
  846. * select() etc timeout values. These are in nanoseconds.
  847. */
  848. u64 timer_slack_ns;
  849. u64 default_timer_slack_ns;
  850. #ifdef CONFIG_KASAN
  851. unsigned int kasan_depth;
  852. #endif
  853. #ifdef CONFIG_FUNCTION_GRAPH_TRACER
  854. /* Index of current stored address in ret_stack: */
  855. int curr_ret_stack;
  856. /* Stack of return addresses for return function tracing: */
  857. struct ftrace_ret_stack *ret_stack;
  858. /* Timestamp for last schedule: */
  859. unsigned long long ftrace_timestamp;
  860. /*
  861. * Number of functions that haven't been traced
  862. * because of depth overrun:
  863. */
  864. atomic_t trace_overrun;
  865. /* Pause tracing: */
  866. atomic_t tracing_graph_pause;
  867. #endif
  868. #ifdef CONFIG_TRACING
  869. /* State flags for use by tracers: */
  870. unsigned long trace;
  871. /* Bitmask and counter of trace recursion: */
  872. unsigned long trace_recursion;
  873. #endif /* CONFIG_TRACING */
  874. #ifdef CONFIG_KCOV
  875. /* Coverage collection mode enabled for this task (0 if disabled): */
  876. enum kcov_mode kcov_mode;
  877. /* Size of the kcov_area: */
  878. unsigned int kcov_size;
  879. /* Buffer for coverage collection: */
  880. void *kcov_area;
  881. /* KCOV descriptor wired with this task or NULL: */
  882. struct kcov *kcov;
  883. #endif
  884. #ifdef CONFIG_MEMCG
  885. struct mem_cgroup *memcg_in_oom;
  886. gfp_t memcg_oom_gfp_mask;
  887. int memcg_oom_order;
  888. /* Number of pages to reclaim on returning to userland: */
  889. unsigned int memcg_nr_pages_over_high;
  890. #endif
  891. #ifdef CONFIG_UPROBES
  892. struct uprobe_task *utask;
  893. #endif
  894. #if defined(CONFIG_BCACHE) || defined(CONFIG_BCACHE_MODULE)
  895. unsigned int sequential_io;
  896. unsigned int sequential_io_avg;
  897. #endif
  898. #ifdef CONFIG_DEBUG_ATOMIC_SLEEP
  899. unsigned long task_state_change;
  900. #endif
  901. int pagefault_disabled;
  902. #ifdef CONFIG_MMU
  903. struct task_struct *oom_reaper_list;
  904. #endif
  905. #ifdef CONFIG_VMAP_STACK
  906. struct vm_struct *stack_vm_area;
  907. #endif
  908. #ifdef CONFIG_THREAD_INFO_IN_TASK
  909. /* A live task holds one reference: */
  910. atomic_t stack_refcount;
  911. #endif
  912. #ifdef CONFIG_LIVEPATCH
  913. int patch_state;
  914. #endif
  915. #ifdef CONFIG_SECURITY
  916. /* Used by LSM modules for access restriction: */
  917. void *security;
  918. #endif
  919. /* CPU-specific state of this task: */
  920. struct thread_struct thread;
  921. /*
  922. * WARNING: on x86, 'thread_struct' contains a variable-sized
  923. * structure. It *MUST* be at the end of 'task_struct'.
  924. *
  925. * Do not put anything below here!
  926. */
  927. };
  928. static inline struct pid *task_pid(struct task_struct *task)
  929. {
  930. return task->pids[PIDTYPE_PID].pid;
  931. }
  932. static inline struct pid *task_tgid(struct task_struct *task)
  933. {
  934. return task->group_leader->pids[PIDTYPE_PID].pid;
  935. }
  936. /*
  937. * Without tasklist or RCU lock it is not safe to dereference
  938. * the result of task_pgrp/task_session even if task == current,
  939. * we can race with another thread doing sys_setsid/sys_setpgid.
  940. */
  941. static inline struct pid *task_pgrp(struct task_struct *task)
  942. {
  943. return task->group_leader->pids[PIDTYPE_PGID].pid;
  944. }
  945. static inline struct pid *task_session(struct task_struct *task)
  946. {
  947. return task->group_leader->pids[PIDTYPE_SID].pid;
  948. }
  949. /*
  950. * the helpers to get the task's different pids as they are seen
  951. * from various namespaces
  952. *
  953. * task_xid_nr() : global id, i.e. the id seen from the init namespace;
  954. * task_xid_vnr() : virtual id, i.e. the id seen from the pid namespace of
  955. * current.
  956. * task_xid_nr_ns() : id seen from the ns specified;
  957. *
  958. * see also pid_nr() etc in include/linux/pid.h
  959. */
  960. pid_t __task_pid_nr_ns(struct task_struct *task, enum pid_type type, struct pid_namespace *ns);
  961. static inline pid_t task_pid_nr(struct task_struct *tsk)
  962. {
  963. return tsk->pid;
  964. }
  965. static inline pid_t task_pid_nr_ns(struct task_struct *tsk, struct pid_namespace *ns)
  966. {
  967. return __task_pid_nr_ns(tsk, PIDTYPE_PID, ns);
  968. }
  969. static inline pid_t task_pid_vnr(struct task_struct *tsk)
  970. {
  971. return __task_pid_nr_ns(tsk, PIDTYPE_PID, NULL);
  972. }
  973. static inline pid_t task_tgid_nr(struct task_struct *tsk)
  974. {
  975. return tsk->tgid;
  976. }
  977. extern pid_t task_tgid_nr_ns(struct task_struct *tsk, struct pid_namespace *ns);
  978. static inline pid_t task_tgid_vnr(struct task_struct *tsk)
  979. {
  980. return pid_vnr(task_tgid(tsk));
  981. }
  982. /**
  983. * pid_alive - check that a task structure is not stale
  984. * @p: Task structure to be checked.
  985. *
  986. * Test if a process is not yet dead (at most zombie state)
  987. * If pid_alive fails, then pointers within the task structure
  988. * can be stale and must not be dereferenced.
  989. *
  990. * Return: 1 if the process is alive. 0 otherwise.
  991. */
  992. static inline int pid_alive(const struct task_struct *p)
  993. {
  994. return p->pids[PIDTYPE_PID].pid != NULL;
  995. }
  996. static inline pid_t task_ppid_nr_ns(const struct task_struct *tsk, struct pid_namespace *ns)
  997. {
  998. pid_t pid = 0;
  999. rcu_read_lock();
  1000. if (pid_alive(tsk))
  1001. pid = task_tgid_nr_ns(rcu_dereference(tsk->real_parent), ns);
  1002. rcu_read_unlock();
  1003. return pid;
  1004. }
  1005. static inline pid_t task_ppid_nr(const struct task_struct *tsk)
  1006. {
  1007. return task_ppid_nr_ns(tsk, &init_pid_ns);
  1008. }
  1009. static inline pid_t task_pgrp_nr_ns(struct task_struct *tsk, struct pid_namespace *ns)
  1010. {
  1011. return __task_pid_nr_ns(tsk, PIDTYPE_PGID, ns);
  1012. }
  1013. static inline pid_t task_pgrp_vnr(struct task_struct *tsk)
  1014. {
  1015. return __task_pid_nr_ns(tsk, PIDTYPE_PGID, NULL);
  1016. }
  1017. static inline pid_t task_session_nr_ns(struct task_struct *tsk, struct pid_namespace *ns)
  1018. {
  1019. return __task_pid_nr_ns(tsk, PIDTYPE_SID, ns);
  1020. }
  1021. static inline pid_t task_session_vnr(struct task_struct *tsk)
  1022. {
  1023. return __task_pid_nr_ns(tsk, PIDTYPE_SID, NULL);
  1024. }
  1025. /* Obsolete, do not use: */
  1026. static inline pid_t task_pgrp_nr(struct task_struct *tsk)
  1027. {
  1028. return task_pgrp_nr_ns(tsk, &init_pid_ns);
  1029. }
  1030. /**
  1031. * is_global_init - check if a task structure is init. Since init
  1032. * is free to have sub-threads we need to check tgid.
  1033. * @tsk: Task structure to be checked.
  1034. *
  1035. * Check if a task structure is the first user space task the kernel created.
  1036. *
  1037. * Return: 1 if the task structure is init. 0 otherwise.
  1038. */
  1039. static inline int is_global_init(struct task_struct *tsk)
  1040. {
  1041. return task_tgid_nr(tsk) == 1;
  1042. }
  1043. extern struct pid *cad_pid;
  1044. /*
  1045. * Per process flags
  1046. */
  1047. #define PF_IDLE 0x00000002 /* I am an IDLE thread */
  1048. #define PF_EXITING 0x00000004 /* Getting shut down */
  1049. #define PF_EXITPIDONE 0x00000008 /* PI exit done on shut down */
  1050. #define PF_VCPU 0x00000010 /* I'm a virtual CPU */
  1051. #define PF_WQ_WORKER 0x00000020 /* I'm a workqueue worker */
  1052. #define PF_FORKNOEXEC 0x00000040 /* Forked but didn't exec */
  1053. #define PF_MCE_PROCESS 0x00000080 /* Process policy on mce errors */
  1054. #define PF_SUPERPRIV 0x00000100 /* Used super-user privileges */
  1055. #define PF_DUMPCORE 0x00000200 /* Dumped core */
  1056. #define PF_SIGNALED 0x00000400 /* Killed by a signal */
  1057. #define PF_MEMALLOC 0x00000800 /* Allocating memory */
  1058. #define PF_NPROC_EXCEEDED 0x00001000 /* set_user() noticed that RLIMIT_NPROC was exceeded */
  1059. #define PF_USED_MATH 0x00002000 /* If unset the fpu must be initialized before use */
  1060. #define PF_USED_ASYNC 0x00004000 /* Used async_schedule*(), used by module init */
  1061. #define PF_NOFREEZE 0x00008000 /* This thread should not be frozen */
  1062. #define PF_FROZEN 0x00010000 /* Frozen for system suspend */
  1063. #define PF_KSWAPD 0x00020000 /* I am kswapd */
  1064. #define PF_MEMALLOC_NOFS 0x00040000 /* All allocation requests will inherit GFP_NOFS */
  1065. #define PF_MEMALLOC_NOIO 0x00080000 /* All allocation requests will inherit GFP_NOIO */
  1066. #define PF_LESS_THROTTLE 0x00100000 /* Throttle me less: I clean memory */
  1067. #define PF_KTHREAD 0x00200000 /* I am a kernel thread */
  1068. #define PF_RANDOMIZE 0x00400000 /* Randomize virtual address space */
  1069. #define PF_SWAPWRITE 0x00800000 /* Allowed to write to swap */
  1070. #define PF_NO_SETAFFINITY 0x04000000 /* Userland is not allowed to meddle with cpus_allowed */
  1071. #define PF_MCE_EARLY 0x08000000 /* Early kill for mce process policy */
  1072. #define PF_MUTEX_TESTER 0x20000000 /* Thread belongs to the rt mutex tester */
  1073. #define PF_FREEZER_SKIP 0x40000000 /* Freezer should not count it as freezable */
  1074. #define PF_SUSPEND_TASK 0x80000000 /* This thread called freeze_processes() and should not be frozen */
  1075. /*
  1076. * Only the _current_ task can read/write to tsk->flags, but other
  1077. * tasks can access tsk->flags in readonly mode for example
  1078. * with tsk_used_math (like during threaded core dumping).
  1079. * There is however an exception to this rule during ptrace
  1080. * or during fork: the ptracer task is allowed to write to the
  1081. * child->flags of its traced child (same goes for fork, the parent
  1082. * can write to the child->flags), because we're guaranteed the
  1083. * child is not running and in turn not changing child->flags
  1084. * at the same time the parent does it.
  1085. */
  1086. #define clear_stopped_child_used_math(child) do { (child)->flags &= ~PF_USED_MATH; } while (0)
  1087. #define set_stopped_child_used_math(child) do { (child)->flags |= PF_USED_MATH; } while (0)
  1088. #define clear_used_math() clear_stopped_child_used_math(current)
  1089. #define set_used_math() set_stopped_child_used_math(current)
  1090. #define conditional_stopped_child_used_math(condition, child) \
  1091. do { (child)->flags &= ~PF_USED_MATH, (child)->flags |= (condition) ? PF_USED_MATH : 0; } while (0)
  1092. #define conditional_used_math(condition) conditional_stopped_child_used_math(condition, current)
  1093. #define copy_to_stopped_child_used_math(child) \
  1094. do { (child)->flags &= ~PF_USED_MATH, (child)->flags |= current->flags & PF_USED_MATH; } while (0)
  1095. /* NOTE: this will return 0 or PF_USED_MATH, it will never return 1 */
  1096. #define tsk_used_math(p) ((p)->flags & PF_USED_MATH)
  1097. #define used_math() tsk_used_math(current)
  1098. /* Per-process atomic flags. */
  1099. #define PFA_NO_NEW_PRIVS 0 /* May not gain new privileges. */
  1100. #define PFA_SPREAD_PAGE 1 /* Spread page cache over cpuset */
  1101. #define PFA_SPREAD_SLAB 2 /* Spread some slab caches over cpuset */
  1102. #define TASK_PFA_TEST(name, func) \
  1103. static inline bool task_##func(struct task_struct *p) \
  1104. { return test_bit(PFA_##name, &p->atomic_flags); }
  1105. #define TASK_PFA_SET(name, func) \
  1106. static inline void task_set_##func(struct task_struct *p) \
  1107. { set_bit(PFA_##name, &p->atomic_flags); }
  1108. #define TASK_PFA_CLEAR(name, func) \
  1109. static inline void task_clear_##func(struct task_struct *p) \
  1110. { clear_bit(PFA_##name, &p->atomic_flags); }
  1111. TASK_PFA_TEST(NO_NEW_PRIVS, no_new_privs)
  1112. TASK_PFA_SET(NO_NEW_PRIVS, no_new_privs)
  1113. TASK_PFA_TEST(SPREAD_PAGE, spread_page)
  1114. TASK_PFA_SET(SPREAD_PAGE, spread_page)
  1115. TASK_PFA_CLEAR(SPREAD_PAGE, spread_page)
  1116. TASK_PFA_TEST(SPREAD_SLAB, spread_slab)
  1117. TASK_PFA_SET(SPREAD_SLAB, spread_slab)
  1118. TASK_PFA_CLEAR(SPREAD_SLAB, spread_slab)
  1119. static inline void
  1120. current_restore_flags(unsigned long orig_flags, unsigned long flags)
  1121. {
  1122. current->flags &= ~flags;
  1123. current->flags |= orig_flags & flags;
  1124. }
  1125. extern int cpuset_cpumask_can_shrink(const struct cpumask *cur, const struct cpumask *trial);
  1126. extern int task_can_attach(struct task_struct *p, const struct cpumask *cs_cpus_allowed);
  1127. #ifdef CONFIG_SMP
  1128. extern void do_set_cpus_allowed(struct task_struct *p, const struct cpumask *new_mask);
  1129. extern int set_cpus_allowed_ptr(struct task_struct *p, const struct cpumask *new_mask);
  1130. #else
  1131. static inline void do_set_cpus_allowed(struct task_struct *p, const struct cpumask *new_mask)
  1132. {
  1133. }
  1134. static inline int set_cpus_allowed_ptr(struct task_struct *p, const struct cpumask *new_mask)
  1135. {
  1136. if (!cpumask_test_cpu(0, new_mask))
  1137. return -EINVAL;
  1138. return 0;
  1139. }
  1140. #endif
  1141. #ifndef cpu_relax_yield
  1142. #define cpu_relax_yield() cpu_relax()
  1143. #endif
  1144. extern int yield_to(struct task_struct *p, bool preempt);
  1145. extern void set_user_nice(struct task_struct *p, long nice);
  1146. extern int task_prio(const struct task_struct *p);
  1147. /**
  1148. * task_nice - return the nice value of a given task.
  1149. * @p: the task in question.
  1150. *
  1151. * Return: The nice value [ -20 ... 0 ... 19 ].
  1152. */
  1153. static inline int task_nice(const struct task_struct *p)
  1154. {
  1155. return PRIO_TO_NICE((p)->static_prio);
  1156. }
  1157. extern int can_nice(const struct task_struct *p, const int nice);
  1158. extern int task_curr(const struct task_struct *p);
  1159. extern int idle_cpu(int cpu);
  1160. extern int sched_setscheduler(struct task_struct *, int, const struct sched_param *);
  1161. extern int sched_setscheduler_nocheck(struct task_struct *, int, const struct sched_param *);
  1162. extern int sched_setattr(struct task_struct *, const struct sched_attr *);
  1163. extern struct task_struct *idle_task(int cpu);
  1164. /**
  1165. * is_idle_task - is the specified task an idle task?
  1166. * @p: the task in question.
  1167. *
  1168. * Return: 1 if @p is an idle task. 0 otherwise.
  1169. */
  1170. static inline bool is_idle_task(const struct task_struct *p)
  1171. {
  1172. return !!(p->flags & PF_IDLE);
  1173. }
  1174. extern struct task_struct *curr_task(int cpu);
  1175. extern void ia64_set_curr_task(int cpu, struct task_struct *p);
  1176. void yield(void);
  1177. union thread_union {
  1178. #ifndef CONFIG_THREAD_INFO_IN_TASK
  1179. struct thread_info thread_info;
  1180. #endif
  1181. unsigned long stack[THREAD_SIZE/sizeof(long)];
  1182. };
  1183. #ifdef CONFIG_THREAD_INFO_IN_TASK
  1184. static inline struct thread_info *task_thread_info(struct task_struct *task)
  1185. {
  1186. return &task->thread_info;
  1187. }
  1188. #elif !defined(__HAVE_THREAD_FUNCTIONS)
  1189. # define task_thread_info(task) ((struct thread_info *)(task)->stack)
  1190. #endif
  1191. /*
  1192. * find a task by one of its numerical ids
  1193. *
  1194. * find_task_by_pid_ns():
  1195. * finds a task by its pid in the specified namespace
  1196. * find_task_by_vpid():
  1197. * finds a task by its virtual pid
  1198. *
  1199. * see also find_vpid() etc in include/linux/pid.h
  1200. */
  1201. extern struct task_struct *find_task_by_vpid(pid_t nr);
  1202. extern struct task_struct *find_task_by_pid_ns(pid_t nr, struct pid_namespace *ns);
  1203. extern int wake_up_state(struct task_struct *tsk, unsigned int state);
  1204. extern int wake_up_process(struct task_struct *tsk);
  1205. extern void wake_up_new_task(struct task_struct *tsk);
  1206. #ifdef CONFIG_SMP
  1207. extern void kick_process(struct task_struct *tsk);
  1208. #else
  1209. static inline void kick_process(struct task_struct *tsk) { }
  1210. #endif
  1211. extern void __set_task_comm(struct task_struct *tsk, const char *from, bool exec);
  1212. static inline void set_task_comm(struct task_struct *tsk, const char *from)
  1213. {
  1214. __set_task_comm(tsk, from, false);
  1215. }
  1216. extern char *get_task_comm(char *to, struct task_struct *tsk);
  1217. #ifdef CONFIG_SMP
  1218. void scheduler_ipi(void);
  1219. extern unsigned long wait_task_inactive(struct task_struct *, long match_state);
  1220. #else
  1221. static inline void scheduler_ipi(void) { }
  1222. static inline unsigned long wait_task_inactive(struct task_struct *p, long match_state)
  1223. {
  1224. return 1;
  1225. }
  1226. #endif
  1227. /*
  1228. * Set thread flags in other task's structures.
  1229. * See asm/thread_info.h for TIF_xxxx flags available:
  1230. */
  1231. static inline void set_tsk_thread_flag(struct task_struct *tsk, int flag)
  1232. {
  1233. set_ti_thread_flag(task_thread_info(tsk), flag);
  1234. }
  1235. static inline void clear_tsk_thread_flag(struct task_struct *tsk, int flag)
  1236. {
  1237. clear_ti_thread_flag(task_thread_info(tsk), flag);
  1238. }
  1239. static inline int test_and_set_tsk_thread_flag(struct task_struct *tsk, int flag)
  1240. {
  1241. return test_and_set_ti_thread_flag(task_thread_info(tsk), flag);
  1242. }
  1243. static inline int test_and_clear_tsk_thread_flag(struct task_struct *tsk, int flag)
  1244. {
  1245. return test_and_clear_ti_thread_flag(task_thread_info(tsk), flag);
  1246. }
  1247. static inline int test_tsk_thread_flag(struct task_struct *tsk, int flag)
  1248. {
  1249. return test_ti_thread_flag(task_thread_info(tsk), flag);
  1250. }
  1251. static inline void set_tsk_need_resched(struct task_struct *tsk)
  1252. {
  1253. set_tsk_thread_flag(tsk,TIF_NEED_RESCHED);
  1254. }
  1255. static inline void clear_tsk_need_resched(struct task_struct *tsk)
  1256. {
  1257. clear_tsk_thread_flag(tsk,TIF_NEED_RESCHED);
  1258. }
  1259. static inline int test_tsk_need_resched(struct task_struct *tsk)
  1260. {
  1261. return unlikely(test_tsk_thread_flag(tsk,TIF_NEED_RESCHED));
  1262. }
  1263. /*
  1264. * cond_resched() and cond_resched_lock(): latency reduction via
  1265. * explicit rescheduling in places that are safe. The return
  1266. * value indicates whether a reschedule was done in fact.
  1267. * cond_resched_lock() will drop the spinlock before scheduling,
  1268. * cond_resched_softirq() will enable bhs before scheduling.
  1269. */
  1270. #ifndef CONFIG_PREEMPT
  1271. extern int _cond_resched(void);
  1272. #else
  1273. static inline int _cond_resched(void) { return 0; }
  1274. #endif
  1275. #define cond_resched() ({ \
  1276. ___might_sleep(__FILE__, __LINE__, 0); \
  1277. _cond_resched(); \
  1278. })
  1279. extern int __cond_resched_lock(spinlock_t *lock);
  1280. #define cond_resched_lock(lock) ({ \
  1281. ___might_sleep(__FILE__, __LINE__, PREEMPT_LOCK_OFFSET);\
  1282. __cond_resched_lock(lock); \
  1283. })
  1284. extern int __cond_resched_softirq(void);
  1285. #define cond_resched_softirq() ({ \
  1286. ___might_sleep(__FILE__, __LINE__, SOFTIRQ_DISABLE_OFFSET); \
  1287. __cond_resched_softirq(); \
  1288. })
  1289. static inline void cond_resched_rcu(void)
  1290. {
  1291. #if defined(CONFIG_DEBUG_ATOMIC_SLEEP) || !defined(CONFIG_PREEMPT_RCU)
  1292. rcu_read_unlock();
  1293. cond_resched();
  1294. rcu_read_lock();
  1295. #endif
  1296. }
  1297. /*
  1298. * Does a critical section need to be broken due to another
  1299. * task waiting?: (technically does not depend on CONFIG_PREEMPT,
  1300. * but a general need for low latency)
  1301. */
  1302. static inline int spin_needbreak(spinlock_t *lock)
  1303. {
  1304. #ifdef CONFIG_PREEMPT
  1305. return spin_is_contended(lock);
  1306. #else
  1307. return 0;
  1308. #endif
  1309. }
  1310. static __always_inline bool need_resched(void)
  1311. {
  1312. return unlikely(tif_need_resched());
  1313. }
  1314. /*
  1315. * Wrappers for p->thread_info->cpu access. No-op on UP.
  1316. */
  1317. #ifdef CONFIG_SMP
  1318. static inline unsigned int task_cpu(const struct task_struct *p)
  1319. {
  1320. #ifdef CONFIG_THREAD_INFO_IN_TASK
  1321. return p->cpu;
  1322. #else
  1323. return task_thread_info(p)->cpu;
  1324. #endif
  1325. }
  1326. extern void set_task_cpu(struct task_struct *p, unsigned int cpu);
  1327. #else
  1328. static inline unsigned int task_cpu(const struct task_struct *p)
  1329. {
  1330. return 0;
  1331. }
  1332. static inline void set_task_cpu(struct task_struct *p, unsigned int cpu)
  1333. {
  1334. }
  1335. #endif /* CONFIG_SMP */
  1336. /*
  1337. * In order to reduce various lock holder preemption latencies provide an
  1338. * interface to see if a vCPU is currently running or not.
  1339. *
  1340. * This allows us to terminate optimistic spin loops and block, analogous to
  1341. * the native optimistic spin heuristic of testing if the lock owner task is
  1342. * running or not.
  1343. */
  1344. #ifndef vcpu_is_preempted
  1345. # define vcpu_is_preempted(cpu) false
  1346. #endif
  1347. extern long sched_setaffinity(pid_t pid, const struct cpumask *new_mask);
  1348. extern long sched_getaffinity(pid_t pid, struct cpumask *mask);
  1349. #ifndef TASK_SIZE_OF
  1350. #define TASK_SIZE_OF(tsk) TASK_SIZE
  1351. #endif
  1352. #endif