memory_hotplug.c 49.2 KB
Newer Older
1 2 3 4 5 6 7 8
/*
 *  linux/mm/memory_hotplug.c
 *
 *  Copyright (C)
 */

#include <linux/stddef.h>
#include <linux/mm.h>
9
#include <linux/sched/signal.h>
10 11 12 13
#include <linux/swap.h>
#include <linux/interrupt.h>
#include <linux/pagemap.h>
#include <linux/compiler.h>
14
#include <linux/export.h>
15
#include <linux/pagevec.h>
16
#include <linux/writeback.h>
17 18 19 20
#include <linux/slab.h>
#include <linux/sysctl.h>
#include <linux/cpu.h>
#include <linux/memory.h>
21
#include <linux/memremap.h>
22 23 24
#include <linux/memory_hotplug.h>
#include <linux/highmem.h>
#include <linux/vmalloc.h>
25
#include <linux/ioport.h>
K
KAMEZAWA Hiroyuki 已提交
26 27 28
#include <linux/delay.h>
#include <linux/migrate.h>
#include <linux/page-isolation.h>
29
#include <linux/pfn.h>
30
#include <linux/suspend.h>
31
#include <linux/mm_inline.h>
32
#include <linux/firmware-map.h>
33
#include <linux/stop_machine.h>
34
#include <linux/hugetlb.h>
35
#include <linux/memblock.h>
36
#include <linux/bootmem.h>
37
#include <linux/compaction.h>
38
#include <linux/rmap.h>
39 40 41

#include <asm/tlbflush.h>

42 43
#include "internal.h"

44 45 46 47 48 49 50 51 52 53
/*
 * online_page_callback contains pointer to current page onlining function.
 * Initially it is generic_online_page(). If it is required it could be
 * changed by calling set_online_page_callback() for callback registration
 * and restore_online_page_callback() for generic callback restore.
 */

static void generic_online_page(struct page *page);

static online_page_callback_t online_page_callback = generic_online_page;
54
static DEFINE_MUTEX(online_page_callback_lock);
55

56
DEFINE_STATIC_PERCPU_RWSEM(mem_hotplug_lock);
57

58 59 60 61
void get_online_mems(void)
{
	percpu_down_read(&mem_hotplug_lock);
}
62

63 64 65 66
void put_online_mems(void)
{
	percpu_up_read(&mem_hotplug_lock);
}
67

68 69
bool movable_node_enabled = false;

70
#ifndef CONFIG_MEMORY_HOTPLUG_DEFAULT_ONLINE
71
bool memhp_auto_online;
72 73 74
#else
bool memhp_auto_online = true;
#endif
75 76
EXPORT_SYMBOL_GPL(memhp_auto_online);

77 78 79 80 81 82 83 84 85 86 87
static int __init setup_memhp_default_state(char *str)
{
	if (!strcmp(str, "online"))
		memhp_auto_online = true;
	else if (!strcmp(str, "offline"))
		memhp_auto_online = false;

	return 1;
}
__setup("memhp_default_state=", setup_memhp_default_state);

88
void mem_hotplug_begin(void)
89
{
90 91
	cpus_read_lock();
	percpu_down_write(&mem_hotplug_lock);
92 93
}

94
void mem_hotplug_done(void)
95
{
96 97
	percpu_up_write(&mem_hotplug_lock);
	cpus_read_unlock();
98
}
99

100 101 102
/* add this memory to iomem resource */
static struct resource *register_memory_resource(u64 start, u64 size)
{
103
	struct resource *res, *conflict;
104
	res = kzalloc(sizeof(struct resource), GFP_KERNEL);
105 106
	if (!res)
		return ERR_PTR(-ENOMEM);
107 108 109 110

	res->name = "System RAM";
	res->start = start;
	res->end = start + size - 1;
111
	res->flags = IORESOURCE_SYSTEM_RAM | IORESOURCE_BUSY;
112 113
	conflict =  request_resource_conflict(&iomem_resource, res);
	if (conflict) {
114
		pr_debug("System RAM resource %pR cannot be added\n", res);
115
		kfree(res);
116
		return ERR_PTR(-EEXIST);
117 118 119 120 121 122 123 124 125 126 127 128 129
	}
	return res;
}

static void release_memory_resource(struct resource *res)
{
	if (!res)
		return;
	release_resource(res);
	kfree(res);
	return;
}

130
#ifdef CONFIG_MEMORY_HOTPLUG_SPARSE
131 132
void get_page_bootmem(unsigned long info,  struct page *page,
		      unsigned long type)
133
{
134
	page->freelist = (void *)type;
135 136
	SetPagePrivate(page);
	set_page_private(page, info);
137
	page_ref_inc(page);
138 139
}

140
void put_page_bootmem(struct page *page)
141
{
A
Andrea Arcangeli 已提交
142
	unsigned long type;
143

144
	type = (unsigned long) page->freelist;
A
Andrea Arcangeli 已提交
145 146
	BUG_ON(type < MEMORY_HOTPLUG_MIN_BOOTMEM_TYPE ||
	       type > MEMORY_HOTPLUG_MAX_BOOTMEM_TYPE);
147

148
	if (page_ref_dec_return(page) == 1) {
149
		page->freelist = NULL;
150 151
		ClearPagePrivate(page);
		set_page_private(page, 0);
A
Andrea Arcangeli 已提交
152
		INIT_LIST_HEAD(&page->lru);
153
		free_reserved_page(page);
154 155 156
	}
}

157 158
#ifdef CONFIG_HAVE_BOOTMEM_INFO_NODE
#ifndef CONFIG_SPARSEMEM_VMEMMAP
159
static void register_page_bootmem_info_section(unsigned long start_pfn)
160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182
{
	unsigned long *usemap, mapsize, section_nr, i;
	struct mem_section *ms;
	struct page *page, *memmap;

	section_nr = pfn_to_section_nr(start_pfn);
	ms = __nr_to_section(section_nr);

	/* Get section's memmap address */
	memmap = sparse_decode_mem_map(ms->section_mem_map, section_nr);

	/*
	 * Get page for the memmap's phys address
	 * XXX: need more consideration for sparse_vmemmap...
	 */
	page = virt_to_page(memmap);
	mapsize = sizeof(struct page) * PAGES_PER_SECTION;
	mapsize = PAGE_ALIGN(mapsize) >> PAGE_SHIFT;

	/* remember memmap's page */
	for (i = 0; i < mapsize; i++, page++)
		get_page_bootmem(section_nr, page, SECTION_INFO);

183
	usemap = ms->pageblock_flags;
184 185 186 187 188
	page = virt_to_page(usemap);

	mapsize = PAGE_ALIGN(usemap_size()) >> PAGE_SHIFT;

	for (i = 0; i < mapsize; i++, page++)
189
		get_page_bootmem(section_nr, page, MIX_SECTION_INFO);
190 191

}
192 193 194 195 196 197 198 199 200 201 202 203 204 205
#else /* CONFIG_SPARSEMEM_VMEMMAP */
static void register_page_bootmem_info_section(unsigned long start_pfn)
{
	unsigned long *usemap, mapsize, section_nr, i;
	struct mem_section *ms;
	struct page *page, *memmap;

	section_nr = pfn_to_section_nr(start_pfn);
	ms = __nr_to_section(section_nr);

	memmap = sparse_decode_mem_map(ms->section_mem_map, section_nr);

	register_page_bootmem_memmap(section_nr, memmap, PAGES_PER_SECTION);

206
	usemap = ms->pageblock_flags;
207 208 209 210 211 212 213 214
	page = virt_to_page(usemap);

	mapsize = PAGE_ALIGN(usemap_size()) >> PAGE_SHIFT;

	for (i = 0; i < mapsize; i++, page++)
		get_page_bootmem(section_nr, page, MIX_SECTION_INFO);
}
#endif /* !CONFIG_SPARSEMEM_VMEMMAP */
215

216
void __init register_page_bootmem_info_node(struct pglist_data *pgdat)
217 218 219 220 221 222 223 224 225 226 227 228
{
	unsigned long i, pfn, end_pfn, nr_pages;
	int node = pgdat->node_id;
	struct page *page;

	nr_pages = PAGE_ALIGN(sizeof(struct pglist_data)) >> PAGE_SHIFT;
	page = virt_to_page(pgdat);

	for (i = 0; i < nr_pages; i++, page++)
		get_page_bootmem(node, page, NODE_INFO);

	pfn = pgdat->node_start_pfn;
229
	end_pfn = pgdat_end_pfn(pgdat);
230

231
	/* register section info */
232 233 234 235 236
	for (; pfn < end_pfn; pfn += PAGES_PER_SECTION) {
		/*
		 * Some platforms can assign the same pfn to multiple nodes - on
		 * node0 as well as nodeN.  To avoid registering a pfn against
		 * multiple nodes we check that this pfn does not already
237
		 * reside in some other nodes.
238
		 */
239
		if (pfn_valid(pfn) && (early_pfn_to_nid(pfn) == node))
240 241
			register_page_bootmem_info_section(pfn);
	}
242
}
243
#endif /* CONFIG_HAVE_BOOTMEM_INFO_NODE */
244

245
static int __meminit __add_section(int nid, unsigned long phys_start_pfn,
246
		struct vmem_altmap *altmap, bool want_memblock)
247 248 249
{
	int ret;

250 251 252
	if (pfn_valid(phys_start_pfn))
		return -EEXIST;

253
	ret = sparse_add_one_section(NODE_DATA(nid), phys_start_pfn, altmap);
254 255 256
	if (ret < 0)
		return ret;

257 258 259
	if (!want_memblock)
		return 0;

260
	return hotplug_memory_register(nid, __pfn_to_section(phys_start_pfn));
261 262
}

