2 * Copyright(c) 2015 Intel Corporation. All rights reserved.
4 * This program is free software; you can redistribute it and/or modify
5 * it under the terms of version 2 of the GNU General Public License as
6 * published by the Free Software Foundation.
8 * This program is distributed in the hope that it will be useful, but
9 * WITHOUT ANY WARRANTY; without even the implied warranty of
10 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
11 * General Public License for more details.
13 #include <linux/radix-tree.h>
14 #include <linux/device.h>
15 #include <linux/types.h>
16 #include <linux/pfn_t.h>
19 #include <linux/memory_hotplug.h>
20 #include <linux/swap.h>
21 #include <linux/swapops.h>
24 /* temporary while we convert existing ioremap_cache users to memremap */
25 __weak
void __iomem
*ioremap_cache(resource_size_t offset
, unsigned long size
)
27 return ioremap(offset
, size
);
31 #ifndef arch_memremap_wb
32 static void *arch_memremap_wb(resource_size_t offset
, unsigned long size
)
34 return (__force
void *)ioremap_cache(offset
, size
);
38 #ifndef arch_memremap_can_ram_remap
39 static bool arch_memremap_can_ram_remap(resource_size_t offset
, size_t size
,
46 static void *try_ram_remap(resource_size_t offset
, size_t size
,
49 unsigned long pfn
= PHYS_PFN(offset
);
51 /* In the simple case just return the existing linear address */
52 if (pfn_valid(pfn
) && !PageHighMem(pfn_to_page(pfn
)) &&
53 arch_memremap_can_ram_remap(offset
, size
, flags
))
56 return NULL
; /* fallback to arch_memremap_wb */
60 * memremap() - remap an iomem_resource as cacheable memory
61 * @offset: iomem resource start address
62 * @size: size of remap
63 * @flags: any of MEMREMAP_WB, MEMREMAP_WT, MEMREMAP_WC,
64 * MEMREMAP_ENC, MEMREMAP_DEC
66 * memremap() is "ioremap" for cases where it is known that the resource
67 * being mapped does not have i/o side effects and the __iomem
68 * annotation is not applicable. In the case of multiple flags, the different
69 * mapping types will be attempted in the order listed below until one of
72 * MEMREMAP_WB - matches the default mapping for System RAM on
73 * the architecture. This is usually a read-allocate write-back cache.
74 * Morever, if MEMREMAP_WB is specified and the requested remap region is RAM
75 * memremap() will bypass establishing a new mapping and instead return
76 * a pointer into the direct map.
78 * MEMREMAP_WT - establish a mapping whereby writes either bypass the
79 * cache or are written through to memory and never exist in a
80 * cache-dirty state with respect to program visibility. Attempts to
81 * map System RAM with this mapping type will fail.
83 * MEMREMAP_WC - establish a writecombine mapping, whereby writes may
84 * be coalesced together (e.g. in the CPU's write buffers), but is otherwise
85 * uncached. Attempts to map System RAM with this mapping type will fail.
87 void *memremap(resource_size_t offset
, size_t size
, unsigned long flags
)
89 int is_ram
= region_intersects(offset
, size
,
90 IORESOURCE_SYSTEM_RAM
, IORES_DESC_NONE
);
96 if (is_ram
== REGION_MIXED
) {
97 WARN_ONCE(1, "memremap attempted on mixed range %pa size: %#lx\n",
98 &offset
, (unsigned long) size
);
102 /* Try all mapping types requested until one returns non-NULL */
103 if (flags
& MEMREMAP_WB
) {
105 * MEMREMAP_WB is special in that it can be satisifed
106 * from the direct map. Some archs depend on the
107 * capability of memremap() to autodetect cases where
108 * the requested range is potentially in System RAM.
110 if (is_ram
== REGION_INTERSECTS
)
111 addr
= try_ram_remap(offset
, size
, flags
);
113 addr
= arch_memremap_wb(offset
, size
);
117 * If we don't have a mapping yet and other request flags are
118 * present then we will be attempting to establish a new virtual
119 * address mapping. Enforce that this mapping is not aliasing
122 if (!addr
&& is_ram
== REGION_INTERSECTS
&& flags
!= MEMREMAP_WB
) {
123 WARN_ONCE(1, "memremap attempted on ram %pa size: %#lx\n",
124 &offset
, (unsigned long) size
);
128 if (!addr
&& (flags
& MEMREMAP_WT
))
129 addr
= ioremap_wt(offset
, size
);
131 if (!addr
&& (flags
& MEMREMAP_WC
))
132 addr
= ioremap_wc(offset
, size
);
136 EXPORT_SYMBOL(memremap
);
138 void memunmap(void *addr
)
140 if (is_vmalloc_addr(addr
))
141 iounmap((void __iomem
*) addr
);
143 EXPORT_SYMBOL(memunmap
);
145 static void devm_memremap_release(struct device
*dev
, void *res
)
147 memunmap(*(void **)res
);
150 static int devm_memremap_match(struct device
*dev
, void *res
, void *match_data
)
152 return *(void **)res
== match_data
;
155 void *devm_memremap(struct device
*dev
, resource_size_t offset
,
156 size_t size
, unsigned long flags
)
160 ptr
= devres_alloc_node(devm_memremap_release
, sizeof(*ptr
), GFP_KERNEL
,
163 return ERR_PTR(-ENOMEM
);
165 addr
= memremap(offset
, size
, flags
);
168 devres_add(dev
, ptr
);
171 return ERR_PTR(-ENXIO
);
176 EXPORT_SYMBOL(devm_memremap
);
178 void devm_memunmap(struct device
*dev
, void *addr
)
180 WARN_ON(devres_release(dev
, devm_memremap_release
,
181 devm_memremap_match
, addr
));
183 EXPORT_SYMBOL(devm_memunmap
);
185 #ifdef CONFIG_ZONE_DEVICE
186 static DEFINE_MUTEX(pgmap_lock
);
187 static RADIX_TREE(pgmap_radix
, GFP_KERNEL
);
188 #define SECTION_MASK ~((1UL << PA_SECTION_SHIFT) - 1)
189 #define SECTION_SIZE (1UL << PA_SECTION_SHIFT)
191 static unsigned long order_at(struct resource
*res
, unsigned long pgoff
)
193 unsigned long phys_pgoff
= PHYS_PFN(res
->start
) + pgoff
;
194 unsigned long nr_pages
, mask
;
196 nr_pages
= PHYS_PFN(resource_size(res
));
197 if (nr_pages
== pgoff
)
201 * What is the largest aligned power-of-2 range available from
202 * this resource pgoff to the end of the resource range,
203 * considering the alignment of the current pgoff?
205 mask
= phys_pgoff
| rounddown_pow_of_two(nr_pages
- pgoff
);
209 return find_first_bit(&mask
, BITS_PER_LONG
);
212 #define foreach_order_pgoff(res, order, pgoff) \
213 for (pgoff = 0, order = order_at((res), pgoff); order < ULONG_MAX; \
214 pgoff += 1UL << order, order = order_at((res), pgoff))
216 #if IS_ENABLED(CONFIG_DEVICE_PRIVATE)
217 int device_private_entry_fault(struct vm_area_struct
*vma
,
223 struct page
*page
= device_private_entry_to_page(entry
);
226 * The page_fault() callback must migrate page back to system memory
227 * so that CPU can access it. This might fail for various reasons
228 * (device issue, device was unsafely unplugged, ...). When such
229 * error conditions happen, the callback must return VM_FAULT_SIGBUS.
231 * Note that because memory cgroup charges are accounted to the device
232 * memory, this should never fail because of memory restrictions (but
233 * allocation of regular system page might still fail because we are
236 * There is a more in-depth description of what that callback can and
237 * cannot do, in include/linux/memremap.h
239 return page
->pgmap
->page_fault(vma
, addr
, page
, flags
, pmdp
);
241 EXPORT_SYMBOL(device_private_entry_fault
);
242 #endif /* CONFIG_DEVICE_PRIVATE */
244 static void pgmap_radix_release(struct resource
*res
, unsigned long end_pgoff
)
246 unsigned long pgoff
, order
;
248 mutex_lock(&pgmap_lock
);
249 foreach_order_pgoff(res
, order
, pgoff
) {
250 if (pgoff
>= end_pgoff
)
252 radix_tree_delete(&pgmap_radix
, PHYS_PFN(res
->start
) + pgoff
);
254 mutex_unlock(&pgmap_lock
);
259 static unsigned long pfn_first(struct dev_pagemap
*pgmap
)
261 const struct resource
*res
= &pgmap
->res
;
262 struct vmem_altmap
*altmap
= &pgmap
->altmap
;
265 pfn
= res
->start
>> PAGE_SHIFT
;
266 if (pgmap
->altmap_valid
)
267 pfn
+= vmem_altmap_offset(altmap
);
271 static unsigned long pfn_end(struct dev_pagemap
*pgmap
)
273 const struct resource
*res
= &pgmap
->res
;
275 return (res
->start
+ resource_size(res
)) >> PAGE_SHIFT
;
278 static unsigned long pfn_next(unsigned long pfn
)
285 #define for_each_device_pfn(pfn, map) \
286 for (pfn = pfn_first(map); pfn < pfn_end(map); pfn = pfn_next(pfn))
288 static void devm_memremap_pages_release(void *data
)
290 struct dev_pagemap
*pgmap
= data
;
291 struct device
*dev
= pgmap
->dev
;
292 struct resource
*res
= &pgmap
->res
;
293 resource_size_t align_start
, align_size
;
296 for_each_device_pfn(pfn
, pgmap
)
297 put_page(pfn_to_page(pfn
));
299 if (percpu_ref_tryget_live(pgmap
->ref
)) {
300 dev_WARN(dev
, "%s: page mapping is still live!\n", __func__
);
301 percpu_ref_put(pgmap
->ref
);
304 /* pages are dead and unused, undo the arch mapping */
305 align_start
= res
->start
& ~(SECTION_SIZE
- 1);
306 align_size
= ALIGN(res
->start
+ resource_size(res
), SECTION_SIZE
)
310 arch_remove_memory(align_start
, align_size
, pgmap
->altmap_valid
?
311 &pgmap
->altmap
: NULL
);
314 untrack_pfn(NULL
, PHYS_PFN(align_start
), align_size
);
315 pgmap_radix_release(res
, -1);
316 dev_WARN_ONCE(dev
, pgmap
->altmap
.alloc
,
317 "%s: failed to free all reserved pages\n", __func__
);
321 * devm_memremap_pages - remap and provide memmap backing for the given resource
322 * @dev: hosting device for @res
323 * @pgmap: pointer to a struct dev_pgmap
326 * 1/ At a minimum the res, ref and type members of @pgmap must be initialized
327 * by the caller before passing it to this function
329 * 2/ The altmap field may optionally be initialized, in which case altmap_valid
330 * must be set to true
332 * 3/ pgmap.ref must be 'live' on entry and 'dead' before devm_memunmap_pages()
333 * time (or devm release event). The expected order of events is that ref has
334 * been through percpu_ref_kill() before devm_memremap_pages_release(). The
335 * wait for the completion of all references being dropped and
336 * percpu_ref_exit() must occur after devm_memremap_pages_release().
338 * 4/ res is expected to be a host memory range that could feasibly be
339 * treated as a "System RAM" range, i.e. not a device mmio range, but
340 * this is not enforced.
342 void *devm_memremap_pages(struct device
*dev
, struct dev_pagemap
*pgmap
)
344 resource_size_t align_start
, align_size
, align_end
;
345 struct vmem_altmap
*altmap
= pgmap
->altmap_valid
?
346 &pgmap
->altmap
: NULL
;
347 struct resource
*res
= &pgmap
->res
;
348 unsigned long pfn
, pgoff
, order
;
349 pgprot_t pgprot
= PAGE_KERNEL
;
350 int error
, nid
, is_ram
;
352 align_start
= res
->start
& ~(SECTION_SIZE
- 1);
353 align_size
= ALIGN(res
->start
+ resource_size(res
), SECTION_SIZE
)
355 is_ram
= region_intersects(align_start
, align_size
,
356 IORESOURCE_SYSTEM_RAM
, IORES_DESC_NONE
);
358 if (is_ram
== REGION_MIXED
) {
359 WARN_ONCE(1, "%s attempted on mixed region %pr\n",
361 return ERR_PTR(-ENXIO
);
364 if (is_ram
== REGION_INTERSECTS
)
365 return __va(res
->start
);
368 return ERR_PTR(-EINVAL
);
372 mutex_lock(&pgmap_lock
);
374 align_end
= align_start
+ align_size
- 1;
376 foreach_order_pgoff(res
, order
, pgoff
) {
377 error
= __radix_tree_insert(&pgmap_radix
,
378 PHYS_PFN(res
->start
) + pgoff
, order
, pgmap
);
380 dev_err(dev
, "%s: failed: %d\n", __func__
, error
);
384 mutex_unlock(&pgmap_lock
);
388 nid
= dev_to_node(dev
);
392 error
= track_pfn_remap(NULL
, &pgprot
, PHYS_PFN(align_start
), 0,
398 error
= arch_add_memory(nid
, align_start
, align_size
, altmap
, false);
400 move_pfn_range_to_zone(&NODE_DATA(nid
)->node_zones
[ZONE_DEVICE
],
401 align_start
>> PAGE_SHIFT
,
402 align_size
>> PAGE_SHIFT
, altmap
);
407 for_each_device_pfn(pfn
, pgmap
) {
408 struct page
*page
= pfn_to_page(pfn
);
411 * ZONE_DEVICE pages union ->lru with a ->pgmap back
412 * pointer. It is a bug if a ZONE_DEVICE page is ever
413 * freed or placed on a driver-private list. Seed the
414 * storage with LIST_POISON* values.
416 list_del(&page
->lru
);
418 percpu_ref_get(pgmap
->ref
);
421 devm_add_action(dev
, devm_memremap_pages_release
, pgmap
);
423 return __va(res
->start
);
426 untrack_pfn(NULL
, PHYS_PFN(align_start
), align_size
);
429 pgmap_radix_release(res
, pgoff
);
431 return ERR_PTR(error
);
433 EXPORT_SYMBOL(devm_memremap_pages
);
435 unsigned long vmem_altmap_offset(struct vmem_altmap
*altmap
)
437 /* number of pfns from base where pfn_to_page() is valid */
438 return altmap
->reserve
+ altmap
->free
;
441 void vmem_altmap_free(struct vmem_altmap
*altmap
, unsigned long nr_pfns
)
443 altmap
->alloc
-= nr_pfns
;
447 * get_dev_pagemap() - take a new live reference on the dev_pagemap for @pfn
448 * @pfn: page frame number to lookup page_map
449 * @pgmap: optional known pgmap that already has a reference
451 * If @pgmap is non-NULL and covers @pfn it will be returned as-is. If @pgmap
452 * is non-NULL but does not cover @pfn the reference to it will be released.
454 struct dev_pagemap
*get_dev_pagemap(unsigned long pfn
,
455 struct dev_pagemap
*pgmap
)
457 resource_size_t phys
= PFN_PHYS(pfn
);
460 * In the cached case we're already holding a live reference.
463 if (phys
>= pgmap
->res
.start
&& phys
<= pgmap
->res
.end
)
465 put_dev_pagemap(pgmap
);
468 /* fall back to slow path lookup */
470 pgmap
= radix_tree_lookup(&pgmap_radix
, PHYS_PFN(phys
));
471 if (pgmap
&& !percpu_ref_tryget_live(pgmap
->ref
))
477 #endif /* CONFIG_ZONE_DEVICE */
479 #if IS_ENABLED(CONFIG_DEVICE_PRIVATE) || IS_ENABLED(CONFIG_DEVICE_PUBLIC)
480 void put_zone_device_private_or_public_page(struct page
*page
)
482 int count
= page_ref_dec_return(page
);
485 * If refcount is 1 then page is freed and refcount is stable as nobody
486 * holds a reference on the page.
489 /* Clear Active bit in case of parallel mark_page_accessed */
490 __ClearPageActive(page
);
491 __ClearPageWaiters(page
);
493 page
->mapping
= NULL
;
494 mem_cgroup_uncharge(page
);
496 page
->pgmap
->page_free(page
, page
->pgmap
->data
);
500 EXPORT_SYMBOL(put_zone_device_private_or_public_page
);
501 #endif /* CONFIG_DEVICE_PRIVATE || CONFIG_DEVICE_PUBLIC */