2 * Copyright (c) 2015 Adrian Chadd <adrian@FreeBSD.org>.
5 * Redistribution and use in source and binary forms, with or without
6 * modification, are permitted provided that the following conditions
8 * 1. Redistributions of source code must retain the above copyright
9 * notice, this list of conditions and the following disclaimer,
10 * without modification.
11 * 2. Redistributions in binary form must reproduce at minimum a disclaimer
12 * similar to the "NO WARRANTY" disclaimer below ("Disclaimer") and any
13 * redistribution must be conditioned upon including a substantially
14 * similar Disclaimer requirement for further binary redistribution.
17 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
18 * ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
19 * LIMITED TO, THE IMPLIED WARRANTIES OF NONINFRINGEMENT, MERCHANTIBILITY
20 * AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL
21 * THE COPYRIGHT HOLDERS OR CONTRIBUTORS BE LIABLE FOR SPECIAL, EXEMPLARY,
22 * OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
23 * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
24 * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
25 * IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
26 * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF
27 * THE POSSIBILITY OF SUCH DAMAGES.
30 #include <sys/cdefs.h>
31 __FBSDID("$FreeBSD$");
36 #include <sys/param.h>
37 #include <sys/systm.h>
39 #include <sys/kernel.h>
40 #include <sys/malloc.h>
41 #include <sys/mutex.h>
45 #include <sys/queue.h>
46 #include <sys/rwlock.h>
48 #include <sys/sysctl.h>
50 #include <sys/vmmeter.h>
56 #include <vm/vm_param.h>
57 #include <vm/vm_kern.h>
58 #include <vm/vm_object.h>
59 #include <vm/vm_page.h>
60 #include <vm/vm_phys.h>
62 #include <vm/vm_domain.h>
66 vm_domain_rr_selectdomain(int skip_domain)
73 td->td_dom_rr_idx %= vm_ndomains;
76 * If skip_domain is provided then skip over that
77 * domain. This is intended for round robin variants
78 * which first try a fixed domain.
80 if ((skip_domain > -1) && (td->td_dom_rr_idx == skip_domain)) {
82 td->td_dom_rr_idx %= vm_ndomains;
84 return (td->td_dom_rr_idx);
89 * This implements a very simple set of VM domain memory allocation
90 * policies and iterators.
94 * A VM domain policy represents a desired VM domain policy.
95 * Iterators implement searching through VM domains in a specific
100 * When setting a policy, the caller must establish their own
101 * exclusive write protection for the contents of the domain
105 vm_domain_policy_init(struct vm_domain_policy *vp)
108 bzero(vp, sizeof(*vp));
109 vp->p.policy = VM_POLICY_NONE;
115 vm_domain_policy_set(struct vm_domain_policy *vp,
116 vm_domain_policy_type_t vt, int domain)
119 seq_write_begin(&vp->seq);
121 vp->p.domain = domain;
122 seq_write_end(&vp->seq);
127 * Take a local copy of a policy.
129 * The destination policy isn't write-barriered; this is used
130 * for doing local copies into something that isn't shared.
133 vm_domain_policy_localcopy(struct vm_domain_policy *dst,
134 const struct vm_domain_policy *src)
139 seq = seq_read(&src->seq);
141 if (seq_consistent(&src->seq, seq))
148 * Take a write-barrier copy of a policy.
150 * The destination policy is write -barriered; this is used
151 * for doing copies into policies that may be read by other
155 vm_domain_policy_copy(struct vm_domain_policy *dst,
156 const struct vm_domain_policy *src)
159 struct vm_domain_policy d;
162 seq = seq_read(&src->seq);
164 if (seq_consistent(&src->seq, seq)) {
165 seq_write_begin(&dst->seq);
166 dst->p.domain = d.p.domain;
167 dst->p.policy = d.p.policy;
168 seq_write_end(&dst->seq);
176 vm_domain_policy_validate(const struct vm_domain_policy *vp)
179 switch (vp->p.policy) {
181 case VM_POLICY_ROUND_ROBIN:
182 case VM_POLICY_FIRST_TOUCH:
183 case VM_POLICY_FIRST_TOUCH_ROUND_ROBIN:
184 if (vp->p.domain == -1)
187 case VM_POLICY_FIXED_DOMAIN:
188 case VM_POLICY_FIXED_DOMAIN_ROUND_ROBIN:
190 if (vp->p.domain >= 0 && vp->p.domain < vm_ndomains)
193 if (vp->p.domain == 0)
204 vm_domain_policy_cleanup(struct vm_domain_policy *vp)
212 vm_domain_iterator_init(struct vm_domain_iterator *vi)
215 /* Nothing to do for now */
220 * Manually setup an iterator with the given details.
223 vm_domain_iterator_set(struct vm_domain_iterator *vi,
224 vm_domain_policy_type_t vt, int domain)
229 case VM_POLICY_FIXED_DOMAIN:
230 vi->policy = VM_POLICY_FIXED_DOMAIN;
234 case VM_POLICY_FIXED_DOMAIN_ROUND_ROBIN:
235 vi->policy = VM_POLICY_FIXED_DOMAIN_ROUND_ROBIN;
239 case VM_POLICY_FIRST_TOUCH:
240 vi->policy = VM_POLICY_FIRST_TOUCH;
241 vi->domain = PCPU_GET(domain);
244 case VM_POLICY_FIRST_TOUCH_ROUND_ROBIN:
245 vi->policy = VM_POLICY_FIRST_TOUCH_ROUND_ROBIN;
246 vi->domain = PCPU_GET(domain);
249 case VM_POLICY_ROUND_ROBIN:
251 vi->policy = VM_POLICY_ROUND_ROBIN;
264 * Setup an iterator based on the given policy.
267 _vm_domain_iterator_set_policy(struct vm_domain_iterator *vi,
268 const struct vm_domain_policy *vt)
273 * Initialise the iterator.
275 * For first-touch, the initial domain is set
276 * via the current thread CPU domain.
278 * For fixed-domain, it's assumed that the
279 * caller has initialised the specific domain
282 switch (vt->p.policy) {
283 case VM_POLICY_FIXED_DOMAIN:
284 vi->policy = vt->p.policy;
285 vi->domain = vt->p.domain;
288 case VM_POLICY_FIXED_DOMAIN_ROUND_ROBIN:
289 vi->policy = vt->p.policy;
290 vi->domain = vt->p.domain;
293 case VM_POLICY_FIRST_TOUCH:
294 vi->policy = vt->p.policy;
295 vi->domain = PCPU_GET(domain);
298 case VM_POLICY_FIRST_TOUCH_ROUND_ROBIN:
299 vi->policy = vt->p.policy;
300 vi->domain = PCPU_GET(domain);
303 case VM_POLICY_ROUND_ROBIN:
306 * Default to round-robin policy.
308 vi->policy = VM_POLICY_ROUND_ROBIN;
320 vm_domain_iterator_set_policy(struct vm_domain_iterator *vi,
321 const struct vm_domain_policy *vt)
324 struct vm_domain_policy vt_lcl;
327 seq = seq_read(&vt->seq);
329 if (seq_consistent(&vt->seq, seq)) {
330 _vm_domain_iterator_set_policy(vi, &vt_lcl);
338 * Return the next VM domain to use.
340 * Returns 0 w/ domain set to the next domain to use, or
341 * -1 to indicate no more domains are available.
344 vm_domain_iterator_run(struct vm_domain_iterator *vi, int *domain)
347 /* General catch-all */
352 switch (vi->policy) {
353 case VM_POLICY_FIXED_DOMAIN:
354 case VM_POLICY_FIRST_TOUCH:
355 *domain = vi->domain;
358 case VM_POLICY_FIXED_DOMAIN_ROUND_ROBIN:
359 case VM_POLICY_FIRST_TOUCH_ROUND_ROBIN:
361 * XXX TODO: skip over the rr'ed domain
362 * if it equals the one we started with.
364 if (vi->n == vm_ndomains)
365 *domain = vi->domain;
367 *domain = vm_domain_rr_selectdomain(vi->domain);
370 case VM_POLICY_ROUND_ROBIN:
372 *domain = vm_domain_rr_selectdomain(-1);
385 * Returns 1 if the iteration is done, or 0 if it has not.
387 * This can only be called after at least one loop through
388 * the iterator. Ie, it's designed to be used as a tail
389 * check of a loop, not the head check of a loop.
392 vm_domain_iterator_isdone(struct vm_domain_iterator *vi)
399 vm_domain_iterator_cleanup(struct vm_domain_iterator *vi)