263 264 265 266 267 268
/*
 * Reasonably generic function for adding memory.  It is
 * expected that archs that support memory hotplug will
 * call this function after deciding the zone to which to
 * add the new pages.
 */
269
int __ref __add_pages(int nid, unsigned long phys_start_pfn,
270 271
		unsigned long nr_pages, struct vmem_altmap *altmap,
		bool want_memblock)
272 273 274 275
{
	unsigned long i;
	int err = 0;
	int start_sec, end_sec;
276

277 278 279 280
	/* during initialize mem_map, align hot-added range to section */
	start_sec = pfn_to_section_nr(phys_start_pfn);
	end_sec = pfn_to_section_nr(phys_start_pfn + nr_pages - 1);

281 282 283 284 285 286 287
	if (altmap) {
		/*
		 * Validate altmap is within bounds of the total request
		 */
		if (altmap->base_pfn != phys_start_pfn
				|| vmem_altmap_offset(altmap) > nr_pages) {
			pr_warn_once("memory add fail, invalid altmap\n");
288 289
			err = -EINVAL;
			goto out;
290 291 292 293
		}
		altmap->alloc = 0;
	}

294
	for (i = start_sec; i <= end_sec; i++) {
295 296
		err = __add_section(nid, section_nr_to_pfn(i), altmap,
				want_memblock);
297 298 299 300 301 302 303 304 305

		/*
		 * EEXIST is finally dealt with by ioresource collision
		 * check. see add_memory() => register_memory_resource()
		 * Warning will be printed if there is collision.
		 */
		if (err && (err != -EEXIST))
			break;
		err = 0;
306
		cond_resched();
307
	}
308
	vmemmap_populate_print_last();
309
out:
310 311 312 313
	return err;
}

#ifdef CONFIG_MEMORY_HOTREMOVE
314
/* find the smallest valid pfn in the range [start_pfn, end_pfn) */
315
static unsigned long find_smallest_section_pfn(int nid, struct zone *zone,
316 317 318 319
				     unsigned long start_pfn,
				     unsigned long end_pfn)
{
	for (; start_pfn < end_pfn; start_pfn += PAGES_PER_SECTION) {
320
		if (unlikely(!pfn_to_online_page(start_pfn)))
321 322 323 324 325 326 327 328 329 330 331 332 333 334 335
			continue;

		if (unlikely(pfn_to_nid(start_pfn) != nid))
			continue;

		if (zone && zone != page_zone(pfn_to_page(start_pfn)))
			continue;

		return start_pfn;
	}

	return 0;
}

/* find the biggest valid pfn in the range [start_pfn, end_pfn). */
336
static unsigned long find_biggest_section_pfn(int nid, struct zone *zone,
337 338 339 340 341 342 343 344
				    unsigned long start_pfn,
				    unsigned long end_pfn)
{
	unsigned long pfn;

	/* pfn is the end pfn of a memory section. */
	pfn = end_pfn - 1;
	for (; pfn >= start_pfn; pfn -= PAGES_PER_SECTION) {
345
		if (unlikely(!pfn_to_online_page(pfn)))
346 347 348 349 350 351 352 353 354 355 356 357 358 359 360 361 362
			continue;

		if (unlikely(pfn_to_nid(pfn) != nid))
			continue;

		if (zone && zone != page_zone(pfn_to_page(pfn)))
			continue;

		return pfn;
	}

	return 0;
}

static void shrink_zone_span(struct zone *zone, unsigned long start_pfn,
			     unsigned long end_pfn)
{
363 364 365
	unsigned long zone_start_pfn = zone->zone_start_pfn;
	unsigned long z = zone_end_pfn(zone); /* zone_end_pfn namespace clash */
	unsigned long zone_end_pfn = z;
366 367 368 369 370 371 372 373 374 375 376 377 378 379 380 381 382 383 384 385 386 387 388 389 390 391 392 393 394 395 396 397 398 399 400 401 402 403
	unsigned long pfn;
	int nid = zone_to_nid(zone);

	zone_span_writelock(zone);
	if (zone_start_pfn == start_pfn) {
		/*
		 * If the section is smallest section in the zone, it need
		 * shrink zone->zone_start_pfn and zone->zone_spanned_pages.
		 * In this case, we find second smallest valid mem_section
		 * for shrinking zone.
		 */
		pfn = find_smallest_section_pfn(nid, zone, end_pfn,
						zone_end_pfn);
		if (pfn) {
			zone->zone_start_pfn = pfn;
			zone->spanned_pages = zone_end_pfn - pfn;
		}
	} else if (zone_end_pfn == end_pfn) {
		/*
		 * If the section is biggest section in the zone, it need
		 * shrink zone->spanned_pages.
		 * In this case, we find second biggest valid mem_section for
		 * shrinking zone.
		 */
		pfn = find_biggest_section_pfn(nid, zone, zone_start_pfn,
					       start_pfn);
		if (pfn)
			zone->spanned_pages = pfn - zone_start_pfn + 1;
	}

	/*
	 * The section is not biggest or smallest mem_section in the zone, it
	 * only creates a hole in the zone. So in this case, we need not
	 * change the zone. But perhaps, the zone has only hole data. Thus
	 * it check the zone has only hole or not.
	 */
	pfn = zone_start_pfn;
	for (; pfn < zone_end_pfn; pfn += PAGES_PER_SECTION) {
404
		if (unlikely(!pfn_to_online_page(pfn)))
405 406 407 408 409 410 411 412 413 414 415 416 417 418 419 420 421 422 423 424
			continue;

		if (page_zone(pfn_to_page(pfn)) != zone)
			continue;

		 /* If the section is current section, it continues the loop */
		if (start_pfn == pfn)
			continue;

		/* If we find valid section, we have nothing to do */
		zone_span_writeunlock(zone);
		return;
	}

	/* The zone has no valid section */
	zone->zone_start_pfn = 0;
	zone->spanned_pages = 0;
	zone_span_writeunlock(zone);
}

425
static void update_pgdat_span(struct pglist_data *pgdat)
426
{
427 428 429 430 431 432 433 434 435
	unsigned long node_start_pfn = 0, node_end_pfn = 0;
	struct zone *zone;

	for (zone = pgdat->node_zones;
	     zone < pgdat->node_zones + MAX_NR_ZONES; zone++) {
		unsigned long zone_end_pfn = zone->zone_start_pfn +
					     zone->spanned_pages;

		/* No need to lock the zones, they can't change. */
436 437 438 439 440 441 442 443
		if (!zone->spanned_pages)
			continue;
		if (!node_end_pfn) {
			node_start_pfn = zone->zone_start_pfn;
			node_end_pfn = zone_end_pfn;
			continue;
		}

444 445 446 447
		if (zone_end_pfn > node_end_pfn)
			node_end_pfn = zone_end_pfn;
		if (zone->zone_start_pfn < node_start_pfn)
			node_start_pfn = zone->zone_start_pfn;
448 449
	}

450 451
	pgdat->node_start_pfn = node_start_pfn;
	pgdat->node_spanned_pages = node_end_pfn - node_start_pfn;
452 453 454 455 456 457 458 459
}

static void __remove_zone(struct zone *zone, unsigned long start_pfn)
{
	struct pglist_data *pgdat = zone->zone_pgdat;
	int nr_pages = PAGES_PER_SECTION;
	unsigned long flags;

460 461 462 463 464 465 466 467 468 469
#ifdef CONFIG_ZONE_DEVICE
	/*
	 * Zone shrinking code cannot properly deal with ZONE_DEVICE. So
	 * we will not try to shrink the zones - which is okay as
	 * set_zone_contiguous() cannot deal with ZONE_DEVICE either way.
	 */
	if (zone_idx(zone) == ZONE_DEVICE)
		return;
#endif

470 471
	pgdat_resize_lock(zone->zone_pgdat, &flags);
	shrink_zone_span(zone, start_pfn, start_pfn + nr_pages);
472
	update_pgdat_span(pgdat);
473 474 475
	pgdat_resize_unlock(zone->zone_pgdat, &flags);
}

476
static int __remove_section(struct zone *zone, struct mem_section *ms,
477
		unsigned long map_offset, struct vmem_altmap *altmap)
478
{
479 480
	unsigned long start_pfn;
	int scn_nr;
481 482 483 484 485 486 487 488 489
	int ret = -EINVAL;

	if (!valid_section(ms))
		return ret;

	ret = unregister_memory_section(ms);
	if (ret)
		return ret;

490
	scn_nr = __section_nr(ms);
491
	start_pfn = section_nr_to_pfn((unsigned long)scn_nr);
492 493
	__remove_zone(zone, start_pfn);

494
	sparse_remove_one_section(zone, ms, map_offset, altmap);
495 496 497 498 499 500 501 502
	return 0;
}

/**
 * __remove_pages() - remove sections of pages from a zone
 * @zone: zone from which pages need to be removed
 * @phys_start_pfn: starting pageframe (must be aligned to start of a section)
 * @nr_pages: number of pages to remove (must be multiple of section size)
503
 * @altmap: alternative device page map or %NULL if default memmap is used
504 505 506 507 508 509 510
 *
 * Generic helper function to remove section mappings and sysfs entries
 * for the section of the memory we are removing. Caller needs to make
 * sure that pages are marked reserved and zones are adjust properly by
 * calling offline_pages().
 */
