include/linux/topology.h

   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 <colpatch@us.ibm.com>
  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 <linux/percpu.h>
  35 #include <asm/topology.h>
  36
  37 #ifndef node_has_online_mem
  38 #define node_has_online_mem(nid) (1)
  39 #endif
  40
  41 #ifndef nr_cpus_node
  42 #define nr_cpus_node(node) cpumask_weight(cpumask_of_node(node))
  43 #endif
  44
  45 #define for_each_node_with_cpus(node)                   \
  46         for_each_online_node(node)                      \
  47                 if (nr_cpus_node(node))
  48
  49 int arch_update_cpu_topology(void);
  50
  51 /* Conform to ACPI 2.0 SLIT distance definitions */
  52 #define LOCAL_DISTANCE          10
  53 #define REMOTE_DISTANCE         20
  54 #ifndef node_distance
  55 #define node_distance(from,to)  ((from) == (to) ? LOCAL_DISTANCE : REMOTE_DISTANCE)
  56 #endif
  57 #ifndef RECLAIM_DISTANCE
  58 /*
  59  * If the distance between nodes in a system is larger than RECLAIM_DISTANCE
  60  * (in whatever arch specific measurement units returned by node_distance())
  61  * then switch on zone reclaim on boot.
  62  */
  63 #define RECLAIM_DISTANCE 30
  64 #endif
  65 #ifndef PENALTY_FOR_NODE_WITH_CPUS
  66 #define PENALTY_FOR_NODE_WITH_CPUS      (1)
  67 #endif
  68
  69 /*
  70  * Below are the 3 major initializers used in building sched_domains:
  71  * SD_SIBLING_INIT, for SMT domains
  72  * SD_CPU_INIT, for SMP domains
  73  *
  74  * Any architecture that cares to do any tuning to these values should do so
  75  * by defining their own arch-specific initializer in include/asm/topology.h.
  76  * A definition there will automagically override these default initializers
  77  * and allow arch-specific performance tuning of sched_domains.
  78  * (Only non-zero and non-null fields need be specified.)
  79  */
  80
  81 #ifdef CONFIG_SCHED_SMT
  82 /* MCD - Do we really need this?  It is always on if CONFIG_SCHED_SMT is,
  83  * so can't we drop this in favor of CONFIG_SCHED_SMT?
  84  */
  85 #define ARCH_HAS_SCHED_WAKE_IDLE
  86 /* Common values for SMT siblings */
  87 #ifndef SD_SIBLING_INIT
  88 #define SD_SIBLING_INIT (struct sched_domain) {                         \
  89         .min_interval           = 1,                                    \
  90         .max_interval           = 2,                                    \
  91         .busy_factor            = 64,                                   \
  92         .imbalance_pct          = 110,                                  \
  93                                                                         \
  94         .flags                  = 1*SD_LOAD_BALANCE                     \
  95                                 | 1*SD_BALANCE_NEWIDLE                  \
  96                                 | 1*SD_BALANCE_EXEC                     \
  97                                 | 1*SD_BALANCE_FORK                     \
  98                                 | 0*SD_BALANCE_WAKE                     \
  99                                 | 1*SD_WAKE_AFFINE                      \
 100                                 | 1*SD_SHARE_CPUPOWER                   \
 101                                 | 1*SD_SHARE_PKG_RESOURCES              \
 102                                 | 0*SD_SERIALIZE                        \
 103                                 | 0*SD_PREFER_SIBLING                   \
 104                                 | arch_sd_sibling_asym_packing()        \
 105                                 ,                                       \
 106         .last_balance           = jiffies,                              \
 107         .balance_interval       = 1,                                    \
 108         .smt_gain               = 1178, /* 15% */                       \
 109 }
 110 #endif
 111 #endif /* CONFIG_SCHED_SMT */
 112
 113 #ifdef CONFIG_SCHED_MC
 114 /* Common values for MC siblings. for now mostly derived from SD_CPU_INIT */
 115 #ifndef SD_MC_INIT
 116 #define SD_MC_INIT (struct sched_domain) {                              \
 117         .min_interval           = 1,                                    \
 118         .max_interval           = 4,                                    \
 119         .busy_factor            = 64,                                   \
 120         .imbalance_pct          = 125,                                  \
 121         .cache_nice_tries       = 1,                                    \
 122         .busy_idx               = 2,                                    \
 123         .wake_idx               = 0,                                    \
 124         .forkexec_idx           = 0,                                    \
 125                                                                         \
 126         .flags                  = 1*SD_LOAD_BALANCE                     \
 127                                 | 1*SD_BALANCE_NEWIDLE                  \
 128                                 | 1*SD_BALANCE_EXEC                     \
 129                                 | 1*SD_BALANCE_FORK                     \
 130                                 | 0*SD_BALANCE_WAKE                     \
 131                                 | 1*SD_WAKE_AFFINE                      \
 132                                 | 0*SD_SHARE_CPUPOWER                   \
 133                                 | 1*SD_SHARE_PKG_RESOURCES              \
 134                                 | 0*SD_SERIALIZE                        \
 135                                 ,                                       \
 136         .last_balance           = jiffies,                              \
 137         .balance_interval       = 1,                                    \
 138 }
 139 #endif
 140 #endif /* CONFIG_SCHED_MC */
 141
 142 /* Common values for CPUs */
 143 #ifndef SD_CPU_INIT
 144 #define SD_CPU_INIT (struct sched_domain) {                             \
 145         .min_interval           = 1,                                    \
 146         .max_interval           = 4,                                    \
 147         .busy_factor            = 64,                                   \
 148         .imbalance_pct          = 125,                                  \
 149         .cache_nice_tries       = 1,                                    \
 150         .busy_idx               = 2,                                    \
 151         .idle_idx               = 1,                                    \
 152         .newidle_idx            = 0,                                    \
 153         .wake_idx               = 0,                                    \
 154         .forkexec_idx           = 0,                                    \
 155                                                                         \
 156         .flags                  = 1*SD_LOAD_BALANCE                     \
 157                                 | 1*SD_BALANCE_NEWIDLE                  \
 158                                 | 1*SD_BALANCE_EXEC                     \
 159                                 | 1*SD_BALANCE_FORK                     \
 160                                 | 0*SD_BALANCE_WAKE                     \
 161                                 | 1*SD_WAKE_AFFINE                      \
 162                                 | 0*SD_SHARE_CPUPOWER                   \
 163                                 | 0*SD_SHARE_PKG_RESOURCES              \
 164                                 | 0*SD_SERIALIZE                        \
 165                                 | 1*SD_PREFER_SIBLING                   \
 166                                 ,                                       \
 167         .last_balance           = jiffies,                              \
 168         .balance_interval       = 1,                                    \
 169 }
 170 #endif
 171
 172 #ifdef CONFIG_SCHED_BOOK
 173 #ifndef SD_BOOK_INIT
 174 #error Please define an appropriate SD_BOOK_INIT in include/asm/topology.h!!!
 175 #endif
 176 #endif /* CONFIG_SCHED_BOOK */
 177
 178 #ifdef CONFIG_USE_PERCPU_NUMA_NODE_ID
 179 DECLARE_PER_CPU(int, numa_node);
 180
 181 #ifndef numa_node_id
 182 /* Returns the number of the current Node. */
 183 static inline int numa_node_id(void)
 184 {
 185         return __this_cpu_read(numa_node);
 186 }
 187 #endif
 188
 189 #ifndef cpu_to_node
 190 static inline int cpu_to_node(int cpu)
 191 {
 192         return per_cpu(numa_node, cpu);
 193 }
 194 #endif
 195
 196 #ifndef set_numa_node
 197 static inline void set_numa_node(int node)
 198 {
 199         this_cpu_write(numa_node, node);
 200 }
 201 #endif
 202
 203 #ifndef set_cpu_numa_node
 204 static inline void set_cpu_numa_node(int cpu, int node)
 205 {
 206         per_cpu(numa_node, cpu) = node;
 207 }
 208 #endif
 209
 210 #else   /* !CONFIG_USE_PERCPU_NUMA_NODE_ID */
 211
 212 /* Returns the number of the current Node. */
 213 #ifndef numa_node_id
 214 static inline int numa_node_id(void)
 215 {
 216         return cpu_to_node(raw_smp_processor_id());
 217 }
 218 #endif
 219
 220 #endif  /* [!]CONFIG_USE_PERCPU_NUMA_NODE_ID */
 221
 222 #ifdef CONFIG_HAVE_MEMORYLESS_NODES
 223
 224 /*
 225  * N.B., Do NOT reference the '_numa_mem_' per cpu variable directly.
 226  * It will not be defined when CONFIG_HAVE_MEMORYLESS_NODES is not defined.
 227  * Use the accessor functions set_numa_mem(), numa_mem_id() and cpu_to_mem().
 228  */
 229 DECLARE_PER_CPU(int, _numa_mem_);
 230
 231 #ifndef set_numa_mem
 232 static inline void set_numa_mem(int node)
 233 {
 234         this_cpu_write(_numa_mem_, node);
 235 }
 236 #endif
 237
 238 #ifndef numa_mem_id
 239 /* Returns the number of the nearest Node with memory */
 240 static inline int numa_mem_id(void)
 241 {
 242         return __this_cpu_read(_numa_mem_);
 243 }
 244 #endif
 245
 246 #ifndef cpu_to_mem
 247 static inline int cpu_to_mem(int cpu)
 248 {
 249         return per_cpu(_numa_mem_, cpu);
 250 }
 251 #endif
 252
 253 #ifndef set_cpu_numa_mem
 254 static inline void set_cpu_numa_mem(int cpu, int node)
 255 {
 256         per_cpu(_numa_mem_, cpu) = node;
 257 }
 258 #endif
 259
 260 #else   /* !CONFIG_HAVE_MEMORYLESS_NODES */
 261
 262 #ifndef numa_mem_id
 263 /* Returns the number of the nearest Node with memory */
 264 static inline int numa_mem_id(void)
 265 {
 266         return numa_node_id();
 267 }
 268 #endif
 269
 270 #ifndef cpu_to_mem
 271 static inline int cpu_to_mem(int cpu)
 272 {
 273         return cpu_to_node(cpu);
 274 }
 275 #endif
 276
 277 #endif  /* [!]CONFIG_HAVE_MEMORYLESS_NODES */
 278
 279 #ifndef topology_physical_package_id
 280 #define topology_physical_package_id(cpu)       ((void)(cpu), -1)
 281 #endif
 282 #ifndef topology_core_id
 283 #define topology_core_id(cpu)                   ((void)(cpu), 0)
 284 #endif
 285 #ifndef topology_thread_cpumask
 286 #define topology_thread_cpumask(cpu)            cpumask_of(cpu)
 287 #endif
 288 #ifndef topology_core_cpumask
 289 #define topology_core_cpumask(cpu)              cpumask_of(cpu)
 290 #endif
 291
 292 #endif /* _LINUX_TOPOLOGY_H */