FreeBSD/Linux Kernel Cross Reference
sys/sys/cpuset.h
1 /*-
2 * SPDX-License-Identifier: BSD-2-Clause-FreeBSD
3 *
4 * Copyright (c) 2008, Jeffrey Roberson <jeff@freebsd.org>
5 * All rights reserved.
6 *
7 * Copyright (c) 2008 Nokia Corporation
8 * All rights reserved.
9 *
10 * Redistribution and use in source and binary forms, with or without
11 * modification, are permitted provided that the following conditions
12 * are met:
13 * 1. Redistributions of source code must retain the above copyright
14 * notice unmodified, this list of conditions, and the following
15 * disclaimer.
16 * 2. Redistributions in binary form must reproduce the above copyright
17 * notice, this list of conditions and the following disclaimer in the
18 * documentation and/or other materials provided with the distribution.
19 *
20 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
21 * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
22 * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
23 * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
24 * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
25 * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
26 * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
27 * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
28 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
29 * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
30 *
31 * $FreeBSD$
32 */
33
34 #ifndef _SYS_CPUSET_H_
35 #define _SYS_CPUSET_H_
36
37 #include <sys/_cpuset.h>
38
39 #include <sys/bitset.h>
40
41 #define _NCPUBITS _BITSET_BITS
42 #define _NCPUWORDS __bitset_words(CPU_SETSIZE)
43
44 #define CPUSETBUFSIZ ((2 + sizeof(long) * 2) * _NCPUWORDS)
45
46 #define CPU_CLR(n, p) BIT_CLR(CPU_SETSIZE, n, p)
47 #define CPU_COPY(f, t) BIT_COPY(CPU_SETSIZE, f, t)
48 #define CPU_ISSET(n, p) BIT_ISSET(CPU_SETSIZE, n, p)
49 #define CPU_SET(n, p) BIT_SET(CPU_SETSIZE, n, p)
50 #define CPU_ZERO(p) BIT_ZERO(CPU_SETSIZE, p)
51 #define CPU_FILL(p) BIT_FILL(CPU_SETSIZE, p)
52 #define CPU_SETOF(n, p) BIT_SETOF(CPU_SETSIZE, n, p)
53 #define CPU_EMPTY(p) BIT_EMPTY(CPU_SETSIZE, p)
54 #define CPU_ISFULLSET(p) BIT_ISFULLSET(CPU_SETSIZE, p)
55 #define CPU_SUBSET(p, c) BIT_SUBSET(CPU_SETSIZE, p, c)
56 #define CPU_OVERLAP(p, c) BIT_OVERLAP(CPU_SETSIZE, p, c)
57 #define CPU_CMP(p, c) BIT_CMP(CPU_SETSIZE, p, c)
58 #define CPU_OR(d, s) BIT_OR(CPU_SETSIZE, d, s)
59 #define CPU_AND(d, s) BIT_AND(CPU_SETSIZE, d, s)
60 #define CPU_NAND(d, s) BIT_NAND(CPU_SETSIZE, d, s)
61 #define CPU_CLR_ATOMIC(n, p) BIT_CLR_ATOMIC(CPU_SETSIZE, n, p)
62 #define CPU_SET_ATOMIC(n, p) BIT_SET_ATOMIC(CPU_SETSIZE, n, p)
63 #define CPU_SET_ATOMIC_ACQ(n, p) BIT_SET_ATOMIC_ACQ(CPU_SETSIZE, n, p)
64 #define CPU_AND_ATOMIC(n, p) BIT_AND_ATOMIC(CPU_SETSIZE, n, p)
65 #define CPU_OR_ATOMIC(d, s) BIT_OR_ATOMIC(CPU_SETSIZE, d, s)
66 #define CPU_COPY_STORE_REL(f, t) BIT_COPY_STORE_REL(CPU_SETSIZE, f, t)
67 #define CPU_FFS(p) BIT_FFS(CPU_SETSIZE, p)
68 #define CPU_FLS(p) BIT_FLS(CPU_SETSIZE, p)
69 #define CPU_COUNT(p) BIT_COUNT(CPU_SETSIZE, p)
70 #define CPUSET_FSET BITSET_FSET(_NCPUWORDS)
71 #define CPUSET_T_INITIALIZER BITSET_T_INITIALIZER
72
73 /*
74 * Valid cpulevel_t values.
75 */
76 #define CPU_LEVEL_ROOT 1 /* All system cpus. */
77 #define CPU_LEVEL_CPUSET 2 /* Available cpus for which. */
78 #define CPU_LEVEL_WHICH 3 /* Actual mask/id for which. */
79
80 /*
81 * Valid cpuwhich_t values.
82 */
83 #define CPU_WHICH_TID 1 /* Specifies a thread id. */
84 #define CPU_WHICH_PID 2 /* Specifies a process id. */
85 #define CPU_WHICH_CPUSET 3 /* Specifies a set id. */
86 #define CPU_WHICH_IRQ 4 /* Specifies an irq #. */
87 #define CPU_WHICH_JAIL 5 /* Specifies a jail id. */
88 #define CPU_WHICH_DOMAIN 6 /* Specifies a NUMA domain id. */
89 #define CPU_WHICH_INTRHANDLER 7 /* Specifies an irq # (not ithread). */
90 #define CPU_WHICH_ITHREAD 8 /* Specifies an irq's ithread. */
91
92 /*
93 * Reserved cpuset identifiers.
94 */
95 #define CPUSET_INVALID -1
96 #define CPUSET_DEFAULT 0
97
98 #ifdef _KERNEL
99 #include <sys/queue.h>
100
101 LIST_HEAD(setlist, cpuset);
102
103 /*
104 * cpusets encapsulate cpu binding information for one or more threads.
105 *
106 * a - Accessed with atomics.
107 * s - Set at creation, never modified. Only a ref required to read.
108 * c - Locked internally by a cpuset lock.
109 *
110 * The bitmask is only modified while holding the cpuset lock. It may be
111 * read while only a reference is held but the consumer must be prepared
112 * to deal with inconsistent results.
113 */
114 struct cpuset {
115 cpuset_t cs_mask; /* bitmask of valid cpus. */
116 struct domainset *cs_domain; /* (c) NUMA policy. */
117 volatile u_int cs_ref; /* (a) Reference count. */
118 int cs_flags; /* (s) Flags from below. */
119 cpusetid_t cs_id; /* (s) Id or INVALID. */
120 struct cpuset *cs_parent; /* (s) Pointer to our parent. */
121 LIST_ENTRY(cpuset) cs_link; /* (c) All identified sets. */
122 LIST_ENTRY(cpuset) cs_siblings; /* (c) Sibling set link. */
123 struct setlist cs_children; /* (c) List of children. */
124 };
125
126 #define CPU_SET_ROOT 0x0001 /* Set is a root set. */
127 #define CPU_SET_RDONLY 0x0002 /* No modification allowed. */
128
129 extern cpuset_t *cpuset_root;
130 struct prison;
131 struct proc;
132 struct thread;
133
134 /*
135 * Callbacks for copying in/out a cpuset or domainset. Used for alternate
136 * ABIs, like compat32.
137 */
138 struct cpuset_copy_cb {
139 int (*cpuset_copyin)(const void *, void *, size_t);
140 int (*cpuset_copyout)(const void *, void *, size_t);
141 };
142
143 struct cpuset *cpuset_thread0(void);
144 struct cpuset *cpuset_ref(struct cpuset *);
145 void cpuset_rel(struct cpuset *);
146 int cpuset_setthread(lwpid_t id, cpuset_t *);
147 int cpuset_setithread(lwpid_t id, int cpu);
148 int cpuset_create_root(struct prison *, struct cpuset **);
149 int cpuset_setproc_update_set(struct proc *, struct cpuset *);
150 int cpuset_which(cpuwhich_t, id_t, struct proc **,
151 struct thread **, struct cpuset **);
152 void cpuset_kernthread(struct thread *);
153
154 char *cpusetobj_strprint(char *, const cpuset_t *);
155 int cpusetobj_strscan(cpuset_t *, const char *);
156 #ifdef DDB
157 void ddb_display_cpuset(const cpuset_t *);
158 #endif
159
160 #else
161 __BEGIN_DECLS
162 int cpuset(cpusetid_t *);
163 int cpuset_setid(cpuwhich_t, id_t, cpusetid_t);
164 int cpuset_getid(cpulevel_t, cpuwhich_t, id_t, cpusetid_t *);
165 int cpuset_getaffinity(cpulevel_t, cpuwhich_t, id_t, size_t, cpuset_t *);
166 int cpuset_setaffinity(cpulevel_t, cpuwhich_t, id_t, size_t, const cpuset_t *);
167 __END_DECLS
168 #endif
169 #endif /* !_SYS_CPUSET_H_ */
Cache object: d985740e59a8916b39c47042fade8b0d
|