int __remove_pages(struct zone *zone, unsigned long phys_start_pfn,
511
		 unsigned long nr_pages, struct vmem_altmap *altmap)
512
{
513
	unsigned long i;
514 515 516 517 518 519 520 521 522 523 524 525 526 527 528 529 530 531 532 533 534 535
	unsigned long map_offset = 0;
	int sections_to_remove, ret = 0;

	/* In the ZONE_DEVICE case device driver owns the memory region */
	if (is_dev_zone(zone)) {
		if (altmap)
			map_offset = vmem_altmap_offset(altmap);
	} else {
		resource_size_t start, size;

		start = phys_start_pfn << PAGE_SHIFT;
		size = nr_pages * PAGE_SIZE;

		ret = release_mem_region_adjustable(&iomem_resource, start,
					size);
		if (ret) {
			resource_size_t endres = start + size - 1;

			pr_warn("Unable to release resource <%pa-%pa> (%d)\n",
					&start, &endres, ret);
		}
	}
536

537 538
	clear_zone_contiguous(zone);

539 540 541 542 543 544 545 546 547
	/*
	 * We can only remove entire sections
	 */
	BUG_ON(phys_start_pfn & ~PAGE_SECTION_MASK);
	BUG_ON(nr_pages % PAGES_PER_SECTION);

	sections_to_remove = nr_pages / PAGES_PER_SECTION;
	for (i = 0; i < sections_to_remove; i++) {
		unsigned long pfn = phys_start_pfn + i*PAGES_PER_SECTION;
548

549
		cond_resched();
550 551
		ret = __remove_section(zone, __pfn_to_section(pfn), map_offset,
				altmap);
552
		map_offset = 0;
553 554 555
		if (ret)
			break;
	}
556 557 558

	set_zone_contiguous(zone);

559 560
	return ret;
}
561
#endif /* CONFIG_MEMORY_HOTREMOVE */
562

563 564 565 566
int set_online_page_callback(online_page_callback_t callback)
{
	int rc = -EINVAL;

567 568
	get_online_mems();
	mutex_lock(&online_page_callback_lock);
569 570 571 572 573 574

	if (online_page_callback == generic_online_page) {
		online_page_callback = callback;
		rc = 0;
	}

575 576
	mutex_unlock(&online_page_callback_lock);
	put_online_mems();
577 578 579 580 581 582 583 584 585

	return rc;
}
EXPORT_SYMBOL_GPL(set_online_page_callback);

int restore_online_page_callback(online_page_callback_t callback)
{
	int rc = -EINVAL;

586 587
	get_online_mems();
	mutex_lock(&online_page_callback_lock);
588 589 590 591 592 593

	if (online_page_callback == callback) {
		online_page_callback = generic_online_page;
		rc = 0;
	}

594 595
	mutex_unlock(&online_page_callback_lock);
	put_online_mems();
596 597 598 599 600 601

	return rc;
}
EXPORT_SYMBOL_GPL(restore_online_page_callback);

void __online_page_set_limits(struct page *page)
602
{
603 604 605 606 607
}
EXPORT_SYMBOL_GPL(__online_page_set_limits);

void __online_page_increment_counters(struct page *page)
{
608
	adjust_managed_page_count(page, 1);
609 610
}
EXPORT_SYMBOL_GPL(__online_page_increment_counters);
611

612 613
void __online_page_free(struct page *page)
{
614
	__free_reserved_page(page);
615
}
616 617 618 619 620 621 622 623
EXPORT_SYMBOL_GPL(__online_page_free);

static void generic_online_page(struct page *page)
{
	__online_page_set_limits(page);
	__online_page_increment_counters(page);
	__online_page_free(page);
}
624

625 626
static int online_pages_range(unsigned long start_pfn, unsigned long nr_pages,
			void *arg)
627 628
{
	unsigned long i;
629 630
	unsigned long onlined_pages = *(unsigned long *)arg;
	struct page *page;
631

632 633 634
	if (PageReserved(pfn_to_page(start_pfn)))
		for (i = 0; i < nr_pages; i++) {
			page = pfn_to_page(start_pfn + i);
635
			(*online_page_callback)(page);
636 637
			onlined_pages++;
		}
638 639 640

	online_mem_sections(start_pfn, start_pfn + nr_pages);

641 642 643 644
	*(unsigned long *)arg = onlined_pages;
	return 0;
}

645 646 647 648 649 650 651 652
/* check which state of node_states will be changed when online memory */
static void node_states_check_changes_online(unsigned long nr_pages,
	struct zone *zone, struct memory_notify *arg)
{
	int nid = zone_to_nid(zone);
	enum zone_type zone_last = ZONE_NORMAL;

	/*
653 654 655
	 * If we have HIGHMEM or movable node, node_states[N_NORMAL_MEMORY]
	 * contains nodes which have zones of 0...ZONE_NORMAL,
	 * set zone_last to ZONE_NORMAL.
656
	 *
657 658 659
	 * If we don't have HIGHMEM nor movable node,
	 * node_states[N_NORMAL_MEMORY] contains nodes which have zones of
	 * 0...ZONE_MOVABLE, set zone_last to ZONE_MOVABLE.
660
	 */
661
	if (N_MEMORY == N_NORMAL_MEMORY)
662 663 664 665 666 667 668 669 670 671 672 673 674
		zone_last = ZONE_MOVABLE;

	/*
	 * if the memory to be online is in a zone of 0...zone_last, and
	 * the zones of 0...zone_last don't have memory before online, we will
	 * need to set the node to node_states[N_NORMAL_MEMORY] after
	 * the memory is online.
	 */
	if (zone_idx(zone) <= zone_last && !node_state(nid, N_NORMAL_MEMORY))
		arg->status_change_nid_normal = nid;
	else
		arg->status_change_nid_normal = -1;

675 676 677 678 679 680 681 682 683 684 685 686 687 688 689 690 691 692 693 694 695 696
#ifdef CONFIG_HIGHMEM
	/*
	 * If we have movable node, node_states[N_HIGH_MEMORY]
	 * contains nodes which have zones of 0...ZONE_HIGHMEM,
	 * set zone_last to ZONE_HIGHMEM.
	 *
	 * If we don't have movable node, node_states[N_NORMAL_MEMORY]
	 * contains nodes which have zones of 0...ZONE_MOVABLE,
	 * set zone_last to ZONE_MOVABLE.
	 */
	zone_last = ZONE_HIGHMEM;
	if (N_MEMORY == N_HIGH_MEMORY)
		zone_last = ZONE_MOVABLE;

	if (zone_idx(zone) <= zone_last && !node_state(nid, N_HIGH_MEMORY))
		arg->status_change_nid_high = nid;
	else
		arg->status_change_nid_high = -1;
#else
	arg->status_change_nid_high = arg->status_change_nid_normal;
#endif

697 698
	/*
	 * if the node don't have memory befor online, we will need to
699
	 * set the node to node_states[N_MEMORY] after the memory
700 701
	 * is online.
	 */
702
	if (!node_state(nid, N_MEMORY))
703 704 705 706 707 708 709 710 711 712
		arg->status_change_nid = nid;
	else
		arg->status_change_nid = -1;
}

static void node_states_set_node(int node, struct memory_notify *arg)
{
	if (arg->status_change_nid_normal >= 0)
		node_set_state(node, N_NORMAL_MEMORY);

713 714 715 716
	if (arg->status_change_nid_high >= 0)
		node_set_state(node, N_HIGH_MEMORY);

	node_set_state(node, N_MEMORY);
717 718
}

719 720 721 722 723 724 725 726 727 728 729 730 731 732 733 734 735 736 737 738 739 740
static void __meminit resize_zone_range(struct zone *zone, unsigned long start_pfn,
		unsigned long nr_pages)
{
	unsigned long old_end_pfn = zone_end_pfn(zone);

	if (zone_is_empty(zone) || start_pfn < zone->zone_start_pfn)
		zone->zone_start_pfn = start_pfn;

	zone->spanned_pages = max(start_pfn + nr_pages, old_end_pfn) - zone->zone_start_pfn;
}

static void __meminit resize_pgdat_range(struct pglist_data *pgdat, unsigned long start_pfn,
                                     unsigned long nr_pages)
{
	unsigned long old_end_pfn = pgdat_end_pfn(pgdat);

	if (!pgdat->node_spanned_pages || start_pfn < pgdat->node_start_pfn)
		pgdat->node_start_pfn = start_pfn;

	pgdat->node_spanned_pages = max(start_pfn + nr_pages, old_end_pfn) - pgdat->node_start_pfn;
}

741 742
void __ref move_pfn_range_to_zone(struct zone *zone, unsigned long start_pfn,
		unsigned long nr_pages, struct vmem_altmap *altmap)
743 744 745 746
{
	struct pglist_data *pgdat = zone->zone_pgdat;
	int nid = pgdat->node_id;
	unsigned long flags;
747

748 749
	if (zone_is_empty(zone))
		init_currently_empty_zone(zone, start_pfn, nr_pages);
750

751 752 753 754 755 756 757 758 759 760 761 762 763 764 765 766
	clear_zone_contiguous(zone);

	/* TODO Huh pgdat is irqsave while zone is not. It used to be like that before */
	pgdat_resize_lock(pgdat, &flags);
	zone_span_writelock(zone);
	resize_zone_range(zone, start_pfn, nr_pages);
	zone_span_writeunlock(zone);
	resize_pgdat_range(pgdat, start_pfn, nr_pages);
	pgdat_resize_unlock(pgdat, &flags);

	/*
	 * TODO now we have a visible range of pages which are not associated
	 * with their zone properly. Not nice but set_pfnblock_flags_mask
	 * expects the zone spans the pfn range. All the pages in the range
	 * are reserved so nobody should be touching them so we should be safe
	 */
767 768
	memmap_init_zone(nr_pages, nid, zone_idx(zone), start_pfn,
			MEMMAP_HOTPLUG, altmap);
769 770 771 772

	set_zone_contiguous(zone);
}

