1 /*
2 * CDDL HEADER START
3 *
4 * The contents of this file are subject to the terms of the
5 * Common Development and Distribution License (the "License").
6 * You may not use this file except in compliance with the License.
7 *
8 * You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
9 * or http://www.opensolaris.org/os/licensing.
10 * See the License for the specific language governing permissions
11 * and limitations under the License.
12 *
13 * When distributing Covered Code, include this CDDL HEADER in each
14 * file and include the License file at usr/src/OPENSOLARIS.LICENSE.
15 * If applicable, add the following below this CDDL HEADER, with the
16 * fields enclosed by brackets "[]" replaced with your own identifying
17 * information: Portions Copyright [yyyy] [name of copyright owner]
18 *
19 * CDDL HEADER END
20 */
21
22 /*
23 * Copyright 2009 Sun Microsystems, Inc. All rights reserved.
24 * Use is subject to license terms.
25 *
26 * Copyright 2017 RackTop Systems.
27 */
28
29 #ifndef _LGRP_H
30 #define _LGRP_H
31
32 /*
33 * locality group definitions for kernel
34 */
35
36 #include <sys/types.h>
37
38 #ifdef __cplusplus
39 extern "C" {
40 #endif
41
42 #define LGRP_NONE (-1) /* non-existent lgroup ID */
43
44 #if !defined(_KERNEL) && !defined(_FAKE_KERNEL) && !defined(_KMEMUSER)
45 typedef struct lgrp_mem_policy_info { int opaque[2]; } lgrp_mem_policy_info_t;
46 #endif /* !_KERNEL && !_FAKE_KERNEL && !_KMEMUSER */
47
48 #if defined(_KERNEL) || defined(_FAKE_KERNEL) || defined(_KMEMUSER)
49 #include <sys/cpuvar.h>
50 #include <sys/bitmap.h>
51 #include <sys/vnode.h>
52 #include <vm/anon.h>
53 #include <vm/seg.h>
54 #include <sys/lgrp_user.h>
55 #include <sys/param.h>
56
57 typedef uint32_t lgrp_load_t; /* lgrp_loadavg type */
58 typedef uintptr_t lgrp_handle_t; /* lgrp handle */
59
60 #define LGRP_NONE_SUCH LGRP_NONE /* non-existent lgroup ID */
61 /* null platform handle */
62 #define LGRP_NULL_HANDLE ((lgrp_handle_t)0xbadbad)
63 #define LGRP_DEFAULT_HANDLE ((lgrp_handle_t)0xbabecafe) /* uma handle */
64 #define LGRP_ROOTID (0) /* root lgroup ID */
65
66 /*
67 * Maximum number of lgrps a platform may define.
68 */
69 #define NLGRPS_MAX 64
70 #define LGRP_LOADAVG_MAX UINT32_MAX
71
72 /*
73 * The load-average we expect for one cpu-bound thread's worth of load
74 */
75 #define LGRP_LOADAVG_THREAD_MAX 65516
76
77 /*
78 * The input to the load-average generating function for one cpu-bound thread's
79 * worth of load
80 */
81
82 #define LGRP_LOADAVG_IN_THREAD_MAX 128
83
84 /*
85 * LPL actions
86 */
87
88 typedef enum {
89 LPL_INCREMENT,
90 LPL_DECREMENT
91 } lpl_act_t;
92
93 /*
94 * lgroup statistics. Most of these are counters that are updated
95 * dynamically so they are hashed to CPU buckets to reduce cache
96 * interference. The remaining statistics are snapshots of kernel
97 * data, so they aren't stored in the array of counter stats.
98 *
99 * For the hashed stats to make sense, you have to sum all the buckets for
100 * that stat, hence macros are provided to read the stats.
101 */
102
103 #define LGRP_NUM_CPU_BUCKETS 8 /* must be power of 2 */
104 #define LGRP_CPU_BUCKET_MASK (LGRP_NUM_CPU_BUCKETS - 1)
105
106 /*
107 * Flags for what to do with lgroup memory policy
108 * Used for heap and stack where policy is extended to new segments added to
109 * the end
110 */
111 #define LGRP_MP_FLAG_EXTEND_UP 0x1 /* policy should extend up */
112 #define LGRP_MP_FLAG_EXTEND_DOWN 0x2 /* policy should extend down */
113
114 #define LGRP_STAT(stats, bucket, whichstat) \
115 ((stats)->ls_data[bucket][whichstat])
116
117 /* Return a pointer suitable for an atomic 64-bit op on the bucket */
118 #define LGRP_STAT_WRITE_PTR(stats, whichstat) \
119 (&LGRP_STAT(stats, (CPU->cpu_id) & LGRP_CPU_BUCKET_MASK, \
120 whichstat))
121
122 /* Sum up all the buckets and return the value in 'val' */
123 #define LGRP_STAT_READ(stats, whichstat, val) { \
124 int bkt; \
125 for (val = 0, bkt = 0; bkt < LGRP_NUM_CPU_BUCKETS; bkt++) \
126 val += LGRP_STAT(stats, bkt, whichstat); \
127 }
128
129 /* Reset all buckets for the stat to 0 */
130 #define LGRP_STAT_RESET(stats, stat) { \
131 int i; \
132 for (i = 0; i < LGRP_NUM_CPU_BUCKETS; i++) \
133 LGRP_STAT(stats, i, stat) = 0; \
134 }
135
136 /*
137 * Define all of the statistics that are kept for lgrp kstats,
138 * and their corresponding text names.
139 */
140
141 typedef enum lgrp_stat_types {
142 LGRP_NUM_MIGR, /* # migrations away from this lgrp */
143 LGRP_NUM_ALLOC_FAIL, /* # times alloc fails for chosen lgrp */
144 LGRP_PM_SRC_PGS, /* # pages migrated from this lgrp */
145 LGRP_PM_DEST_PGS, /* # pages migrated to this lgrp */
146 LGRP_PM_FAIL_ALLOC_PGS, /* # pages failed to migrate to this lgrp */
147 LGRP_PM_FAIL_LOCK_PGS, /* # pages failed to migrate from this lgrp */
148 LGRP_PMM_PGS, /* # pages marked to migrate from this lgrp */
149 LGRP_PMM_FAIL_PGS, /* # pages marked to migrate from this lgrp */
150 LGRP_NUM_DEFAULT, /* # of times default policy applied */
151 LGRP_NUM_NEXT, /* # of times next touch policy applied */
152 LGRP_NUM_RANDOM, /* # of times random policy applied */
153 LGRP_NUM_RANDOM_PROC, /* # of times random proc policy applied */
154 LGRP_NUM_RANDOM_PSET, /* # of times random pset policy applied */
155 LGRP_NUM_ROUNDROBIN, /* # of times round robin policy applied */
156 LGRP_NUM_NEXT_SEG, /* # of times next to seg policy applied */
157 LGRP_NUM_COUNTER_STATS, /* always last */
158 LGRP_CTR_STATS_ALLOC = 16 /* cache-align pad - multiple of 8 */
159 /* always keep >= LGRP_NUM_COUNTER_STATS */
160 } lgrp_stat_t;
161
162 typedef enum lgrp_snap_stat_types {
163 LGRP_NUM_CPUS, /* number of CPUs */
164 LGRP_NUM_PG_FREE, /* # of free pages */
165 LGRP_NUM_PG_AVAIL, /* # of allocatable physical pages */
166 LGRP_NUM_PG_INSTALL, /* # of installed physical pages */
167 LGRP_LOADAVG, /* unscaled load average of this lgrp */
168 LGRP_LOADAVG_SCALE, /* load unit of one CPU bound thread */
169 LGRP_NUM_SNAPSHOT_STATS /* always last */
170 } lgrp_snap_stat_t;
171
172 #define LGRP_KSTAT_NAMES \
173 static char *lgrp_kstat_names[] = { \
174 \
175 /* Counter stats */ \
176 "lwp migrations", \
177 "alloc fail", \
178 "pages migrated from", \
179 "pages migrated to", \
180 "pages failed to migrate to", \
181 "pages failed to migrate from", \
182 "pages marked for migration", \
183 "pages failed to mark", \
184 "default policy", \
185 "next-touch policy", \
186 "random policy", \
187 "span process policy", \
188 "span psrset policy", \
189 "round robin policy", \
190 "next-seg policy", \
191 \
192 /* Snapshot stats */ \
193 "cpus", \
194 "pages free", \
195 "pages avail", \
196 "pages installed", \
197 "load average", \
198 "loadscale" \
199 }
200
201 #define LGRP_NUM_STATS ((int)LGRP_NUM_COUNTER_STATS + \
202 (int)LGRP_NUM_SNAPSHOT_STATS)
203
204 /*
205 * The contents of this structure are opaque and should only be
206 * accessed through the LGRP_STAT macro.
207 */
208 struct lgrp_stats {
209 int64_t ls_data[LGRP_NUM_CPU_BUCKETS][LGRP_CTR_STATS_ALLOC];
210 };
211
212 /* The kernel's version of a bitmap of lgroups */
213 typedef uint64_t klgrpset_t;
214
215 /*
216 * This really belongs in memnode.h, but it must be defined here to avoid
217 * recursive inclusion problems. Note that memnode.h includes this header.
218 */
219 typedef uint64_t mnodeset_t;
220
221 /*
222 * lgroup structure
223 *
224 * Visible to generic code and contains the lgroup ID, CPUs in this lgroup,
225 * and a platform handle used to identify this lgroup to the lgroup platform
226 * support code
227 */
228 typedef struct lgrp {
229
230 lgrp_id_t lgrp_id; /* which lgroup */
231 int lgrp_latency;
232 lgrp_handle_t lgrp_plathand; /* handle for platform calls */
233 struct lgrp *lgrp_parent; /* parent lgroup */
234 uint_t lgrp_reserved1; /* filler */
235 uint_t lgrp_childcnt; /* number of children lgroups */
236 klgrpset_t lgrp_children; /* children lgroups */
237 klgrpset_t lgrp_leaves; /* (direct decendant) leaf lgroups */
238
239 /*
240 * set of lgroups containing a given type of resource
241 * at this level of locality
242 */
243 klgrpset_t lgrp_set[LGRP_RSRC_COUNT];
244
245 mnodeset_t lgrp_mnodes; /* set of memory nodes in this lgroup */
246 uint_t lgrp_nmnodes; /* number of memnodes */
247 uint_t lgrp_reserved2; /* filler */
248
249 struct cpu *lgrp_cpu; /* pointer to a cpu may be null */
250 uint_t lgrp_cpucnt; /* number of cpus in this lgrp */
251 kstat_t *lgrp_kstat; /* per-lgrp kstats */
252 } lgrp_t;
253
254 /*
255 * lgroup load average structure
256 */
257
258 typedef struct lgrp_ld {
259 lgrp_load_t lpl_loadavg; /* load average */
260 uint_t lpl_ncpu; /* how many cpus */
261 lgrp_id_t lpl_lgrpid; /* which group this lpl part of */
262 lgrp_t *lpl_lgrp; /* ptr to lpl's lgrp */
263 struct lgrp_ld *lpl_parent; /* lpl of parent lgrp */
264 struct cpu *lpl_cpus; /* list of cpus in lpl */
265 /* NULL for non-leaf lgrps */
266 uint_t lpl_nrset; /* no. of leaf lpls for lgrp */
267 hrtime_t lpl_homed_time; /* time of last homing to this lpl */
268 uint_t lpl_rset_sz; /* Resource set capacity */
269 struct lgrp_ld **lpl_rset; /* leaf lpls for lgrp */
270 /* contains ptr to self for leaf lgrp */
271 int *lpl_id2rset; /* mapping of lgrpid to rset index */
272 } lpl_t;
273
274 /*
275 * 1 << LGRP_MAX_EFFECT_SHFT == lgrp_loadavg_max_effect
276 */
277 #define LGRP_MAX_EFFECT_SHFT 16
278
279 /*
280 * Operations handled by lgrp_config()
281 */
282 typedef enum lgrp_config_flag {
283 LGRP_CONFIG_NOP,
284 LGRP_CONFIG_CPU_ADD,
285 LGRP_CONFIG_CPU_DEL,
286 LGRP_CONFIG_CPU_ONLINE,
287 LGRP_CONFIG_CPU_OFFLINE,
288 LGRP_CONFIG_CPUPART_ADD,
289 LGRP_CONFIG_CPUPART_DEL,
290 LGRP_CONFIG_MEM_ADD,
291 LGRP_CONFIG_MEM_DEL,
292 LGRP_CONFIG_MEM_RENAME,
293 LGRP_CONFIG_GEN_UPDATE,
294 LGRP_CONFIG_FLATTEN,
295 LGRP_CONFIG_LAT_CHANGE_ALL,
296 LGRP_CONFIG_LAT_CHANGE
297 } lgrp_config_flag_t;
298
299 /*
300 * Stages of lgroup framework initialization (done through lgrp_init()):
301 *
302 * 1) Initialize common and platform specific code (called in mlsetup())
303 *
304 * 2) Setup root lgroup and add CPU 0 to lgroup(s) (called near beginning of
305 * main() before startup())
306 *
307 * 3) Probe from CPU 0 and copy and release any BOP_ALLOC-ed memory temporarily
308 * allocated before kernel memory allocator is setup (called in main()
309 * after startup(), gethrtime() is setup, and before interrupts enabled)
310 *
311 * 4) Check for null proc LPA on Starcat, collapse lgroup topology (if
312 * necessary), setup lgroup kstats, etc. (called before start_other_cpus())
313 *
314 * 5) Finish any lgroup initialization needed including updating lgroup
315 * topology after all CPUs started (called after start_other_cpus())
316 */
317 typedef enum lgrp_init_stages {
318 LGRP_INIT_STAGE1,
319 LGRP_INIT_STAGE2,
320 LGRP_INIT_STAGE3,
321 LGRP_INIT_STAGE4,
322 LGRP_INIT_STAGE5
323 } lgrp_init_stages_t;
324
325 /*
326 * Memory allocation policies
327 */
328 typedef enum lgrp_mem_policy {
329 LGRP_MEM_POLICY_DEFAULT,
330 LGRP_MEM_POLICY_NEXT, /* near LWP to next touch */
331 LGRP_MEM_POLICY_RANDOM_PROC, /* randomly across process */
332 LGRP_MEM_POLICY_RANDOM_PSET, /* randomly across processor set */
333 LGRP_MEM_POLICY_RANDOM, /* randomly across all lgroups */
334 LGRP_MEM_POLICY_ROUNDROBIN, /* round robin across all lgroups */
335 LGRP_MEM_POLICY_NEXT_CPU, /* Near next CPU to touch memory */
336 LGRP_MEM_POLICY_NEXT_SEG, /* lgrp specified directly by seg */
337 LGRP_NUM_MEM_POLICIES
338 } lgrp_mem_policy_t;
339
340 /*
341 * Search scopes for finding resouces
342 */
343 typedef enum lgrp_res_ss {
344 LGRP_SRCH_LOCAL, /* Search local lgroup only */
345 LGRP_SRCH_HIER /* Search entire hierarchy */
346 } lgrp_res_ss_t;
347
348 /*
349 * Cookie used for lgrp mnode selection
350 */
351 typedef struct lgrp_mnode_cookie {
352 lgrp_t *lmc_lgrp; /* lgrp under consideration */
353 mnodeset_t lmc_nodes; /* nodes not yet tried in lgrp */
354 int lmc_cnt; /* how many nodes in untried set */
355 mnodeset_t lmc_tried; /* nodes already tried */
356 int lmc_ntried; /* how many nodes in tried set */
357 lgrp_res_ss_t lmc_scope; /* consider non-local nodes? */
358 ushort_t lmc_rand; /* a "random" number */
359 } lgrp_mnode_cookie_t;
360
361 /*
362 * Information needed to implement memory allocation policy
363 */
364 typedef struct lgrp_mem_policy_info {
365 int mem_policy; /* memory allocation policy */
366 lgrp_id_t mem_lgrpid; /* lgroup id */
367 } lgrp_mem_policy_info_t;
368
369 /*
370 * Shared memory policy segment
371 */
372 typedef struct lgrp_shm_policy_seg {
373 u_offset_t shm_off; /* offset into shared object */
374 size_t shm_size; /* size of segment */
375 lgrp_mem_policy_info_t shm_policy; /* memory allocation policy */
376 avl_node_t shm_tree; /* AVL tree */
377 } lgrp_shm_policy_seg_t;
378
379 /*
380 * Shared memory locality info
381 */
382 typedef struct lgrp_shm_locality {
383 size_t loc_count; /* reference count */
384 avl_tree_t *loc_tree; /* policy segment tree */
385 krwlock_t loc_lock; /* protects tree */
386 } lgrp_shm_locality_t;
387
388 /*
389 * Queries that may be made to determine lgroup memory size
390 */
391 typedef enum {
392 LGRP_MEM_SIZE_FREE, /* number of free pages */
393 LGRP_MEM_SIZE_AVAIL, /* number of pages in phys_avail */
394 LGRP_MEM_SIZE_INSTALL /* number of pages in phys_install */
395 } lgrp_mem_query_t;
396
397 /*
398 * Argument for the memory copy-rename operation, contains the source and the
399 * destination platform handles.
400 */
401 typedef struct lgrp_config_mem_rename {
402 lgrp_handle_t lmem_rename_from;
403 lgrp_handle_t lmem_rename_to;
404 } lgrp_config_mem_rename_t;
405
406 /* Macro to clear an lgroup bitmap */
407 #define klgrpset_clear(klgrpset) \
408 (klgrpset) = (klgrpset_t)0
409
410 /* Macro to fill an lgroup bitmap */
411 #define klgrpset_fill(klgrpset) \
412 (klgrpset) = (klgrpset_t)(-1)
413
414 /* Macro to add an lgroup to an lgroup bitmap */
415 #define klgrpset_add(klgrpset, lgrpid) \
416 (klgrpset) |= ((klgrpset_t)1 << (lgrpid))
417
418 /* Macro to delete an lgroup from an lgroup bitmap */
419 #define klgrpset_del(klgrpset, lgrpid) \
420 (klgrpset) &= ~((klgrpset_t)1 << (lgrpid))
421
422 /* Macro to copy a klgrpset into another klgrpset */
423 #define klgrpset_copy(klgrpset_to, klgrpset_from) \
424 (klgrpset_to) = (klgrpset_from)
425
426 /* Macro to perform an 'and' operation on a pair of lgroup bitmaps */
427 #define klgrpset_and(klgrpset_rslt, klgrpset_arg) \
428 (klgrpset_rslt) &= (klgrpset_arg)
429
430 /* Macro to perform an 'or' operation on a pair of lgroup bitmaps */
431 #define klgrpset_or(klgrpset_rslt, klgrpset_arg) \
432 (klgrpset_rslt) |= (klgrpset_arg)
433
434 /* Macro to perform a 'diff' operation on a pair of lgroup bitmaps */
435 #define klgrpset_diff(klgrpset_rslt, klgrpset_arg) \
436 (klgrpset_rslt) &= ~(klgrpset_arg)
437
438 /* Macro to check if an lgroup is a member of an lgrpset */
439 #define klgrpset_ismember(klgrpset, lgrpid) \
440 ((klgrpset) & ((klgrpset_t)1 << (lgrpid)))
441
442 /* Macro to check if an lgroup bitmap is empty */
443 #define klgrpset_isempty(klgrpset) \
444 ((klgrpset) == (klgrpset_t)0)
445
446 /* Macro to check if two lgrpsets intersect */
447 #define klgrpset_intersects(klgrpset1, klgrpset2) \
448 ((klgrpset1) & (klgrpset2))
449
450 /* Macro to count the number of members in an lgrpset */
451 #define klgrpset_nlgrps(klgrpset, count) \
452 { \
453 lgrp_id_t lgrpid; \
454 for (lgrpid = 0, count = 0; lgrpid <= lgrp_alloc_max; lgrpid++) {\
455 if (klgrpset_ismember(klgrpset, lgrpid)) \
456 count++; \
457 } \
458 }
459
460 /* Macro to get total memory size (in bytes) of a given set of lgroups */
461 #define klgrpset_totalsize(klgrpset, size) \
462 { \
463 lgrp_handle_t hand; \
464 lgrp_id_t lgrpid; \
465 \
466 for (lgrpid = 0, size = 0; lgrpid <= lgrp_alloc_max; lgrpid++) {\
467 if (klgrpset_ismember(klgrpset, lgrpid) && \
468 lgrp_table[lgrpid]) { \
469 hand = lgrp_table[lgrpid]->lgrp_plathand; \
470 size += lgrp_plat_mem_size(hand, \
471 LGRP_MEM_SIZE_AVAIL) * PAGESIZE; \
472 } \
473 } \
474 }
475
476 /*
477 * Does this lgroup exist?
478 */
479 #define LGRP_EXISTS(lgrp) \
480 (lgrp != NULL && lgrp->lgrp_id != LGRP_NONE)
481
482 /*
483 * Macro for testing if a CPU is contained in an lgrp.
484 */
485 #define LGRP_CONTAINS_CPU(lgrp, cpu) \
486 (klgrpset_ismember(lgrp->lgrp_set[LGRP_RSRC_CPU], \
487 cpu->cpu_lpl->lpl_lgrpid))
488
489 /*
490 * Initialize an lgrp_mnode_cookie
491 */
492 #define LGRP_MNODE_COOKIE_INIT(c, lgrp, scope) \
493 { \
494 bzero(&(c), sizeof (lgrp_mnode_cookie_t)); \
495 (&(c))->lmc_lgrp = lgrp; \
496 (&(c))->lmc_nodes = lgrp->lgrp_mnodes; \
497 (&(c))->lmc_cnt = lgrp->lgrp_nmnodes; \
498 (&(c))->lmc_scope = scope; \
499 (&(c))->lmc_rand = (ushort_t)gethrtime_unscaled() >> 4; \
500 }
501
502 /*
503 * Upgrade cookie scope from LGRP_SRCH_LOCAL to LGRP_SRCH_HIER.
504 */
505 #define LGRP_MNODE_COOKIE_UPGRADE(c) \
506 { \
507 ASSERT((&(c))->lmc_scope == LGRP_SRCH_LOCAL); \
508 (&(c))->lmc_scope = LGRP_SRCH_HIER; \
509 }
510
511 /*
512 * Macro to see whether memory allocation policy can be reapplied
513 */
514 #define LGRP_MEM_POLICY_REAPPLICABLE(p) \
515 (p == LGRP_MEM_POLICY_NEXT)
516
517 /*
518 * Return true if lgrp has CPU resources in the cpupart
519 */
520 #define LGRP_CPUS_IN_PART(lgrpid, cpupart) \
521 (cpupart->cp_lgrploads[lgrpid].lpl_ncpu > 0)
522
523 extern int lgrp_alloc_max;
524 extern lgrp_t *lgrp_table[NLGRPS_MAX]; /* indexed by lgrp_id */
525 extern int nlgrps; /* number of lgroups in machine */
526 extern int nlgrpsmax; /* max number of lgroups on platform */
527 extern lgrp_gen_t lgrp_gen; /* generation of lgroup hierarchy */
528 extern int lgrp_initialized; /* single-CPU initialization done */
529 extern int lgrp_topo_initialized; /* lgrp topology constructed */
530 extern lgrp_t *lgrp_root; /* root lgroup */
531 extern unsigned int lgrp_topo_levels;
532 extern lpl_t *lpl_bootstrap; /* bootstrap lpl for non-active CPUs */
533
534
535 /* generic interfaces */
536
537 /*
538 * lgroup management
539 */
540 int lgrp_optimizations(void);
541 void lgrp_init(lgrp_init_stages_t);
542 lgrp_t *lgrp_create(void);
543 void lgrp_destroy(lgrp_t *);
544 void lgrp_config(lgrp_config_flag_t, uintptr_t, uintptr_t);
545 lgrp_t *lgrp_hand_to_lgrp(lgrp_handle_t);
546
547 /*
548 * lgroup stats
549 */
550 void lgrp_kstat_create(struct cpu *);
551 void lgrp_kstat_destroy(struct cpu *);
552 void lgrp_stat_add(lgrp_id_t, lgrp_stat_t, int64_t);
553 int64_t lgrp_stat_read(lgrp_id_t, lgrp_stat_t);
554
555 /*
556 * lgroup memory
557 */
558 lgrp_mem_policy_t lgrp_madv_to_policy(uchar_t, size_t, int);
559 pgcnt_t lgrp_mem_size(lgrp_id_t, lgrp_mem_query_t);
560 lgrp_t *lgrp_mem_choose(struct seg *, caddr_t, size_t);
561 int lgrp_memnode_choose(lgrp_mnode_cookie_t *);
562 lgrp_mem_policy_t lgrp_mem_policy_default(size_t, int);
563 int lgrp_mnode_update(klgrpset_t, klgrpset_t *);
564 lgrp_t *lgrp_pfn_to_lgrp(pfn_t);
565 lgrp_t *lgrp_phys_to_lgrp(u_longlong_t); /* used by numat driver */
566 int lgrp_privm_policy_set(lgrp_mem_policy_t, lgrp_mem_policy_info_t *,
567 size_t);
568 void lgrp_shm_policy_init(struct anon_map *, vnode_t *);
569 void lgrp_shm_policy_fini(struct anon_map *, vnode_t *);
570 lgrp_mem_policy_info_t *lgrp_shm_policy_get(struct anon_map *, ulong_t,
571 vnode_t *, u_offset_t);
572 int lgrp_shm_policy_set(lgrp_mem_policy_t, struct anon_map *, ulong_t,
573 vnode_t *, u_offset_t, size_t);
574
575 /*
576 * Used by numat driver
577 */
578 int lgrp_query_cpu(processorid_t, lgrp_id_t *);
579 int lgrp_query_load(processorid_t, lgrp_load_t *);
580
581 /*
582 * lgroup thread placement
583 */
584 lpl_t *lgrp_affinity_best(kthread_t *, struct cpupart *, lgrp_id_t,
585 boolean_t);
586 void lgrp_affinity_init(lgrp_affinity_t **);
587 void lgrp_affinity_free(lgrp_affinity_t **);
588 lpl_t *lgrp_choose(kthread_t *t, struct cpupart *);
589 lgrp_t *lgrp_home_lgrp(void);
590 lgrp_id_t lgrp_home_id(kthread_t *);
591 void lgrp_loadavg(lpl_t *, uint_t, int);
592 void lgrp_move_thread(kthread_t *, lpl_t *, int);
593 uint64_t lgrp_get_trthr_migrations(void);
594 void lgrp_update_trthr_migrations(uint64_t);
595
596 /*
597 * lgroup topology
598 */
599 int lgrp_leaf_add(lgrp_t *, lgrp_t **, int, klgrpset_t *);
600 int lgrp_leaf_delete(lgrp_t *, lgrp_t **, int, klgrpset_t *);
601 int lgrp_rsets_empty(klgrpset_t *);
602 int lgrp_rsets_member(klgrpset_t *, lgrp_id_t);
603 int lgrp_topo_flatten(int, lgrp_t **, int, klgrpset_t *);
604 int lgrp_topo_ht_limit(void);
605 int lgrp_topo_ht_limit_default(void);
606 int lgrp_topo_ht_limit_set(int);
607 int lgrp_topo_update(lgrp_t **, int, klgrpset_t *);
608
609 /*
610 * lpl topology
611 */
612 void lpl_topo_bootstrap(lpl_t *, int);
613 int lpl_topo_flatten(int);
614 int lpl_topo_verify(struct cpupart *);
615
616
617 /* platform interfaces */
618 void lgrp_plat_init(lgrp_init_stages_t);
619 lgrp_t *lgrp_plat_alloc(lgrp_id_t lgrpid);
620 void lgrp_plat_config(lgrp_config_flag_t, uintptr_t);
621 lgrp_handle_t lgrp_plat_cpu_to_hand(processorid_t);
622 lgrp_handle_t lgrp_plat_pfn_to_hand(pfn_t);
623 int lgrp_plat_max_lgrps(void);
624 pgcnt_t lgrp_plat_mem_size(lgrp_handle_t, lgrp_mem_query_t);
625 int lgrp_plat_latency(lgrp_handle_t, lgrp_handle_t);
626 lgrp_handle_t lgrp_plat_root_hand(void);
627
628 extern uint32_t lgrp_expand_proc_thresh;
629 extern uint32_t lgrp_expand_proc_diff;
630 extern pgcnt_t lgrp_mem_free_thresh;
631 extern uint32_t lgrp_loadavg_tolerance;
632 extern uint32_t lgrp_loadavg_max_effect;
633 extern uint32_t lgrp_load_thresh;
634 extern lgrp_mem_policy_t lgrp_mem_policy_root;
635
636 #endif /* _KERNEL || _FAKE_KERNEL || _KMEMUSER */
637
638 #ifdef __cplusplus
639 }
640 #endif
641
642 #endif /* _LGRP_H */