xref: /linux-6.15/include/linux/topology.h (revision 87c2ce3b)
1 /*
2  * include/linux/topology.h
3  *
4  * Written by: Matthew Dobson, IBM Corporation
5  *
6  * Copyright (C) 2002, IBM Corp.
7  *
8  * All rights reserved.
9  *
10  * This program is free software; you can redistribute it and/or modify
11  * it under the terms of the GNU General Public License as published by
12  * the Free Software Foundation; either version 2 of the License, or
13  * (at your option) any later version.
14  *
15  * This program is distributed in the hope that it will be useful, but
16  * WITHOUT ANY WARRANTY; without even the implied warranty of
17  * MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE, GOOD TITLE or
18  * NON INFRINGEMENT.  See the GNU General Public License for more
19  * details.
20  *
21  * You should have received a copy of the GNU General Public License
22  * along with this program; if not, write to the Free Software
23  * Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
24  *
25  * Send feedback to <[email protected]>
26  */
27 #ifndef _LINUX_TOPOLOGY_H
28 #define _LINUX_TOPOLOGY_H
29 
30 #include <linux/cpumask.h>
31 #include <linux/bitops.h>
32 #include <linux/mmzone.h>
33 #include <linux/smp.h>
34 #include <asm/topology.h>
35 
36 #ifndef node_has_online_mem
37 #define node_has_online_mem(nid) (1)
38 #endif
39 
40 #ifndef nr_cpus_node
41 #define nr_cpus_node(node)							\
42 	({									\
43 		cpumask_t __tmp__;						\
44 		__tmp__ = node_to_cpumask(node);				\
45 		cpus_weight(__tmp__);						\
46 	})
47 #endif
48 
49 #define for_each_node_with_cpus(node)						\
50 	for_each_online_node(node)						\
51 		if (nr_cpus_node(node))
52 
53 #ifndef node_distance
54 /* Conform to ACPI 2.0 SLIT distance definitions */
55 #define LOCAL_DISTANCE		10
56 #define REMOTE_DISTANCE		20
57 #define node_distance(from,to)	((from) == (to) ? LOCAL_DISTANCE : REMOTE_DISTANCE)
58 #endif
59 #ifndef PENALTY_FOR_NODE_WITH_CPUS
60 #define PENALTY_FOR_NODE_WITH_CPUS	(1)
61 #endif
62 
63 /*
64  * Below are the 3 major initializers used in building sched_domains:
65  * SD_SIBLING_INIT, for SMT domains
66  * SD_CPU_INIT, for SMP domains
67  * SD_NODE_INIT, for NUMA domains
68  *
69  * Any architecture that cares to do any tuning to these values should do so
70  * by defining their own arch-specific initializer in include/asm/topology.h.
71  * A definition there will automagically override these default initializers
72  * and allow arch-specific performance tuning of sched_domains.
73  */
74 #ifdef CONFIG_SCHED_SMT
75 /* MCD - Do we really need this?  It is always on if CONFIG_SCHED_SMT is,
76  * so can't we drop this in favor of CONFIG_SCHED_SMT?
77  */
78 #define ARCH_HAS_SCHED_WAKE_IDLE
79 /* Common values for SMT siblings */
80 #ifndef SD_SIBLING_INIT
81 #define SD_SIBLING_INIT (struct sched_domain) {		\
82 	.span			= CPU_MASK_NONE,	\
83 	.parent			= NULL,			\
84 	.groups			= NULL,			\
85 	.min_interval		= 1,			\
86 	.max_interval		= 2,			\
87 	.busy_factor		= 8,			\
88 	.imbalance_pct		= 110,			\
89 	.cache_hot_time		= 0,			\
90 	.cache_nice_tries	= 0,			\
91 	.per_cpu_gain		= 25,			\
92 	.busy_idx		= 0,			\
93 	.idle_idx		= 0,			\
94 	.newidle_idx		= 1,			\
95 	.wake_idx		= 0,			\
96 	.forkexec_idx		= 0,			\
97 	.flags			= SD_LOAD_BALANCE	\
98 				| SD_BALANCE_NEWIDLE	\
99 				| SD_BALANCE_EXEC	\
100 				| SD_WAKE_AFFINE	\
101 				| SD_WAKE_IDLE		\
102 				| SD_SHARE_CPUPOWER,	\
103 	.last_balance		= jiffies,		\
104 	.balance_interval	= 1,			\
105 	.nr_balance_failed	= 0,			\
106 }
107 #endif
108 #endif /* CONFIG_SCHED_SMT */
109 
110 /* Common values for CPUs */
111 #ifndef SD_CPU_INIT
112 #define SD_CPU_INIT (struct sched_domain) {		\
113 	.span			= CPU_MASK_NONE,	\
114 	.parent			= NULL,			\
115 	.groups			= NULL,			\
116 	.min_interval		= 1,			\
117 	.max_interval		= 4,			\
118 	.busy_factor		= 64,			\
119 	.imbalance_pct		= 125,			\
120 	.cache_hot_time		= (5*1000000/2),	\
121 	.cache_nice_tries	= 1,			\
122 	.per_cpu_gain		= 100,			\
123 	.busy_idx		= 2,			\
124 	.idle_idx		= 1,			\
125 	.newidle_idx		= 2,			\
126 	.wake_idx		= 1,			\
127 	.forkexec_idx		= 1,			\
128 	.flags			= SD_LOAD_BALANCE	\
129 				| SD_BALANCE_NEWIDLE	\
130 				| SD_BALANCE_EXEC	\
131 				| SD_WAKE_AFFINE,	\
132 	.last_balance		= jiffies,		\
133 	.balance_interval	= 1,			\
134 	.nr_balance_failed	= 0,			\
135 }
136 #endif
137 
138 /* sched_domains SD_ALLNODES_INIT for NUMA machines */
139 #define SD_ALLNODES_INIT (struct sched_domain) {	\
140 	.span			= CPU_MASK_NONE,	\
141 	.parent			= NULL,			\
142 	.groups			= NULL,			\
143 	.min_interval		= 64,			\
144 	.max_interval		= 64*num_online_cpus(),	\
145 	.busy_factor		= 128,			\
146 	.imbalance_pct		= 133,			\
147 	.cache_hot_time		= (10*1000000),		\
148 	.cache_nice_tries	= 1,			\
149 	.busy_idx		= 3,			\
150 	.idle_idx		= 3,			\
151 	.newidle_idx		= 0, /* unused */	\
152 	.wake_idx		= 0, /* unused */	\
153 	.forkexec_idx		= 0, /* unused */	\
154 	.per_cpu_gain		= 100,			\
155 	.flags			= SD_LOAD_BALANCE,	\
156 	.last_balance		= jiffies,		\
157 	.balance_interval	= 64,			\
158 	.nr_balance_failed	= 0,			\
159 }
160 
161 #ifdef CONFIG_NUMA
162 #ifndef SD_NODE_INIT
163 #error Please define an appropriate SD_NODE_INIT in include/asm/topology.h!!!
164 #endif
165 #endif /* CONFIG_NUMA */
166 
167 #endif /* _LINUX_TOPOLOGY_H */
168