773 774 775 776 777
/*
 * Returns a default kernel memory zone for the given pfn range.
 * If no kernel zone covers this pfn range it will automatically go
 * to the ZONE_NORMAL.
 */
778
static struct zone *default_kernel_zone_for_pfn(int nid, unsigned long start_pfn,
779 780 781 782 783 784 785 786 787 788 789 790 791 792 793
		unsigned long nr_pages)
{
	struct pglist_data *pgdat = NODE_DATA(nid);
	int zid;

	for (zid = 0; zid <= ZONE_NORMAL; zid++) {
		struct zone *zone = &pgdat->node_zones[zid];

		if (zone_intersects(zone, start_pfn, nr_pages))
			return zone;
	}

	return &pgdat->node_zones[ZONE_NORMAL];
}

794 795
static inline struct zone *default_zone_for_pfn(int nid, unsigned long start_pfn,
		unsigned long nr_pages)
796
{
797 798 799 800 801
	struct zone *kernel_zone = default_kernel_zone_for_pfn(nid, start_pfn,
			nr_pages);
	struct zone *movable_zone = &NODE_DATA(nid)->node_zones[ZONE_MOVABLE];
	bool in_kernel = zone_intersects(kernel_zone, start_pfn, nr_pages);
	bool in_movable = zone_intersects(movable_zone, start_pfn, nr_pages);
802 803

	/*
804 805
	 * We inherit the existing zone in a simple case where zones do not
	 * overlap in the given range
806
	 */
807 808
	if (in_kernel ^ in_movable)
		return (in_kernel) ? kernel_zone : movable_zone;
809

810 811 812 813 814 815
	/*
	 * If the range doesn't belong to any zone or two zones overlap in the
	 * given range then we use movable zone only if movable_node is
	 * enabled because we always online to a kernel zone by default.
	 */
	return movable_node_enabled ? movable_zone : kernel_zone;
816 817
}

818 819
struct zone * zone_for_pfn_range(int online_type, int nid, unsigned start_pfn,
		unsigned long nr_pages)
820
{
821 822
	if (online_type == MMOP_ONLINE_KERNEL)
		return default_kernel_zone_for_pfn(nid, start_pfn, nr_pages);
823

824 825
	if (online_type == MMOP_ONLINE_MOVABLE)
		return &NODE_DATA(nid)->node_zones[ZONE_MOVABLE];
826

827
	return default_zone_for_pfn(nid, start_pfn, nr_pages);
828 829 830 831 832 833 834 835 836 837 838 839
}

/*
 * Associates the given pfn range with the given node and the zone appropriate
 * for the given online type.
 */
static struct zone * __meminit move_pfn_range(int online_type, int nid,
		unsigned long start_pfn, unsigned long nr_pages)
{
	struct zone *zone;

	zone = zone_for_pfn_range(online_type, nid, start_pfn, nr_pages);
840
	move_pfn_range_to_zone(zone, start_pfn, nr_pages, NULL);
841
	return zone;
842
}
843

844
int __ref online_pages(unsigned long pfn, unsigned long nr_pages, int online_type)
845
{
846
	unsigned long flags;
847 848
	unsigned long onlined_pages = 0;
	struct zone *zone;
849
	int need_zonelists_rebuild = 0;
850 851 852
	int nid;
	int ret;
	struct memory_notify arg;
853 854
	struct memory_block *mem;

855 856
	mem_hotplug_begin();

857 858 859 860 861 862
	/*
	 * We can't use pfn_to_nid() because nid might be stored in struct page
	 * which is not yet initialized. Instead, we find nid from memory block.
	 */
	mem = find_memory_block(__pfn_to_section(pfn));
	nid = mem->nid;
863
	put_device(&mem->dev);
864

865 866 867
	/* associate pfn range with the zone */
	zone = move_pfn_range(online_type, nid, pfn, nr_pages);

868 869
	arg.start_pfn = pfn;
	arg.nr_pages = nr_pages;
870
	node_states_check_changes_online(nr_pages, zone, &arg);
871 872 873

	ret = memory_notify(MEM_GOING_ONLINE, &arg);
	ret = notifier_to_errno(ret);
874 875 876
	if (ret)
		goto failed_addition;

877 878 879 880 881
	/*
	 * If this zone is not populated, then it is not in zonelist.
	 * This means the page allocator ignores this zone.
	 * So, zonelist must be updated after online.
	 */
882
	if (!populated_zone(zone)) {
883
		need_zonelists_rebuild = 1;
884
		setup_zone_pageset(zone);
885
	}
886

K
KAMEZAWA Hiroyuki 已提交
887
	ret = walk_system_ram_range(pfn, nr_pages, &onlined_pages,
888
		online_pages_range);
889
	if (ret) {
890 891
		if (need_zonelists_rebuild)
			zone_pcp_reset(zone);
892
		goto failed_addition;
893 894
	}

895
	zone->present_pages += onlined_pages;
896 897

	pgdat_resize_lock(zone->zone_pgdat, &flags);
898
	zone->zone_pgdat->node_present_pages += onlined_pages;
899 900
	pgdat_resize_unlock(zone->zone_pgdat, &flags);

901
	if (onlined_pages) {
902
		node_states_set_node(nid, &arg);
903
		if (need_zonelists_rebuild)
904
			build_all_zonelists(NULL);
905 906 907
		else
			zone_pcp_update(zone);
	}
908

909 910
	init_per_zone_wmark_min();

911
	if (onlined_pages) {
912
		kswapd_run(nid);
913 914
		kcompactd_run(nid);
	}
915

916
	vm_total_pages = nr_free_pagecache_pages();
917

918
	writeback_set_ratelimit();
919 920 921

	if (onlined_pages)
		memory_notify(MEM_ONLINE, &arg);
922
	mem_hotplug_done();
923
	return 0;
924 925 926 927 928 929

failed_addition:
	pr_debug("online_pages [mem %#010llx-%#010llx] failed\n",
		 (unsigned long long) pfn << PAGE_SHIFT,
		 (((unsigned long long) pfn + nr_pages) << PAGE_SHIFT) - 1);
	memory_notify(MEM_CANCEL_ONLINE, &arg);
930
	mem_hotplug_done();
931
	return ret;
932
}
933
#endif /* CONFIG_MEMORY_HOTPLUG_SPARSE */
934

935 936 937 938 939 940 941 942 943 944
static void reset_node_present_pages(pg_data_t *pgdat)
{
	struct zone *z;

	for (z = pgdat->node_zones; z < pgdat->node_zones + MAX_NR_ZONES; z++)
		z->present_pages = 0;

	pgdat->node_present_pages = 0;
}

945 946
/* we are OK calling __meminit stuff here - we have CONFIG_MEMORY_HOTPLUG */
static pg_data_t __ref *hotadd_new_pgdat(int nid, u64 start)
947 948
{
	struct pglist_data *pgdat;
949
	unsigned long start_pfn = PFN_DOWN(start);
950

951 952 953 954 955
	pgdat = NODE_DATA(nid);
	if (!pgdat) {
		pgdat = arch_alloc_nodedata(nid);
		if (!pgdat)
			return NULL;
956

957
		arch_refresh_nodedata(nid, pgdat);
958
	} else {
959 960 961 962 963
		/*
		 * Reset the nr_zones, order and classzone_idx before reuse.
		 * Note that kswapd will init kswapd_classzone_idx properly
		 * when it starts in the near future.
		 */
964
		pgdat->nr_zones = 0;
965 966
		pgdat->kswapd_order = 0;
		pgdat->kswapd_classzone_idx = 0;
967
	}
968 969 970

	/* we can use NODE_DATA(nid) from here */

971 972 973
	pgdat->node_id = nid;
	pgdat->node_start_pfn = start_pfn;

974
	/* init node's zones as empty zones, we don't have any present pages.*/
975
	free_area_init_core_hotplug(nid);
976
	pgdat->per_cpu_nodestats = alloc_percpu(struct per_cpu_nodestat);
977

978 979 980 981
	/*
	 * The node we allocated has no zone fallback lists. For avoiding
	 * to access not-initialized zonelist, build here.
	 */
982
	build_all_zonelists(pgdat);
983

984 985 986 987 988
	/*
	 * When memory is hot-added, all the memory is in offline state. So
	 * clear all zones' present_pages because they will be updated in
	 * online_pages() and offline_pages().
	 */
989
	reset_node_managed_pages(pgdat);
990 991
	reset_node_present_pages(pgdat);

992 993 994
	return pgdat;
}

995
static void rollback_node_hotadd(int nid)
996
{
997 998
	pg_data_t *pgdat = NODE_DATA(nid);

999
	arch_refresh_nodedata(nid, NULL);
1000
	free_percpu(pgdat->per_cpu_nodestats);
1001 1002 1003 1004
	arch_free_nodedata(pgdat);
	return;
}

1005

1006 1007
/**
 * try_online_node - online a node if offlined
1008
 * @nid: the node ID
1009 1010
 * @start: start addr of the node
 * @set_node_online: Whether we want to online the node
1011
 * called by cpu_up() to online a node without onlined memory.
1012 1013 1014 1015 1016
 *
 * Returns:
 * 1 -> a new node has been allocated
 * 0 -> the node is already online
 * -ENOMEM -> the node could not be allocated
1017
 */
1018
static int __try_online_node(int nid, u64 start, bool set_node_online)
1019
{
1020 1021
	pg_data_t *pgdat;
	int ret = 1;
1022

1023 1024 1025
	if (node_online(nid))
		return 0;

1026
	pgdat = hotadd_new_pgdat(nid, start);
1027
	if (!pgdat) {
1028
		pr_err("Cannot online node %d due to NULL pgdat\n", nid);
1029 1030 1031
		ret = -ENOMEM;
		goto out;
	}
1032 1033 1034 1035 1036 1037

	if (set_node_online) {
		node_set_online(nid);
		ret = register_one_node(nid);
		BUG_ON(ret);
	}
1038
out:
1039 1040 1041 1042 1043 1044 1045 1046 1047 1048 1049 1050
	return ret;
}

/*
 * Users of this function always want to online/register the node
 */
int try_online_node(int nid)
{
	int ret;

	mem_hotplug_begin();
	ret =  __try_online_node(nid, 0, true);
1051
	mem_hotplug_done();
1052 1053 1054
	return ret;
}

1055 1056
static int check_hotplug_memory_range(u64 start, u64 size)
{
1057 1058
	unsigned long block_sz = memory_block_size_bytes();
	u64 block_nr_pages = block_sz >> PAGE_SHIFT;
1059
	u64 nr_pages = size >> PAGE_SHIFT;
1060
	u64 start_pfn = PFN_DOWN(start);
1061

1062 1063 1064 1065 1066
	/* memory range must be block size aligned */
	if (!nr_pages || !IS_ALIGNED(start_pfn, block_nr_pages) ||
	    !IS_ALIGNED(nr_pages, block_nr_pages)) {
		pr_err("Block size [%#lx] unaligned hotplug range: start %#llx, size %#llx",
		       block_sz, start, size);
1067 1068 1069 1070 1071 1072
		return -EINVAL;
	}

	return 0;
}

1073 1074
static int online_memory_block(struct memory_block *mem, void *arg)
{
1075
	return device_online(&mem->dev);
1076 1077
}

1078 1079 1080 1081 1082 1083
/*
 * NOTE: The caller must call lock_device_hotplug() to serialize hotplug
 * and online/offline operations (triggered e.g. by sysfs).
 *
 * we are OK calling __meminit stuff here - we have CONFIG_MEMORY_HOTPLUG
 */
1084
int __ref add_memory_resource(int nid, struct resource *res, bool online)
1085
{
1086
	u64 start, size;
1087
	bool new_node = false;
1088 1089
	int ret;

1090 1091 1092
	start = res->start;
	size = resource_size(res);

1093 1094 1095 1096
	ret = check_hotplug_memory_range(start, size);
	if (ret)
		return ret;

1097
	mem_hotplug_begin();
1098

1099 1100 1101 1102 1103 1104 1105 1106
	/*
	 * Add new range to memblock so that when hotadd_new_pgdat() is called
	 * to allocate new pgdat, get_pfn_range_for_nid() will be able to find
	 * this new range and calculate total pages correctly.  The range will
	 * be removed at hot-remove time.
	 */
	memblock_add_node(start, size, nid);

1107 1108 1109 1110
	ret = __try_online_node(nid, start, false);
	if (ret < 0)
		goto error;
	new_node = ret;
1111

1112
	/* call arch's memory hotadd */
1113
	ret = arch_add_memory(nid, start, size, NULL, true);
1114 1115 1116
	if (ret < 0)
		goto error;

1117
	if (new_node) {
1118
		/* If sysfs file of new node can't be created, cpu on the node
1119 1120
		 * can't be hot-added. There is no rollback way now.
		 * So, check by BUG_ON() to catch it reluctantly..
1121
		 * We online node here. We can't roll back from here.
1122
		 */
1123 1124
		node_set_online(nid);
		ret = __register_one_node(nid);
1125 1126 1127
		BUG_ON(ret);
	}

1128
	/* link memory sections under this node.*/
1129
	ret = link_mem_sections(nid, PFN_DOWN(start), PFN_UP(start + size - 1));
1130 1131
	BUG_ON(ret);

1132 1133 1134
	/* create new memmap entry */
	firmware_map_add_hotplug(start, start + size, "System RAM");

1135 1136 1137
	/* device_online() will take the lock when calling online_pages() */
	mem_hotplug_done();

1138 1139 1140 1141 1142
	/* online pages if requested */
	if (online)
		walk_memory_range(PFN_DOWN(start), PFN_UP(start + size - 1),
				  NULL, online_memory_block);

1143
	return ret;
1144 1145
error:
	/* rollback pgdat allocation and others */
1146 1147
	if (new_node)
		rollback_node_hotadd(nid);
1148
	memblock_remove(start, size);
1149
	mem_hotplug_done();
1150 1151
	return ret;
}
1152

1153 1154
/* requires device_hotplug_lock, see add_memory_resource() */
int __ref __add_memory(int nid, u64 start, u64 size)
1155 1156 1157 1158 1159
{
	struct resource *res;
	int ret;

	res = register_memory_resource(start, size);
1160 1161
	if (IS_ERR(res))
		return PTR_ERR(res);
1162

1163
	ret = add_memory_resource(nid, res, memhp_auto_online);
1164 1165 1166 1167
	if (ret < 0)
		release_memory_resource(res);
	return ret;
}
1168 1169 1170 1171 1172 1173 1174 1175 1176 1177 1178

int add_memory(int nid, u64 start, u64 size)
{
	int rc;

	lock_device_hotplug();
	rc = __add_memory(nid, start, size);
	unlock_device_hotplug();

	return rc;
}
1179
EXPORT_SYMBOL_GPL(add_memory);
K
KAMEZAWA Hiroyuki 已提交
1180 1181

#ifdef CONFIG_MEMORY_HOTREMOVE
1182 1183 1184 1185 1186 1187 1188 1189 1190 1191 1192 1193
/*
 * A free page on the buddy free lists (not the per-cpu lists) has PageBuddy
 * set and the size of the free page is given by page_order(). Using this,
 * the function determines if the pageblock contains only free pages.
 * Due to buddy contraints, a free page at least the size of a pageblock will
 * be located at the start of the pageblock
 */
static inline int pageblock_free(struct page *page)
{
	return PageBuddy(page) && page_order(page) >= pageblock_order;
}

1194 1195
/* Return the pfn of the start of the next active pageblock after a given pfn */
static unsigned long next_active_pageblock(unsigned long pfn)
1196
{
1197 1198
	struct page *page = pfn_to_page(pfn);

1199
	/* Ensure the starting page is pageblock-aligned */
1200
	BUG_ON(pfn & (pageblock_nr_pages - 1));
1201 1202

	/* If the entire pageblock is free, move to the end of free page */
1203 1204 1205 1206 1207
	if (pageblock_free(page)) {
		int order;
		/* be careful. we don't have locks, page_order can be changed.*/
		order = page_order(page);
		if ((order < MAX_ORDER) && (order >= pageblock_order))
1208
			return pfn + (1 << order);
1209
	}
1210

1211
	return pfn + pageblock_nr_pages;
1212 1213
}

1214
static bool is_pageblock_removable_nolock(unsigned long pfn)
1215
{
1216
	struct page *page = pfn_to_page(pfn);
1217 1218 1219 1220 1221 1222 1223 1224 1225 1226 1227 1228 1229 1230 1231 1232 1233 1234 1235 1236
	struct zone *zone;

	/*
	 * We have to be careful here because we are iterating over memory
	 * sections which are not zone aware so we might end up outside of
	 * the zone but still within the section.
	 * We have to take care about the node as well. If the node is offline
	 * its NODE_DATA will be NULL - see page_zone.
	 */
	if (!node_online(page_to_nid(page)))
		return false;

	zone = page_zone(page);
	pfn = page_to_pfn(page);
	if (!zone_spans_pfn(zone, pfn))
		return false;

	return !has_unmovable_pages(zone, page, 0, MIGRATE_MOVABLE, true);
}

1237
/* Checks if this range of memory is likely to be hot-removable. */
1238
bool is_mem_section_removable(unsigned long start_pfn, unsigned long nr_pages)
1239
{
1240 1241 1242 1243
	unsigned long end_pfn, pfn;

	end_pfn = min(start_pfn + nr_pages,
			zone_end_pfn(page_zone(pfn_to_page(start_pfn))));
1244 1245

	/* Check the starting page of each pageblock within the range */
1246 1247
	for (pfn = start_pfn; pfn < end_pfn; pfn = next_active_pageblock(pfn)) {
		if (!is_pageblock_removable_nolock(pfn))
1248
			return false;
1249
		cond_resched();
1250 1251 1252
	}

	/* All pageblocks in the memory block are likely to be hot-removable */
1253
	return true;
1254 1255
}

K
KAMEZAWA Hiroyuki 已提交
1256
/*
1257
 * Confirm all pages in a range [start, end) belong to the same zone.
1258
 * When true, return its valid [start, end).
K
KAMEZAWA Hiroyuki 已提交
1259
 */
1260 1261
int test_pages_in_a_zone(unsigned long start_pfn, unsigned long end_pfn,
			 unsigned long *valid_start, unsigned long *valid_end)
K
KAMEZAWA Hiroyuki 已提交
1262
{
1263
	unsigned long pfn, sec_end_pfn;
1264
	unsigned long start, end;
K
KAMEZAWA Hiroyuki 已提交
1265 1266 1267
	struct zone *zone = NULL;
	struct page *page;
	int i;
1268
	for (pfn = start_pfn, sec_end_pfn = SECTION_ALIGN_UP(start_pfn + 1);
K
KAMEZAWA Hiroyuki 已提交
1269
	     pfn < end_pfn;
1270
	     pfn = sec_end_pfn, sec_end_pfn += PAGES_PER_SECTION) {
1271 1272
		/* Make sure the memory section is present first */
		if (!present_section_nr(pfn_to_section_nr(pfn)))
K
KAMEZAWA Hiroyuki 已提交
1273
			continue;
1274 1275 1276 1277 1278 1279 1280
		for (; pfn < sec_end_pfn && pfn < end_pfn;
		     pfn += MAX_ORDER_NR_PAGES) {
			i = 0;
			/* This is just a CONFIG_HOLES_IN_ZONE check.*/
			while ((i < MAX_ORDER_NR_PAGES) &&
				!pfn_valid_within(pfn + i))
				i++;
1281
			if (i == MAX_ORDER_NR_PAGES || pfn + i >= end_pfn)
1282
				continue;
1283 1284 1285
			/* Check if we got outside of the zone */
			if (zone && !zone_spans_pfn(zone, pfn + i))
				return 0;
1286 1287 1288
			page = pfn_to_page(pfn + i);
			if (zone && page_zone(page) != zone)
				return 0;
1289 1290
			if (!zone)
				start = pfn + i;
1291
			zone = page_zone(page);
1292
			end = pfn + MAX_ORDER_NR_PAGES;
1293
		}
K
KAMEZAWA Hiroyuki 已提交
1294
	}
1295

1296 1297
	if (zone) {
		*valid_start = start;
1298
		*valid_end = min(end, end_pfn);
1299
		return 1;
1300
	} else {
1301
		return 0;
1302
	}
K
KAMEZAWA Hiroyuki 已提交
1303 1304 1305
}

/*
1306 1307 1308 1309
 * Scan pfn range [start,end) to find movable/migratable pages (LRU pages,
 * non-lru movable pages and hugepages). We scan pfn because it's much
 * easier than scanning over linked list. This function returns the pfn
 * of the first found movable page if it's found, otherwise 0.
K
KAMEZAWA Hiroyuki 已提交
1310
 */
1311
static unsigned long scan_movable_pages(unsigned long start, unsigned long end)
K
KAMEZAWA Hiroyuki 已提交
1312 1313
{
	unsigned long pfn;
1314

K
KAMEZAWA Hiroyuki 已提交
1315
	for (pfn = start; pfn < end; pfn++) {
1316 1317 1318 1319 1320 1321 1322 1323 1324 1325 1326 1327 1328 1329 1330 1331 1332 1333 1334
		struct page *page, *head;
		unsigned long skip;

		if (!pfn_valid(pfn))
			continue;
		page = pfn_to_page(pfn);
		if (PageLRU(page))
			return pfn;
		if (__PageMovable(page))
			return pfn;

		if (!PageHuge(page))
			continue;
		head = compound_head(page);
		if (hugepage_migration_supported(page_hstate(head)) &&
		    page_huge_active(head))
			return pfn;
		skip = (1 << compound_order(head)) - (page - head);
		pfn += skip - 1;
K
KAMEZAWA Hiroyuki 已提交
1335 1336 1337 1338
	}
	return 0;
}

1339
static struct page *new_node_page(struct page *page, unsigned long private)
1340 1341
{
	int nid = page_to_nid(page);
1342
	nodemask_t nmask = node_states[N_MEMORY];
1343 1344 1345 1346 1347 1348 1349 1350 1351

	/*
	 * try to allocate from a different node but reuse this node if there
	 * are no other online nodes to be used (e.g. we are offlining a part
	 * of the only existing node)
	 */
	node_clear(nid, nmask);
	if (nodes_empty(nmask))
		node_set(nid, nmask);
1352

1353
	return new_page_nodemask(page, nid, &nmask);
1354 1355
}

K
KAMEZAWA Hiroyuki 已提交
1356 1357 1358 1359 1360 1361 1362 1363 1364 1365 1366 1367 1368 1369 1370
#define NR_OFFLINE_AT_ONCE_PAGES	(256)
static int
do_migrate_range(unsigned long start_pfn, unsigned long end_pfn)
{
	unsigned long pfn;
	struct page *page;
	int move_pages = NR_OFFLINE_AT_ONCE_PAGES;
	int not_managed = 0;
	int ret = 0;
	LIST_HEAD(source);

	for (pfn = start_pfn; pfn < end_pfn && move_pages > 0; pfn++) {
		if (!pfn_valid(pfn))
			continue;
		page = pfn_to_page(pfn);
1371 1372 1373 1374 1375 1376 1377 1378 1379 1380 1381

		if (PageHuge(page)) {
			struct page *head = compound_head(page);
			pfn = page_to_pfn(head) + (1<<compound_order(head)) - 1;
			if (compound_order(head) > PFN_SECTION_SHIFT) {
				ret = -EBUSY;
				break;
			}
			if (isolate_huge_page(page, &source))
				move_pages -= 1 << compound_order(head);
			continue;
M
Michal Hocko 已提交
1382
		} else if (PageTransHuge(page))
1383 1384
			pfn = page_to_pfn(compound_head(page))
				+ hpage_nr_pages(page) - 1;
1385

1386 1387 1388 1389 1390 1391 1392 1393 1394 1395 1396 1397 1398 1399 1400
		/*
		 * HWPoison pages have elevated reference counts so the migration would
		 * fail on them. It also doesn't make any sense to migrate them in the
		 * first place. Still try to unmap such a page in case it is still mapped
		 * (e.g. current hwpoison implementation doesn't unmap KSM pages but keep
		 * the unmap as the catch all safety net).
		 */
		if (PageHWPoison(page)) {
			if (WARN_ON(PageLRU(page)))
				isolate_lru_page(page);
			if (page_mapped(page))
				try_to_unmap(page, TTU_IGNORE_MLOCK | TTU_IGNORE_ACCESS);
			continue;
		}

1401
		if (!get_page_unless_zero(page))
K
KAMEZAWA Hiroyuki 已提交
1402 1403
			continue;
		/*
1404 1405
		 * We can skip free pages. And we can deal with pages on
		 * LRU and non-lru movable pages.
K
KAMEZAWA Hiroyuki 已提交
1406
		 */
1407 1408 1409 1410
		if (PageLRU(page))
			ret = isolate_lru_page(page);
		else
			ret = isolate_movable_page(page, ISOLATE_UNEVICTABLE);
K
KAMEZAWA Hiroyuki 已提交
1411
		if (!ret) { /* Success */
1412
			put_page(page);
1413
			list_add_tail(&page->lru, &source);
K
KAMEZAWA Hiroyuki 已提交
1414
			move_pages--;
1415 1416 1417
			if (!__PageMovable(page))
				inc_node_page_state(page, NR_ISOLATED_ANON +
						    page_is_file_cache(page));
1418

K
KAMEZAWA Hiroyuki 已提交
1419 1420
		} else {
#ifdef CONFIG_DEBUG_VM
1421 1422
			pr_alert("failed to isolate pfn %lx\n", pfn);
			dump_page(page, "isolation failed");
K
KAMEZAWA Hiroyuki 已提交
1423
#endif
1424
			put_page(page);
L
Lucas De Marchi 已提交
1425
			/* Because we don't have big zone->lock. we should
1426 1427 1428
			   check this again here. */
			if (page_count(page)) {
				not_managed++;
1429
				ret = -EBUSY;
1430 1431
				break;
			}
K
KAMEZAWA Hiroyuki 已提交
1432 1433
		}
	}
1434 1435
	if (!list_empty(&source)) {
		if (not_managed) {
1436
			putback_movable_pages(&source);
1437 1438
			goto out;
		}
1439

1440 1441
		/* Allocate a new page from the nearest neighbor node */
		ret = migrate_pages(&source, new_node_page, NULL, 0,
1442
					MIGRATE_SYNC, MR_MEMORY_HOTPLUG);
1443
		if (ret)
1444
			putback_movable_pages(&source);
K
KAMEZAWA Hiroyuki 已提交
1445 1446 1447 1448 1449 1450 1451 1452 1453 1454 1455 1456 1457 1458 1459 1460 1461 1462 1463
	}
out:
	return ret;
}

/*
 * remove from free_area[] and mark all as Reserved.
 */
static int
offline_isolated_pages_cb(unsigned long start, unsigned long nr_pages,
			void *data)
{
	__offline_isolated_pages(start, start + nr_pages);
	return 0;
}

static void
offline_isolated_pages(unsigned long start_pfn, unsigned long end_pfn)
{
K
KAMEZAWA Hiroyuki 已提交
1464
	walk_system_ram_range(start_pfn, end_pfn - start_pfn, NULL,
K
KAMEZAWA Hiroyuki 已提交
1465 1466 1467 1468 1469 1470 1471 1472 1473 1474 1475 1476
				offline_isolated_pages_cb);
}

/*
 * Check all pages in range, recoreded as memory resource, are isolated.
 */
static int
check_pages_isolated_cb(unsigned long start_pfn, unsigned long nr_pages,
			void *data)
{
	int ret;
	long offlined = *(long *)data;
1477
	ret = test_pages_isolated(start_pfn, start_pfn + nr_pages, true);
K
KAMEZAWA Hiroyuki 已提交
1478 1479 1480 1481 1482 1483 1484 1485 1486 1487 1488 1489
	offlined = nr_pages;
	if (!ret)
		*(long *)data += offlined;
	return ret;
}

static long
check_pages_isolated(unsigned long start_pfn, unsigned long end_pfn)
{
	long offlined = 0;
	int ret;

K
KAMEZAWA Hiroyuki 已提交
1490
	ret = walk_system_ram_range(start_pfn, end_pfn - start_pfn, &offlined,
K
KAMEZAWA Hiroyuki 已提交
1491 1492 1493 1494 1495 1496
			check_pages_isolated_cb);
	if (ret < 0)
		offlined = (long)ret;
	return offlined;
}

1497 1498
static int __init cmdline_parse_movable_node(char *p)
{
1499
#ifdef CONFIG_HAVE_MEMBLOCK_NODE_MAP
1500
	movable_node_enabled = true;
1501 1502 1503
#else
	pr_warn("movable_node parameter depends on CONFIG_HAVE_MEMBLOCK_NODE_MAP to work properly\n");
#endif
1504 1505 1506 1507
	return 0;
}
early_param("movable_node", cmdline_parse_movable_node);

1508 1509 1510 1511 1512 1513 1514 1515 1516
/* check which state of node_states will be changed when offline memory */
static void node_states_check_changes_offline(unsigned long nr_pages,
		struct zone *zone, struct memory_notify *arg)
{
	struct pglist_data *pgdat = zone->zone_pgdat;
	unsigned long present_pages = 0;
	enum zone_type zt, zone_last = ZONE_NORMAL;

	/*
1517 1518 1519
	 * If we have HIGHMEM or movable node, node_states[N_NORMAL_MEMORY]
	 * contains nodes which have zones of 0...ZONE_NORMAL,
	 * set zone_last to ZONE_NORMAL.
1520
	 *
1521 1522 1523
	 * If we don't have HIGHMEM nor movable node,
	 * node_states[N_NORMAL_MEMORY] contains nodes which have zones of
	 * 0...ZONE_MOVABLE, set zone_last to ZONE_MOVABLE.
1524
	 */
1525
	if (N_MEMORY == N_NORMAL_MEMORY)
1526 1527 1528 1529 1530 1531 1532 1533 1534 1535 1536 1537 1538 1539 1540 1541
		zone_last = ZONE_MOVABLE;

	/*
	 * check whether node_states[N_NORMAL_MEMORY] will be changed.
	 * If the memory to be offline is in a zone of 0...zone_last,
	 * and it is the last present memory, 0...zone_last will
	 * become empty after offline , thus we can determind we will
	 * need to clear the node from node_states[N_NORMAL_MEMORY].
	 */
	for (zt = 0; zt <= zone_last; zt++)
		present_pages += pgdat->node_zones[zt].present_pages;
	if (zone_idx(zone) <= zone_last && nr_pages >= present_pages)
		arg->status_change_nid_normal = zone_to_nid(zone);
	else
		arg->status_change_nid_normal = -1;

1542 1543 1544 1545 1546 1547 1548 1549 1550 1551 1552 1553 1554 1555 1556 1557 1558 1559 1560 1561 1562 1563 1564 1565
#ifdef CONFIG_HIGHMEM
	/*
	 * If we have movable node, node_states[N_HIGH_MEMORY]
	 * contains nodes which have zones of 0...ZONE_HIGHMEM,
	 * set zone_last to ZONE_HIGHMEM.
	 *
	 * If we don't have movable node, node_states[N_NORMAL_MEMORY]
	 * contains nodes which have zones of 0...ZONE_MOVABLE,
	 * set zone_last to ZONE_MOVABLE.
	 */
	zone_last = ZONE_HIGHMEM;
	if (N_MEMORY == N_HIGH_MEMORY)
		zone_last = ZONE_MOVABLE;

	for (; zt <= zone_last; zt++)
		present_pages += pgdat->node_zones[zt].present_pages;
	if (zone_idx(zone) <= zone_last && nr_pages >= present_pages)
		arg->status_change_nid_high = zone_to_nid(zone);
	else
		arg->status_change_nid_high = -1;
#else
	arg->status_change_nid_high = arg->status_change_nid_normal;
#endif

1566 1567 1568 1569 1570 1571 1572 1573 1574 1575 1576 1577 1578 1579 1580 1581 1582 1583 1584 1585 1586 1587 1588 1589
	/*
	 * node_states[N_HIGH_MEMORY] contains nodes which have 0...ZONE_MOVABLE
	 */
	zone_last = ZONE_MOVABLE;

	/*
	 * check whether node_states[N_HIGH_MEMORY] will be changed
	 * If we try to offline the last present @nr_pages from the node,
	 * we can determind we will need to clear the node from
	 * node_states[N_HIGH_MEMORY].
	 */
	for (; zt <= zone_last; zt++)
		present_pages += pgdat->node_zones[zt].present_pages;
	if (nr_pages >= present_pages)
		arg->status_change_nid = zone_to_nid(zone);
	else
		arg->status_change_nid = -1;
}

static void node_states_clear_node(int node, struct memory_notify *arg)
{
	if (arg->status_change_nid_normal >= 0)
		node_clear_state(node, N_NORMAL_MEMORY);

1590 1591
	if ((N_MEMORY != N_NORMAL_MEMORY) &&
	    (arg->status_change_nid_high >= 0))
1592
		node_clear_state(node, N_HIGH_MEMORY);
1593 1594 1595 1596

	if ((N_MEMORY != N_HIGH_MEMORY) &&
	    (arg->status_change_nid >= 0))
		node_clear_state(node, N_MEMORY);
1597 1598
}

1599
static int __ref __offline_pages(unsigned long start_pfn,
1600
		  unsigned long end_pfn)
K
KAMEZAWA Hiroyuki 已提交
1601
{
1602
	unsigned long pfn, nr_pages;
K
KAMEZAWA Hiroyuki 已提交
1603
	long offlined_pages;
1604
	int ret, node;
1605
	unsigned long flags;
1606
	unsigned long valid_start, valid_end;
K
KAMEZAWA Hiroyuki 已提交
1607
	struct zone *zone;
1608
	struct memory_notify arg;
K
KAMEZAWA Hiroyuki 已提交
1609 1610 1611 1612 1613 1614

	/* at least, alignment against pageblock is necessary */
	if (!IS_ALIGNED(start_pfn, pageblock_nr_pages))
		return -EINVAL;
	if (!IS_ALIGNED(end_pfn, pageblock_nr_pages))
		return -EINVAL;
1615 1616 1617

	mem_hotplug_begin();

K
KAMEZAWA Hiroyuki 已提交
1618 1619
	/* This makes hotplug much easier...and readable.
	   we assume this for now. .*/
1620 1621 1622
	if (!test_pages_in_a_zone(start_pfn, end_pfn, &valid_start,
				  &valid_end)) {
		mem_hotplug_done();
K
KAMEZAWA Hiroyuki 已提交
1623
		return -EINVAL;
1624
	}
1625

1626
	zone = page_zone(pfn_to_page(valid_start));
1627 1628 1629
	node = zone_to_nid(zone);
	nr_pages = end_pfn - start_pfn;

K
KAMEZAWA Hiroyuki 已提交
1630
	/* set above range as isolated */
1631 1632
	ret = start_isolate_page_range(start_pfn, end_pfn,
				       MIGRATE_MOVABLE, true);
1633 1634
	if (ret) {
		mem_hotplug_done();
1635
		return ret;
1636
	}
1637 1638 1639

	arg.start_pfn = start_pfn;
	arg.nr_pages = nr_pages;
1640
	node_states_check_changes_offline(nr_pages, zone, &arg);
1641 1642 1643 1644 1645 1646

	ret = memory_notify(MEM_GOING_OFFLINE, &arg);
	ret = notifier_to_errno(ret);
	if (ret)
		goto failed_removal;

K
KAMEZAWA Hiroyuki 已提交
1647 1648 1649 1650 1651 1652
	pfn = start_pfn;
repeat:
	/* start memory hot removal */
	ret = -EINTR;
	if (signal_pending(current))
		goto failed_removal;
1653 1654

	cond_resched();
1655
	lru_add_drain_all();
1656
	drain_all_pages(zone);
K
KAMEZAWA Hiroyuki 已提交
1657

1658 1659
	pfn = scan_movable_pages(start_pfn, end_pfn);
	if (pfn) { /* We have movable pages */
K
KAMEZAWA Hiroyuki 已提交
1660
		ret = do_migrate_range(pfn, end_pfn);
1661
		goto repeat;
K
KAMEZAWA Hiroyuki 已提交
1662
	}
1663

1664 1665 1666 1667
	/*
	 * dissolve free hugepages in the memory block before doing offlining
	 * actually in order to make hugetlbfs's object counting consistent.
	 */
1668 1669 1670
	ret = dissolve_free_huge_pages(start_pfn, end_pfn);
	if (ret)
		goto failed_removal;
K
KAMEZAWA Hiroyuki 已提交
1671 1672
	/* check again */
	offlined_pages = check_pages_isolated(start_pfn, end_pfn);
1673 1674
	if (offlined_pages < 0)
		goto repeat;
1675
	pr_info("Offlined Pages %ld\n", offlined_pages);
1676
	/* Ok, all of our target is isolated.
K
KAMEZAWA Hiroyuki 已提交
1677 1678
	   We cannot do rollback at this point. */
	offline_isolated_pages(start_pfn, end_pfn);
1679
	/* reset pagetype flags and makes migrate type to be MOVABLE */
1680
	undo_isolate_page_range(start_pfn, end_pfn, MIGRATE_MOVABLE);
K
KAMEZAWA Hiroyuki 已提交
1681
	/* removal success */
1682
	adjust_managed_page_count(pfn_to_page(start_pfn), -offlined_pages);
K
KAMEZAWA Hiroyuki 已提交
1683
	zone->present_pages -= offlined_pages;
1684 1685

	pgdat_resize_lock(zone->zone_pgdat, &flags);
K
KAMEZAWA Hiroyuki 已提交
1686
	zone->zone_pgdat->node_present_pages -= offlined_pages;
1687
	pgdat_resize_unlock(zone->zone_pgdat, &flags);
1688

1689 1690
	init_per_zone_wmark_min();

1691
	if (!populated_zone(zone)) {
1692
		zone_pcp_reset(zone);
1693
		build_all_zonelists(NULL);
1694 1695
	} else
		zone_pcp_update(zone);
1696

1697
	node_states_clear_node(node, &arg);
1698
	if (arg.status_change_nid >= 0) {
1699
		kswapd_stop(node);
1700 1701
		kcompactd_stop(node);
	}
1702

K
KAMEZAWA Hiroyuki 已提交
1703 1704
	vm_total_pages = nr_free_pagecache_pages();
	writeback_set_ratelimit();
1705 1706

	memory_notify(MEM_OFFLINE, &arg);
1707
	mem_hotplug_done();
K
KAMEZAWA Hiroyuki 已提交
1708 1709 1710
	return 0;

failed_removal:
1711 1712 1713
	pr_debug("memory offlining [mem %#010llx-%#010llx] failed\n",
		 (unsigned long long) start_pfn << PAGE_SHIFT,
		 ((unsigned long long) end_pfn << PAGE_SHIFT) - 1);
1714
	memory_notify(MEM_CANCEL_OFFLINE, &arg);
K
KAMEZAWA Hiroyuki 已提交
1715
	/* pushback to free area */
1716
	undo_isolate_page_range(start_pfn, end_pfn, MIGRATE_MOVABLE);
1717
	mem_hotplug_done();
K
KAMEZAWA Hiroyuki 已提交
1718 1719
	return ret;
}
1720

1721 1722
int offline_pages(unsigned long start_pfn, unsigned long nr_pages)
{
1723
	return __offline_pages(start_pfn, start_pfn + nr_pages);
1724
}
1725
#endif /* CONFIG_MEMORY_HOTREMOVE */
1726

1727 1728 1729
/**
 * walk_memory_range - walks through all mem sections in [start_pfn, end_pfn)
 * @start_pfn: start pfn of the memory range
1730
 * @end_pfn: end pfn of the memory range
1731 1732 1733 1734 1735 1736 1737 1738
 * @arg: argument passed to func
 * @func: callback for each memory section walked
 *
 * This function walks through all present mem sections in range
 * [start_pfn, end_pfn) and call func on each mem section.
 *
 * Returns the return value of func.
 */
1739
int walk_memory_range(unsigned long start_pfn, unsigned long end_pfn,
1740
		void *arg, int (*func)(struct memory_block *, void *))
1741
{
1742 1743 1744 1745 1746 1747 1748 1749 1750 1751 1752 1753 1754 1755 1756 1757 1758 1759 1760 1761 1762
	struct memory_block *mem = NULL;
	struct mem_section *section;
	unsigned long pfn, section_nr;
	int ret;

	for (pfn = start_pfn; pfn < end_pfn; pfn += PAGES_PER_SECTION) {
		section_nr = pfn_to_section_nr(pfn);
		if (!present_section_nr(section_nr))
			continue;

		section = __nr_to_section(section_nr);
		/* same memblock? */
		if (mem)
			if ((section_nr >= mem->start_section_nr) &&
			    (section_nr <= mem->end_section_nr))
				continue;

		mem = find_memory_block_hinted(section, mem);
		if (!mem)
			continue;

1763
		ret = func(mem, arg);
1764
		if (ret) {
1765 1766
			kobject_put(&mem->dev.kobj);
			return ret;
1767 1768 1769 1770 1771 1772
		}
	}

	if (mem)
		kobject_put(&mem->dev.kobj);

1773 1774 1775
	return 0;
}

1776
#ifdef CONFIG_MEMORY_HOTREMOVE
1777
static int check_memblock_offlined_cb(struct memory_block *mem, void *arg)
1778 1779 1780
{
	int ret = !is_memblock_offlined(mem);

1781 1782 1783 1784 1785
	if (unlikely(ret)) {
		phys_addr_t beginpa, endpa;

		beginpa = PFN_PHYS(section_nr_to_pfn(mem->start_section_nr));
		endpa = PFN_PHYS(section_nr_to_pfn(mem->end_section_nr + 1))-1;
J
Joe Perches 已提交
1786
		pr_warn("removing memory fails, because memory [%pa-%pa] is onlined\n",
1787 1788
			&beginpa, &endpa);
	}
1789 1790 1791 1792

	return ret;
}

1793
static int check_cpu_on_node(pg_data_t *pgdat)
1794 1795 1796 1797 1798 1799 1800 1801 1802 1803 1804 1805 1806 1807 1808
{
	int cpu;

	for_each_present_cpu(cpu) {
		if (cpu_to_node(cpu) == pgdat->node_id)
			/*
			 * the cpu on this node isn't removed, and we can't
			 * offline this node.
			 */
			return -EBUSY;
	}

	return 0;
}

1809
static void unmap_cpu_on_node(pg_data_t *pgdat)
1810 1811 1812 1813 1814 1815 1816 1817 1818 1819
{
#ifdef CONFIG_ACPI_NUMA
	int cpu;

	for_each_possible_cpu(cpu)
		if (cpu_to_node(cpu) == pgdat->node_id)
			numa_clear_node(cpu);
#endif
}

1820
static int check_and_unmap_cpu_on_node(pg_data_t *pgdat)
1821
{
1822
	int ret;
1823

1824
	ret = check_cpu_on_node(pgdat);
1825 1826 1827 1828 1829 1830 1831 1832
	if (ret)
		return ret;

	/*
	 * the node will be offlined when we come here, so we can clear
	 * the cpu_to_node() now.
	 */

1833
	unmap_cpu_on_node(pgdat);
1834 1835 1836
	return 0;
}

1837 1838
/**
 * try_offline_node
1839
 * @nid: the node ID
1840 1841 1842 1843 1844 1845
 *
 * Offline a node if all memory sections and cpus of the node are removed.
 *
 * NOTE: The caller must call lock_device_hotplug() to serialize hotplug
 * and online/offline operations before this call.
 */
1846
void try_offline_node(int nid)
1847
{
1848 1849 1850
	pg_data_t *pgdat = NODE_DATA(nid);
	unsigned long start_pfn = pgdat->node_start_pfn;
	unsigned long end_pfn = start_pfn + pgdat->node_spanned_pages;
1851 1852 1853 1854 1855 1856 1857 1858 1859 1860 1861 1862 1863 1864 1865 1866 1867 1868
	unsigned long pfn;

	for (pfn = start_pfn; pfn < end_pfn; pfn += PAGES_PER_SECTION) {
		unsigned long section_nr = pfn_to_section_nr(pfn);

		if (!present_section_nr(section_nr))
			continue;

		if (pfn_to_nid(pfn) != nid)
			continue;

		/*
		 * some memory sections of this node are not removed, and we
		 * can't offline node now.
		 */
		return;
	}

1869
	if (check_and_unmap_cpu_on_node(pgdat))
1870 1871 1872 1873 1874 1875 1876 1877 1878
		return;

	/*
	 * all memory/cpu of this node are removed, we can offline this
	 * node now.
	 */
	node_set_offline(nid);
	unregister_one_node(nid);
}
1879
EXPORT_SYMBOL(try_offline_node);
1880

1881 1882
/**
 * remove_memory
1883 1884 1885
 * @nid: the node ID
 * @start: physical address of the region to remove
 * @size: size of the region to remove
1886 1887 1888 1889 1890
 *
 * NOTE: The caller must call lock_device_hotplug() to serialize hotplug
 * and online/offline operations before this call, as required by
 * try_offline_node().
 */
1891
void __ref remove_memory(int nid, u64 start, u64 size)
1892
{
1893
	int ret;
1894

1895 1896
	BUG_ON(check_hotplug_memory_range(start, size));

1897
	mem_hotplug_begin();
1898 1899

	/*
1900 1901 1902
	 * All memory blocks must be offlined before removing memory.  Check
	 * whether all memory blocks in question are offline and trigger a BUG()
	 * if this is not the case.
1903
	 */
1904
	ret = walk_memory_range(PFN_DOWN(start), PFN_UP(start + size - 1), NULL,
1905
				check_memblock_offlined_cb);
1906
	if (ret)
1907
		BUG();
1908

1909 1910
	/* remove memmap entry */
	firmware_map_remove(start, start + size, "System RAM");
1911 1912
	memblock_free(start, size);
	memblock_remove(start, size);
1913

1914
	arch_remove_memory(start, size, NULL);
1915

1916 1917
	try_offline_node(nid);

1918
	mem_hotplug_done();
1919 1920
}
EXPORT_SYMBOL_GPL(remove_memory);
1921
#endif /* CONFIG_MEMORY_HOTREMOVE */