Greg Kroah-Hartman | b244131 | 2017-11-01 15:07:57 +0100 | [diff] [blame] | 1 | // SPDX-License-Identifier: GPL-2.0 |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 2 | /* |
| 3 | * linux/mm/madvise.c |
| 4 | * |
| 5 | * Copyright (C) 1999 Linus Torvalds |
| 6 | * Copyright (C) 2002 Christoph Hellwig |
| 7 | */ |
| 8 | |
| 9 | #include <linux/mman.h> |
| 10 | #include <linux/pagemap.h> |
| 11 | #include <linux/syscalls.h> |
Prasanna Meda | 05b7438 | 2005-06-21 17:14:37 -0700 | [diff] [blame] | 12 | #include <linux/mempolicy.h> |
Andi Kleen | afcf938 | 2009-12-16 12:20:00 +0100 | [diff] [blame] | 13 | #include <linux/page-isolation.h> |
Minchan Kim | 9c276cc | 2019-09-25 16:49:08 -0700 | [diff] [blame] | 14 | #include <linux/page_idle.h> |
Pavel Emelyanov | 05ce772 | 2017-02-22 15:42:40 -0800 | [diff] [blame] | 15 | #include <linux/userfaultfd_k.h> |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 16 | #include <linux/hugetlb.h> |
Hugh Dickins | 3f31d07 | 2012-05-29 15:06:40 -0700 | [diff] [blame] | 17 | #include <linux/falloc.h> |
Jan Kara | 692fe62 | 2019-08-29 09:04:11 -0700 | [diff] [blame] | 18 | #include <linux/fadvise.h> |
Alexey Dobriyan | e8edc6e | 2007-05-21 01:22:52 +0400 | [diff] [blame] | 19 | #include <linux/sched.h> |
Minchan Kim | ecb8ac8 | 2020-10-17 16:14:59 -0700 | [diff] [blame] | 20 | #include <linux/sched/mm.h> |
| 21 | #include <linux/uio.h> |
Hugh Dickins | f8af4da | 2009-09-21 17:01:57 -0700 | [diff] [blame] | 22 | #include <linux/ksm.h> |
Hugh Dickins | 3f31d07 | 2012-05-29 15:06:40 -0700 | [diff] [blame] | 23 | #include <linux/fs.h> |
Andy Lutomirski | 9ab4233 | 2012-07-05 16:00:11 -0700 | [diff] [blame] | 24 | #include <linux/file.h> |
Shaohua Li | 1998cc0 | 2013-02-22 16:32:31 -0800 | [diff] [blame] | 25 | #include <linux/blkdev.h> |
Tejun Heo | 66114ca | 2015-05-22 17:13:32 -0400 | [diff] [blame] | 26 | #include <linux/backing-dev.h> |
Christoph Hellwig | a520110 | 2019-08-28 16:19:53 +0200 | [diff] [blame] | 27 | #include <linux/pagewalk.h> |
Shaohua Li | 1998cc0 | 2013-02-22 16:32:31 -0800 | [diff] [blame] | 28 | #include <linux/swap.h> |
| 29 | #include <linux/swapops.h> |
Hugh Dickins | 3a4f8a0 | 2017-02-24 14:59:36 -0800 | [diff] [blame] | 30 | #include <linux/shmem_fs.h> |
Minchan Kim | 854e9ed | 2016-01-15 16:54:53 -0800 | [diff] [blame] | 31 | #include <linux/mmu_notifier.h> |
| 32 | |
| 33 | #include <asm/tlb.h> |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 34 | |
Kirill A. Shutemov | 2351907 | 2017-02-22 15:46:39 -0800 | [diff] [blame] | 35 | #include "internal.h" |
| 36 | |
Minchan Kim | d616d51 | 2019-09-25 16:49:19 -0700 | [diff] [blame] | 37 | struct madvise_walk_private { |
| 38 | struct mmu_gather *tlb; |
| 39 | bool pageout; |
| 40 | }; |
| 41 | |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 42 | /* |
Nick Piggin | 0a27a14 | 2007-05-06 14:49:53 -0700 | [diff] [blame] | 43 | * Any behaviour which results in changes to the vma->vm_flags needs to |
Michel Lespinasse | c1e8d7c | 2020-06-08 21:33:54 -0700 | [diff] [blame] | 44 | * take mmap_lock for writing. Others, which simply traverse vmas, need |
Nick Piggin | 0a27a14 | 2007-05-06 14:49:53 -0700 | [diff] [blame] | 45 | * to only take it for reading. |
| 46 | */ |
| 47 | static int madvise_need_mmap_write(int behavior) |
| 48 | { |
| 49 | switch (behavior) { |
| 50 | case MADV_REMOVE: |
| 51 | case MADV_WILLNEED: |
| 52 | case MADV_DONTNEED: |
Minchan Kim | 9c276cc | 2019-09-25 16:49:08 -0700 | [diff] [blame] | 53 | case MADV_COLD: |
Minchan Kim | 1a4e58c | 2019-09-25 16:49:15 -0700 | [diff] [blame] | 54 | case MADV_PAGEOUT: |
Minchan Kim | 854e9ed | 2016-01-15 16:54:53 -0800 | [diff] [blame] | 55 | case MADV_FREE: |
Nick Piggin | 0a27a14 | 2007-05-06 14:49:53 -0700 | [diff] [blame] | 56 | return 0; |
| 57 | default: |
| 58 | /* be safe, default to 1. list exceptions explicitly */ |
| 59 | return 1; |
| 60 | } |
| 61 | } |
| 62 | |
| 63 | /* |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 64 | * We can potentially split a vm area into separate |
| 65 | * areas, each area with its own behavior. |
| 66 | */ |
Vladimir Cernov | ec9bed9 | 2013-09-11 14:20:15 -0700 | [diff] [blame] | 67 | static long madvise_behavior(struct vm_area_struct *vma, |
Prasanna Meda | 05b7438 | 2005-06-21 17:14:37 -0700 | [diff] [blame] | 68 | struct vm_area_struct **prev, |
| 69 | unsigned long start, unsigned long end, int behavior) |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 70 | { |
Vladimir Cernov | ec9bed9 | 2013-09-11 14:20:15 -0700 | [diff] [blame] | 71 | struct mm_struct *mm = vma->vm_mm; |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 72 | int error = 0; |
Prasanna Meda | 05b7438 | 2005-06-21 17:14:37 -0700 | [diff] [blame] | 73 | pgoff_t pgoff; |
Hugh Dickins | 3866ea9 | 2009-09-21 17:01:52 -0700 | [diff] [blame] | 74 | unsigned long new_flags = vma->vm_flags; |
Prasanna Meda | e798c6e | 2005-06-21 17:14:36 -0700 | [diff] [blame] | 75 | |
| 76 | switch (behavior) { |
Michael S. Tsirkin | f822566 | 2006-02-14 13:53:08 -0800 | [diff] [blame] | 77 | case MADV_NORMAL: |
| 78 | new_flags = new_flags & ~VM_RAND_READ & ~VM_SEQ_READ; |
| 79 | break; |
Prasanna Meda | e798c6e | 2005-06-21 17:14:36 -0700 | [diff] [blame] | 80 | case MADV_SEQUENTIAL: |
Michael S. Tsirkin | f822566 | 2006-02-14 13:53:08 -0800 | [diff] [blame] | 81 | new_flags = (new_flags & ~VM_RAND_READ) | VM_SEQ_READ; |
Prasanna Meda | e798c6e | 2005-06-21 17:14:36 -0700 | [diff] [blame] | 82 | break; |
| 83 | case MADV_RANDOM: |
Michael S. Tsirkin | f822566 | 2006-02-14 13:53:08 -0800 | [diff] [blame] | 84 | new_flags = (new_flags & ~VM_SEQ_READ) | VM_RAND_READ; |
Prasanna Meda | e798c6e | 2005-06-21 17:14:36 -0700 | [diff] [blame] | 85 | break; |
Michael S. Tsirkin | f822566 | 2006-02-14 13:53:08 -0800 | [diff] [blame] | 86 | case MADV_DONTFORK: |
| 87 | new_flags |= VM_DONTCOPY; |
| 88 | break; |
| 89 | case MADV_DOFORK: |
Hugh Dickins | 3866ea9 | 2009-09-21 17:01:52 -0700 | [diff] [blame] | 90 | if (vma->vm_flags & VM_IO) { |
| 91 | error = -EINVAL; |
| 92 | goto out; |
| 93 | } |
Michael S. Tsirkin | f822566 | 2006-02-14 13:53:08 -0800 | [diff] [blame] | 94 | new_flags &= ~VM_DONTCOPY; |
Prasanna Meda | e798c6e | 2005-06-21 17:14:36 -0700 | [diff] [blame] | 95 | break; |
Rik van Riel | d2cd9ed | 2017-09-06 16:25:15 -0700 | [diff] [blame] | 96 | case MADV_WIPEONFORK: |
| 97 | /* MADV_WIPEONFORK is only supported on anonymous memory. */ |
| 98 | if (vma->vm_file || vma->vm_flags & VM_SHARED) { |
| 99 | error = -EINVAL; |
| 100 | goto out; |
| 101 | } |
| 102 | new_flags |= VM_WIPEONFORK; |
| 103 | break; |
| 104 | case MADV_KEEPONFORK: |
| 105 | new_flags &= ~VM_WIPEONFORK; |
| 106 | break; |
Jason Baron | accb61f | 2012-03-23 15:02:51 -0700 | [diff] [blame] | 107 | case MADV_DONTDUMP: |
Konstantin Khlebnikov | 0103bd1 | 2012-10-08 16:28:59 -0700 | [diff] [blame] | 108 | new_flags |= VM_DONTDUMP; |
Jason Baron | accb61f | 2012-03-23 15:02:51 -0700 | [diff] [blame] | 109 | break; |
| 110 | case MADV_DODUMP: |
Daniel Black | d41aa52 | 2018-10-05 15:52:19 -0700 | [diff] [blame] | 111 | if (!is_vm_hugetlb_page(vma) && new_flags & VM_SPECIAL) { |
Konstantin Khlebnikov | 0103bd1 | 2012-10-08 16:28:59 -0700 | [diff] [blame] | 112 | error = -EINVAL; |
| 113 | goto out; |
| 114 | } |
| 115 | new_flags &= ~VM_DONTDUMP; |
Jason Baron | accb61f | 2012-03-23 15:02:51 -0700 | [diff] [blame] | 116 | break; |
Hugh Dickins | f8af4da | 2009-09-21 17:01:57 -0700 | [diff] [blame] | 117 | case MADV_MERGEABLE: |
| 118 | case MADV_UNMERGEABLE: |
| 119 | error = ksm_madvise(vma, start, end, behavior, &new_flags); |
Mike Rapoport | f3bc0db | 2019-09-23 15:39:31 -0700 | [diff] [blame] | 120 | if (error) |
| 121 | goto out_convert_errno; |
Hugh Dickins | f8af4da | 2009-09-21 17:01:57 -0700 | [diff] [blame] | 122 | break; |
Andrea Arcangeli | 0af4e98 | 2011-01-13 15:46:55 -0800 | [diff] [blame] | 123 | case MADV_HUGEPAGE: |
Andrea Arcangeli | a664b2d | 2011-01-13 15:47:17 -0800 | [diff] [blame] | 124 | case MADV_NOHUGEPAGE: |
Andrea Arcangeli | 60ab324 | 2011-01-13 15:47:18 -0800 | [diff] [blame] | 125 | error = hugepage_madvise(vma, &new_flags, behavior); |
Mike Rapoport | f3bc0db | 2019-09-23 15:39:31 -0700 | [diff] [blame] | 126 | if (error) |
| 127 | goto out_convert_errno; |
Andrea Arcangeli | 0af4e98 | 2011-01-13 15:46:55 -0800 | [diff] [blame] | 128 | break; |
Prasanna Meda | e798c6e | 2005-06-21 17:14:36 -0700 | [diff] [blame] | 129 | } |
| 130 | |
Prasanna Meda | 05b7438 | 2005-06-21 17:14:37 -0700 | [diff] [blame] | 131 | if (new_flags == vma->vm_flags) { |
| 132 | *prev = vma; |
Hugh Dickins | 836d5ff | 2005-09-03 15:54:53 -0700 | [diff] [blame] | 133 | goto out; |
Prasanna Meda | 05b7438 | 2005-06-21 17:14:37 -0700 | [diff] [blame] | 134 | } |
| 135 | |
| 136 | pgoff = vma->vm_pgoff + ((start - vma->vm_start) >> PAGE_SHIFT); |
| 137 | *prev = vma_merge(mm, *prev, start, end, new_flags, vma->anon_vma, |
Andrea Arcangeli | 19a809a | 2015-09-04 15:46:24 -0700 | [diff] [blame] | 138 | vma->vm_file, pgoff, vma_policy(vma), |
| 139 | vma->vm_userfaultfd_ctx); |
Prasanna Meda | 05b7438 | 2005-06-21 17:14:37 -0700 | [diff] [blame] | 140 | if (*prev) { |
| 141 | vma = *prev; |
| 142 | goto success; |
| 143 | } |
| 144 | |
| 145 | *prev = vma; |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 146 | |
| 147 | if (start != vma->vm_start) { |
David Rientjes | def5efe | 2017-02-24 14:58:47 -0800 | [diff] [blame] | 148 | if (unlikely(mm->map_count >= sysctl_max_map_count)) { |
| 149 | error = -ENOMEM; |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 150 | goto out; |
David Rientjes | def5efe | 2017-02-24 14:58:47 -0800 | [diff] [blame] | 151 | } |
| 152 | error = __split_vma(mm, vma, start, 1); |
Mike Rapoport | f3bc0db | 2019-09-23 15:39:31 -0700 | [diff] [blame] | 153 | if (error) |
| 154 | goto out_convert_errno; |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 155 | } |
| 156 | |
| 157 | if (end != vma->vm_end) { |
David Rientjes | def5efe | 2017-02-24 14:58:47 -0800 | [diff] [blame] | 158 | if (unlikely(mm->map_count >= sysctl_max_map_count)) { |
| 159 | error = -ENOMEM; |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 160 | goto out; |
David Rientjes | def5efe | 2017-02-24 14:58:47 -0800 | [diff] [blame] | 161 | } |
| 162 | error = __split_vma(mm, vma, end, 0); |
Mike Rapoport | f3bc0db | 2019-09-23 15:39:31 -0700 | [diff] [blame] | 163 | if (error) |
| 164 | goto out_convert_errno; |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 165 | } |
| 166 | |
Hugh Dickins | 836d5ff | 2005-09-03 15:54:53 -0700 | [diff] [blame] | 167 | success: |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 168 | /* |
Michel Lespinasse | c1e8d7c | 2020-06-08 21:33:54 -0700 | [diff] [blame] | 169 | * vm_flags is protected by the mmap_lock held in write mode. |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 170 | */ |
Prasanna Meda | e798c6e | 2005-06-21 17:14:36 -0700 | [diff] [blame] | 171 | vma->vm_flags = new_flags; |
Mike Rapoport | f3bc0db | 2019-09-23 15:39:31 -0700 | [diff] [blame] | 172 | |
| 173 | out_convert_errno: |
| 174 | /* |
| 175 | * madvise() returns EAGAIN if kernel resources, such as |
| 176 | * slab, are temporarily unavailable. |
| 177 | */ |
| 178 | if (error == -ENOMEM) |
| 179 | error = -EAGAIN; |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 180 | out: |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 181 | return error; |
| 182 | } |
| 183 | |
Shaohua Li | 1998cc0 | 2013-02-22 16:32:31 -0800 | [diff] [blame] | 184 | #ifdef CONFIG_SWAP |
| 185 | static int swapin_walk_pmd_entry(pmd_t *pmd, unsigned long start, |
| 186 | unsigned long end, struct mm_walk *walk) |
| 187 | { |
| 188 | pte_t *orig_pte; |
| 189 | struct vm_area_struct *vma = walk->private; |
| 190 | unsigned long index; |
| 191 | |
| 192 | if (pmd_none_or_trans_huge_or_clear_bad(pmd)) |
| 193 | return 0; |
| 194 | |
| 195 | for (index = start; index != end; index += PAGE_SIZE) { |
| 196 | pte_t pte; |
| 197 | swp_entry_t entry; |
| 198 | struct page *page; |
| 199 | spinlock_t *ptl; |
| 200 | |
| 201 | orig_pte = pte_offset_map_lock(vma->vm_mm, pmd, start, &ptl); |
| 202 | pte = *(orig_pte + ((index - start) / PAGE_SIZE)); |
| 203 | pte_unmap_unlock(orig_pte, ptl); |
| 204 | |
Kirill A. Shutemov | 0661a33 | 2015-02-10 14:10:04 -0800 | [diff] [blame] | 205 | if (pte_present(pte) || pte_none(pte)) |
Shaohua Li | 1998cc0 | 2013-02-22 16:32:31 -0800 | [diff] [blame] | 206 | continue; |
| 207 | entry = pte_to_swp_entry(pte); |
| 208 | if (unlikely(non_swap_entry(entry))) |
| 209 | continue; |
| 210 | |
| 211 | page = read_swap_cache_async(entry, GFP_HIGHUSER_MOVABLE, |
Shaohua Li | 2395562 | 2017-07-10 15:47:11 -0700 | [diff] [blame] | 212 | vma, index, false); |
Shaohua Li | 1998cc0 | 2013-02-22 16:32:31 -0800 | [diff] [blame] | 213 | if (page) |
Kirill A. Shutemov | 09cbfea | 2016-04-01 15:29:47 +0300 | [diff] [blame] | 214 | put_page(page); |
Shaohua Li | 1998cc0 | 2013-02-22 16:32:31 -0800 | [diff] [blame] | 215 | } |
| 216 | |
| 217 | return 0; |
| 218 | } |
| 219 | |
Christoph Hellwig | 7b86ac3 | 2019-08-28 16:19:54 +0200 | [diff] [blame] | 220 | static const struct mm_walk_ops swapin_walk_ops = { |
| 221 | .pmd_entry = swapin_walk_pmd_entry, |
| 222 | }; |
Shaohua Li | 1998cc0 | 2013-02-22 16:32:31 -0800 | [diff] [blame] | 223 | |
| 224 | static void force_shm_swapin_readahead(struct vm_area_struct *vma, |
| 225 | unsigned long start, unsigned long end, |
| 226 | struct address_space *mapping) |
| 227 | { |
Matthew Wilcox (Oracle) | e6e8871 | 2020-10-13 16:51:24 -0700 | [diff] [blame] | 228 | XA_STATE(xas, &mapping->i_pages, linear_page_index(vma, start)); |
Matthew Wilcox (Oracle) | 6638380 | 2020-11-21 22:17:22 -0800 | [diff] [blame^] | 229 | pgoff_t end_index = linear_page_index(vma, end + PAGE_SIZE - 1); |
Shaohua Li | 1998cc0 | 2013-02-22 16:32:31 -0800 | [diff] [blame] | 230 | struct page *page; |
Shaohua Li | 1998cc0 | 2013-02-22 16:32:31 -0800 | [diff] [blame] | 231 | |
Matthew Wilcox (Oracle) | e6e8871 | 2020-10-13 16:51:24 -0700 | [diff] [blame] | 232 | rcu_read_lock(); |
| 233 | xas_for_each(&xas, page, end_index) { |
| 234 | swp_entry_t swap; |
Shaohua Li | 1998cc0 | 2013-02-22 16:32:31 -0800 | [diff] [blame] | 235 | |
Matthew Wilcox (Oracle) | e6e8871 | 2020-10-13 16:51:24 -0700 | [diff] [blame] | 236 | if (!xa_is_value(page)) |
Shaohua Li | 1998cc0 | 2013-02-22 16:32:31 -0800 | [diff] [blame] | 237 | continue; |
Matthew Wilcox (Oracle) | e6e8871 | 2020-10-13 16:51:24 -0700 | [diff] [blame] | 238 | xas_pause(&xas); |
| 239 | rcu_read_unlock(); |
| 240 | |
Shaohua Li | 1998cc0 | 2013-02-22 16:32:31 -0800 | [diff] [blame] | 241 | swap = radix_to_swp_entry(page); |
| 242 | page = read_swap_cache_async(swap, GFP_HIGHUSER_MOVABLE, |
Shaohua Li | 2395562 | 2017-07-10 15:47:11 -0700 | [diff] [blame] | 243 | NULL, 0, false); |
Shaohua Li | 1998cc0 | 2013-02-22 16:32:31 -0800 | [diff] [blame] | 244 | if (page) |
Kirill A. Shutemov | 09cbfea | 2016-04-01 15:29:47 +0300 | [diff] [blame] | 245 | put_page(page); |
Matthew Wilcox (Oracle) | e6e8871 | 2020-10-13 16:51:24 -0700 | [diff] [blame] | 246 | |
| 247 | rcu_read_lock(); |
Shaohua Li | 1998cc0 | 2013-02-22 16:32:31 -0800 | [diff] [blame] | 248 | } |
Matthew Wilcox (Oracle) | e6e8871 | 2020-10-13 16:51:24 -0700 | [diff] [blame] | 249 | rcu_read_unlock(); |
Shaohua Li | 1998cc0 | 2013-02-22 16:32:31 -0800 | [diff] [blame] | 250 | |
| 251 | lru_add_drain(); /* Push any new pages onto the LRU now */ |
| 252 | } |
| 253 | #endif /* CONFIG_SWAP */ |
| 254 | |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 255 | /* |
| 256 | * Schedule all required I/O operations. Do not wait for completion. |
| 257 | */ |
Vladimir Cernov | ec9bed9 | 2013-09-11 14:20:15 -0700 | [diff] [blame] | 258 | static long madvise_willneed(struct vm_area_struct *vma, |
| 259 | struct vm_area_struct **prev, |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 260 | unsigned long start, unsigned long end) |
| 261 | { |
Minchan Kim | 0726b01 | 2020-10-17 16:14:50 -0700 | [diff] [blame] | 262 | struct mm_struct *mm = vma->vm_mm; |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 263 | struct file *file = vma->vm_file; |
Jan Kara | 692fe62 | 2019-08-29 09:04:11 -0700 | [diff] [blame] | 264 | loff_t offset; |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 265 | |
chenjie | 6ea8d95 | 2017-11-29 16:10:54 -0800 | [diff] [blame] | 266 | *prev = vma; |
Shaohua Li | 1998cc0 | 2013-02-22 16:32:31 -0800 | [diff] [blame] | 267 | #ifdef CONFIG_SWAP |
Christoph Hellwig | 97b713b | 2015-01-14 10:42:31 +0100 | [diff] [blame] | 268 | if (!file) { |
Christoph Hellwig | 7b86ac3 | 2019-08-28 16:19:54 +0200 | [diff] [blame] | 269 | walk_page_range(vma->vm_mm, start, end, &swapin_walk_ops, vma); |
| 270 | lru_add_drain(); /* Push any new pages onto the LRU now */ |
Shaohua Li | 1998cc0 | 2013-02-22 16:32:31 -0800 | [diff] [blame] | 271 | return 0; |
| 272 | } |
Shaohua Li | 1998cc0 | 2013-02-22 16:32:31 -0800 | [diff] [blame] | 273 | |
Christoph Hellwig | 97b713b | 2015-01-14 10:42:31 +0100 | [diff] [blame] | 274 | if (shmem_mapping(file->f_mapping)) { |
Christoph Hellwig | 97b713b | 2015-01-14 10:42:31 +0100 | [diff] [blame] | 275 | force_shm_swapin_readahead(vma, start, end, |
| 276 | file->f_mapping); |
| 277 | return 0; |
| 278 | } |
| 279 | #else |
Suzuki | 1bef400 | 2005-10-11 08:29:06 -0700 | [diff] [blame] | 280 | if (!file) |
| 281 | return -EBADF; |
Christoph Hellwig | 97b713b | 2015-01-14 10:42:31 +0100 | [diff] [blame] | 282 | #endif |
Suzuki | 1bef400 | 2005-10-11 08:29:06 -0700 | [diff] [blame] | 283 | |
Matthew Wilcox | e748dcd | 2015-02-16 15:59:12 -0800 | [diff] [blame] | 284 | if (IS_DAX(file_inode(file))) { |
Carsten Otte | fe77ba6 | 2005-06-23 22:05:29 -0700 | [diff] [blame] | 285 | /* no bad return value, but ignore advice */ |
| 286 | return 0; |
| 287 | } |
| 288 | |
Jan Kara | 692fe62 | 2019-08-29 09:04:11 -0700 | [diff] [blame] | 289 | /* |
| 290 | * Filesystem's fadvise may need to take various locks. We need to |
| 291 | * explicitly grab a reference because the vma (and hence the |
| 292 | * vma's reference to the file) can go away as soon as we drop |
Michel Lespinasse | c1e8d7c | 2020-06-08 21:33:54 -0700 | [diff] [blame] | 293 | * mmap_lock. |
Jan Kara | 692fe62 | 2019-08-29 09:04:11 -0700 | [diff] [blame] | 294 | */ |
Michel Lespinasse | c1e8d7c | 2020-06-08 21:33:54 -0700 | [diff] [blame] | 295 | *prev = NULL; /* tell sys_madvise we drop mmap_lock */ |
Jan Kara | 692fe62 | 2019-08-29 09:04:11 -0700 | [diff] [blame] | 296 | get_file(file); |
Jan Kara | 692fe62 | 2019-08-29 09:04:11 -0700 | [diff] [blame] | 297 | offset = (loff_t)(start - vma->vm_start) |
| 298 | + ((loff_t)vma->vm_pgoff << PAGE_SHIFT); |
Minchan Kim | 0726b01 | 2020-10-17 16:14:50 -0700 | [diff] [blame] | 299 | mmap_read_unlock(mm); |
Jan Kara | 692fe62 | 2019-08-29 09:04:11 -0700 | [diff] [blame] | 300 | vfs_fadvise(file, offset, end - start, POSIX_FADV_WILLNEED); |
| 301 | fput(file); |
Minchan Kim | 0726b01 | 2020-10-17 16:14:50 -0700 | [diff] [blame] | 302 | mmap_read_lock(mm); |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 303 | return 0; |
| 304 | } |
| 305 | |
Minchan Kim | d616d51 | 2019-09-25 16:49:19 -0700 | [diff] [blame] | 306 | static int madvise_cold_or_pageout_pte_range(pmd_t *pmd, |
| 307 | unsigned long addr, unsigned long end, |
| 308 | struct mm_walk *walk) |
Minchan Kim | 9c276cc | 2019-09-25 16:49:08 -0700 | [diff] [blame] | 309 | { |
Minchan Kim | d616d51 | 2019-09-25 16:49:19 -0700 | [diff] [blame] | 310 | struct madvise_walk_private *private = walk->private; |
| 311 | struct mmu_gather *tlb = private->tlb; |
| 312 | bool pageout = private->pageout; |
Minchan Kim | 9c276cc | 2019-09-25 16:49:08 -0700 | [diff] [blame] | 313 | struct mm_struct *mm = tlb->mm; |
| 314 | struct vm_area_struct *vma = walk->vma; |
| 315 | pte_t *orig_pte, *pte, ptent; |
| 316 | spinlock_t *ptl; |
Minchan Kim | d616d51 | 2019-09-25 16:49:19 -0700 | [diff] [blame] | 317 | struct page *page = NULL; |
| 318 | LIST_HEAD(page_list); |
| 319 | |
| 320 | if (fatal_signal_pending(current)) |
| 321 | return -EINTR; |
Minchan Kim | 9c276cc | 2019-09-25 16:49:08 -0700 | [diff] [blame] | 322 | |
| 323 | #ifdef CONFIG_TRANSPARENT_HUGEPAGE |
| 324 | if (pmd_trans_huge(*pmd)) { |
| 325 | pmd_t orig_pmd; |
| 326 | unsigned long next = pmd_addr_end(addr, end); |
| 327 | |
| 328 | tlb_change_page_size(tlb, HPAGE_PMD_SIZE); |
| 329 | ptl = pmd_trans_huge_lock(pmd, vma); |
| 330 | if (!ptl) |
| 331 | return 0; |
| 332 | |
| 333 | orig_pmd = *pmd; |
| 334 | if (is_huge_zero_pmd(orig_pmd)) |
| 335 | goto huge_unlock; |
| 336 | |
| 337 | if (unlikely(!pmd_present(orig_pmd))) { |
| 338 | VM_BUG_ON(thp_migration_supported() && |
| 339 | !is_pmd_migration_entry(orig_pmd)); |
| 340 | goto huge_unlock; |
| 341 | } |
| 342 | |
| 343 | page = pmd_page(orig_pmd); |
Michal Hocko | 12e967f | 2020-03-21 18:22:26 -0700 | [diff] [blame] | 344 | |
| 345 | /* Do not interfere with other mappings of this page */ |
| 346 | if (page_mapcount(page) != 1) |
| 347 | goto huge_unlock; |
| 348 | |
Minchan Kim | 9c276cc | 2019-09-25 16:49:08 -0700 | [diff] [blame] | 349 | if (next - addr != HPAGE_PMD_SIZE) { |
| 350 | int err; |
| 351 | |
Minchan Kim | 9c276cc | 2019-09-25 16:49:08 -0700 | [diff] [blame] | 352 | get_page(page); |
| 353 | spin_unlock(ptl); |
| 354 | lock_page(page); |
| 355 | err = split_huge_page(page); |
| 356 | unlock_page(page); |
| 357 | put_page(page); |
| 358 | if (!err) |
| 359 | goto regular_page; |
| 360 | return 0; |
| 361 | } |
| 362 | |
| 363 | if (pmd_young(orig_pmd)) { |
| 364 | pmdp_invalidate(vma, addr, pmd); |
| 365 | orig_pmd = pmd_mkold(orig_pmd); |
| 366 | |
| 367 | set_pmd_at(mm, addr, pmd, orig_pmd); |
| 368 | tlb_remove_pmd_tlb_entry(tlb, pmd, addr); |
| 369 | } |
| 370 | |
Minchan Kim | d616d51 | 2019-09-25 16:49:19 -0700 | [diff] [blame] | 371 | ClearPageReferenced(page); |
Minchan Kim | 9c276cc | 2019-09-25 16:49:08 -0700 | [diff] [blame] | 372 | test_and_clear_page_young(page); |
Minchan Kim | d616d51 | 2019-09-25 16:49:19 -0700 | [diff] [blame] | 373 | if (pageout) { |
zhong jiang | 8207296 | 2019-11-15 17:34:36 -0800 | [diff] [blame] | 374 | if (!isolate_lru_page(page)) { |
| 375 | if (PageUnevictable(page)) |
| 376 | putback_lru_page(page); |
| 377 | else |
| 378 | list_add(&page->lru, &page_list); |
| 379 | } |
Minchan Kim | d616d51 | 2019-09-25 16:49:19 -0700 | [diff] [blame] | 380 | } else |
| 381 | deactivate_page(page); |
Minchan Kim | 9c276cc | 2019-09-25 16:49:08 -0700 | [diff] [blame] | 382 | huge_unlock: |
| 383 | spin_unlock(ptl); |
Minchan Kim | d616d51 | 2019-09-25 16:49:19 -0700 | [diff] [blame] | 384 | if (pageout) |
| 385 | reclaim_pages(&page_list); |
Minchan Kim | 9c276cc | 2019-09-25 16:49:08 -0700 | [diff] [blame] | 386 | return 0; |
| 387 | } |
| 388 | |
Minchan Kim | ce26842 | 2020-09-14 23:32:15 -0700 | [diff] [blame] | 389 | regular_page: |
Minchan Kim | 9c276cc | 2019-09-25 16:49:08 -0700 | [diff] [blame] | 390 | if (pmd_trans_unstable(pmd)) |
| 391 | return 0; |
Minchan Kim | 9c276cc | 2019-09-25 16:49:08 -0700 | [diff] [blame] | 392 | #endif |
| 393 | tlb_change_page_size(tlb, PAGE_SIZE); |
| 394 | orig_pte = pte = pte_offset_map_lock(vma->vm_mm, pmd, addr, &ptl); |
| 395 | flush_tlb_batched_pending(mm); |
| 396 | arch_enter_lazy_mmu_mode(); |
| 397 | for (; addr < end; pte++, addr += PAGE_SIZE) { |
| 398 | ptent = *pte; |
| 399 | |
| 400 | if (pte_none(ptent)) |
| 401 | continue; |
| 402 | |
| 403 | if (!pte_present(ptent)) |
| 404 | continue; |
| 405 | |
| 406 | page = vm_normal_page(vma, addr, ptent); |
| 407 | if (!page) |
| 408 | continue; |
| 409 | |
| 410 | /* |
| 411 | * Creating a THP page is expensive so split it only if we |
| 412 | * are sure it's worth. Split it if we are only owner. |
| 413 | */ |
| 414 | if (PageTransCompound(page)) { |
| 415 | if (page_mapcount(page) != 1) |
| 416 | break; |
| 417 | get_page(page); |
| 418 | if (!trylock_page(page)) { |
| 419 | put_page(page); |
| 420 | break; |
| 421 | } |
| 422 | pte_unmap_unlock(orig_pte, ptl); |
| 423 | if (split_huge_page(page)) { |
| 424 | unlock_page(page); |
| 425 | put_page(page); |
| 426 | pte_offset_map_lock(mm, pmd, addr, &ptl); |
| 427 | break; |
| 428 | } |
| 429 | unlock_page(page); |
| 430 | put_page(page); |
| 431 | pte = pte_offset_map_lock(mm, pmd, addr, &ptl); |
| 432 | pte--; |
| 433 | addr -= PAGE_SIZE; |
| 434 | continue; |
| 435 | } |
| 436 | |
Michal Hocko | 12e967f | 2020-03-21 18:22:26 -0700 | [diff] [blame] | 437 | /* Do not interfere with other mappings of this page */ |
| 438 | if (page_mapcount(page) != 1) |
| 439 | continue; |
| 440 | |
Minchan Kim | 9c276cc | 2019-09-25 16:49:08 -0700 | [diff] [blame] | 441 | VM_BUG_ON_PAGE(PageTransCompound(page), page); |
| 442 | |
| 443 | if (pte_young(ptent)) { |
| 444 | ptent = ptep_get_and_clear_full(mm, addr, pte, |
| 445 | tlb->fullmm); |
| 446 | ptent = pte_mkold(ptent); |
| 447 | set_pte_at(mm, addr, pte, ptent); |
| 448 | tlb_remove_tlb_entry(tlb, pte, addr); |
| 449 | } |
| 450 | |
| 451 | /* |
| 452 | * We are deactivating a page for accelerating reclaiming. |
| 453 | * VM couldn't reclaim the page unless we clear PG_young. |
| 454 | * As a side effect, it makes confuse idle-page tracking |
| 455 | * because they will miss recent referenced history. |
| 456 | */ |
Minchan Kim | d616d51 | 2019-09-25 16:49:19 -0700 | [diff] [blame] | 457 | ClearPageReferenced(page); |
Minchan Kim | 9c276cc | 2019-09-25 16:49:08 -0700 | [diff] [blame] | 458 | test_and_clear_page_young(page); |
Minchan Kim | d616d51 | 2019-09-25 16:49:19 -0700 | [diff] [blame] | 459 | if (pageout) { |
zhong jiang | 8207296 | 2019-11-15 17:34:36 -0800 | [diff] [blame] | 460 | if (!isolate_lru_page(page)) { |
| 461 | if (PageUnevictable(page)) |
| 462 | putback_lru_page(page); |
| 463 | else |
| 464 | list_add(&page->lru, &page_list); |
| 465 | } |
Minchan Kim | d616d51 | 2019-09-25 16:49:19 -0700 | [diff] [blame] | 466 | } else |
| 467 | deactivate_page(page); |
Minchan Kim | 9c276cc | 2019-09-25 16:49:08 -0700 | [diff] [blame] | 468 | } |
| 469 | |
| 470 | arch_leave_lazy_mmu_mode(); |
| 471 | pte_unmap_unlock(orig_pte, ptl); |
Minchan Kim | d616d51 | 2019-09-25 16:49:19 -0700 | [diff] [blame] | 472 | if (pageout) |
| 473 | reclaim_pages(&page_list); |
Minchan Kim | 9c276cc | 2019-09-25 16:49:08 -0700 | [diff] [blame] | 474 | cond_resched(); |
| 475 | |
| 476 | return 0; |
| 477 | } |
| 478 | |
| 479 | static const struct mm_walk_ops cold_walk_ops = { |
Minchan Kim | d616d51 | 2019-09-25 16:49:19 -0700 | [diff] [blame] | 480 | .pmd_entry = madvise_cold_or_pageout_pte_range, |
Minchan Kim | 9c276cc | 2019-09-25 16:49:08 -0700 | [diff] [blame] | 481 | }; |
| 482 | |
| 483 | static void madvise_cold_page_range(struct mmu_gather *tlb, |
| 484 | struct vm_area_struct *vma, |
| 485 | unsigned long addr, unsigned long end) |
| 486 | { |
Minchan Kim | d616d51 | 2019-09-25 16:49:19 -0700 | [diff] [blame] | 487 | struct madvise_walk_private walk_private = { |
| 488 | .pageout = false, |
| 489 | .tlb = tlb, |
| 490 | }; |
| 491 | |
Minchan Kim | 9c276cc | 2019-09-25 16:49:08 -0700 | [diff] [blame] | 492 | tlb_start_vma(tlb, vma); |
Minchan Kim | d616d51 | 2019-09-25 16:49:19 -0700 | [diff] [blame] | 493 | walk_page_range(vma->vm_mm, addr, end, &cold_walk_ops, &walk_private); |
Minchan Kim | 9c276cc | 2019-09-25 16:49:08 -0700 | [diff] [blame] | 494 | tlb_end_vma(tlb, vma); |
| 495 | } |
| 496 | |
| 497 | static long madvise_cold(struct vm_area_struct *vma, |
| 498 | struct vm_area_struct **prev, |
| 499 | unsigned long start_addr, unsigned long end_addr) |
| 500 | { |
| 501 | struct mm_struct *mm = vma->vm_mm; |
| 502 | struct mmu_gather tlb; |
| 503 | |
| 504 | *prev = vma; |
| 505 | if (!can_madv_lru_vma(vma)) |
| 506 | return -EINVAL; |
| 507 | |
| 508 | lru_add_drain(); |
| 509 | tlb_gather_mmu(&tlb, mm, start_addr, end_addr); |
| 510 | madvise_cold_page_range(&tlb, vma, start_addr, end_addr); |
| 511 | tlb_finish_mmu(&tlb, start_addr, end_addr); |
| 512 | |
| 513 | return 0; |
| 514 | } |
| 515 | |
Minchan Kim | 1a4e58c | 2019-09-25 16:49:15 -0700 | [diff] [blame] | 516 | static void madvise_pageout_page_range(struct mmu_gather *tlb, |
| 517 | struct vm_area_struct *vma, |
| 518 | unsigned long addr, unsigned long end) |
| 519 | { |
Minchan Kim | d616d51 | 2019-09-25 16:49:19 -0700 | [diff] [blame] | 520 | struct madvise_walk_private walk_private = { |
| 521 | .pageout = true, |
| 522 | .tlb = tlb, |
| 523 | }; |
| 524 | |
Minchan Kim | 1a4e58c | 2019-09-25 16:49:15 -0700 | [diff] [blame] | 525 | tlb_start_vma(tlb, vma); |
Minchan Kim | d616d51 | 2019-09-25 16:49:19 -0700 | [diff] [blame] | 526 | walk_page_range(vma->vm_mm, addr, end, &cold_walk_ops, &walk_private); |
Minchan Kim | 1a4e58c | 2019-09-25 16:49:15 -0700 | [diff] [blame] | 527 | tlb_end_vma(tlb, vma); |
| 528 | } |
| 529 | |
| 530 | static inline bool can_do_pageout(struct vm_area_struct *vma) |
| 531 | { |
| 532 | if (vma_is_anonymous(vma)) |
| 533 | return true; |
| 534 | if (!vma->vm_file) |
| 535 | return false; |
| 536 | /* |
| 537 | * paging out pagecache only for non-anonymous mappings that correspond |
| 538 | * to the files the calling process could (if tried) open for writing; |
| 539 | * otherwise we'd be including shared non-exclusive mappings, which |
| 540 | * opens a side channel. |
| 541 | */ |
| 542 | return inode_owner_or_capable(file_inode(vma->vm_file)) || |
| 543 | inode_permission(file_inode(vma->vm_file), MAY_WRITE) == 0; |
| 544 | } |
| 545 | |
| 546 | static long madvise_pageout(struct vm_area_struct *vma, |
| 547 | struct vm_area_struct **prev, |
| 548 | unsigned long start_addr, unsigned long end_addr) |
| 549 | { |
| 550 | struct mm_struct *mm = vma->vm_mm; |
| 551 | struct mmu_gather tlb; |
| 552 | |
| 553 | *prev = vma; |
| 554 | if (!can_madv_lru_vma(vma)) |
| 555 | return -EINVAL; |
| 556 | |
| 557 | if (!can_do_pageout(vma)) |
| 558 | return 0; |
| 559 | |
| 560 | lru_add_drain(); |
| 561 | tlb_gather_mmu(&tlb, mm, start_addr, end_addr); |
| 562 | madvise_pageout_page_range(&tlb, vma, start_addr, end_addr); |
| 563 | tlb_finish_mmu(&tlb, start_addr, end_addr); |
| 564 | |
| 565 | return 0; |
| 566 | } |
| 567 | |
Minchan Kim | 854e9ed | 2016-01-15 16:54:53 -0800 | [diff] [blame] | 568 | static int madvise_free_pte_range(pmd_t *pmd, unsigned long addr, |
| 569 | unsigned long end, struct mm_walk *walk) |
| 570 | |
| 571 | { |
| 572 | struct mmu_gather *tlb = walk->private; |
| 573 | struct mm_struct *mm = tlb->mm; |
| 574 | struct vm_area_struct *vma = walk->vma; |
| 575 | spinlock_t *ptl; |
| 576 | pte_t *orig_pte, *pte, ptent; |
| 577 | struct page *page; |
Minchan Kim | 64b42bc | 2016-01-15 16:55:06 -0800 | [diff] [blame] | 578 | int nr_swap = 0; |
Minchan Kim | b8d3c4c | 2016-01-15 16:55:42 -0800 | [diff] [blame] | 579 | unsigned long next; |
Minchan Kim | 854e9ed | 2016-01-15 16:54:53 -0800 | [diff] [blame] | 580 | |
Minchan Kim | b8d3c4c | 2016-01-15 16:55:42 -0800 | [diff] [blame] | 581 | next = pmd_addr_end(addr, end); |
| 582 | if (pmd_trans_huge(*pmd)) |
| 583 | if (madvise_free_huge_pmd(tlb, vma, pmd, addr, next)) |
| 584 | goto next; |
| 585 | |
Minchan Kim | 854e9ed | 2016-01-15 16:54:53 -0800 | [diff] [blame] | 586 | if (pmd_trans_unstable(pmd)) |
| 587 | return 0; |
| 588 | |
Peter Zijlstra | ed6a793 | 2018-08-31 14:46:08 +0200 | [diff] [blame] | 589 | tlb_change_page_size(tlb, PAGE_SIZE); |
Minchan Kim | 854e9ed | 2016-01-15 16:54:53 -0800 | [diff] [blame] | 590 | orig_pte = pte = pte_offset_map_lock(mm, pmd, addr, &ptl); |
Mel Gorman | 3ea2771 | 2017-08-02 13:31:52 -0700 | [diff] [blame] | 591 | flush_tlb_batched_pending(mm); |
Minchan Kim | 854e9ed | 2016-01-15 16:54:53 -0800 | [diff] [blame] | 592 | arch_enter_lazy_mmu_mode(); |
| 593 | for (; addr != end; pte++, addr += PAGE_SIZE) { |
| 594 | ptent = *pte; |
| 595 | |
Minchan Kim | 64b42bc | 2016-01-15 16:55:06 -0800 | [diff] [blame] | 596 | if (pte_none(ptent)) |
Minchan Kim | 854e9ed | 2016-01-15 16:54:53 -0800 | [diff] [blame] | 597 | continue; |
Minchan Kim | 64b42bc | 2016-01-15 16:55:06 -0800 | [diff] [blame] | 598 | /* |
| 599 | * If the pte has swp_entry, just clear page table to |
| 600 | * prevent swap-in which is more expensive rather than |
| 601 | * (page allocation + zeroing). |
| 602 | */ |
| 603 | if (!pte_present(ptent)) { |
| 604 | swp_entry_t entry; |
| 605 | |
| 606 | entry = pte_to_swp_entry(ptent); |
| 607 | if (non_swap_entry(entry)) |
| 608 | continue; |
| 609 | nr_swap--; |
| 610 | free_swap_and_cache(entry); |
| 611 | pte_clear_not_present_full(mm, addr, pte, tlb->fullmm); |
| 612 | continue; |
| 613 | } |
Minchan Kim | 854e9ed | 2016-01-15 16:54:53 -0800 | [diff] [blame] | 614 | |
Christoph Hellwig | 25b2995 | 2019-06-13 22:50:49 +0200 | [diff] [blame] | 615 | page = vm_normal_page(vma, addr, ptent); |
Minchan Kim | 854e9ed | 2016-01-15 16:54:53 -0800 | [diff] [blame] | 616 | if (!page) |
| 617 | continue; |
| 618 | |
| 619 | /* |
| 620 | * If pmd isn't transhuge but the page is THP and |
| 621 | * is owned by only this process, split it and |
| 622 | * deactivate all pages. |
| 623 | */ |
| 624 | if (PageTransCompound(page)) { |
| 625 | if (page_mapcount(page) != 1) |
| 626 | goto out; |
| 627 | get_page(page); |
| 628 | if (!trylock_page(page)) { |
| 629 | put_page(page); |
| 630 | goto out; |
| 631 | } |
| 632 | pte_unmap_unlock(orig_pte, ptl); |
| 633 | if (split_huge_page(page)) { |
| 634 | unlock_page(page); |
| 635 | put_page(page); |
| 636 | pte_offset_map_lock(mm, pmd, addr, &ptl); |
| 637 | goto out; |
| 638 | } |
Minchan Kim | 854e9ed | 2016-01-15 16:54:53 -0800 | [diff] [blame] | 639 | unlock_page(page); |
Eric Biggers | 263630e | 2017-08-25 15:55:39 -0700 | [diff] [blame] | 640 | put_page(page); |
Minchan Kim | 854e9ed | 2016-01-15 16:54:53 -0800 | [diff] [blame] | 641 | pte = pte_offset_map_lock(mm, pmd, addr, &ptl); |
| 642 | pte--; |
| 643 | addr -= PAGE_SIZE; |
| 644 | continue; |
| 645 | } |
| 646 | |
| 647 | VM_BUG_ON_PAGE(PageTransCompound(page), page); |
| 648 | |
| 649 | if (PageSwapCache(page) || PageDirty(page)) { |
| 650 | if (!trylock_page(page)) |
| 651 | continue; |
| 652 | /* |
| 653 | * If page is shared with others, we couldn't clear |
| 654 | * PG_dirty of the page. |
| 655 | */ |
| 656 | if (page_mapcount(page) != 1) { |
| 657 | unlock_page(page); |
| 658 | continue; |
| 659 | } |
| 660 | |
| 661 | if (PageSwapCache(page) && !try_to_free_swap(page)) { |
| 662 | unlock_page(page); |
| 663 | continue; |
| 664 | } |
| 665 | |
| 666 | ClearPageDirty(page); |
| 667 | unlock_page(page); |
| 668 | } |
| 669 | |
| 670 | if (pte_young(ptent) || pte_dirty(ptent)) { |
| 671 | /* |
| 672 | * Some of architecture(ex, PPC) don't update TLB |
| 673 | * with set_pte_at and tlb_remove_tlb_entry so for |
| 674 | * the portability, remap the pte with old|clean |
| 675 | * after pte clearing. |
| 676 | */ |
| 677 | ptent = ptep_get_and_clear_full(mm, addr, pte, |
| 678 | tlb->fullmm); |
| 679 | |
| 680 | ptent = pte_mkold(ptent); |
| 681 | ptent = pte_mkclean(ptent); |
| 682 | set_pte_at(mm, addr, pte, ptent); |
| 683 | tlb_remove_tlb_entry(tlb, pte, addr); |
| 684 | } |
Shaohua Li | 802a3a9 | 2017-05-03 14:52:32 -0700 | [diff] [blame] | 685 | mark_page_lazyfree(page); |
Minchan Kim | 854e9ed | 2016-01-15 16:54:53 -0800 | [diff] [blame] | 686 | } |
| 687 | out: |
Minchan Kim | 64b42bc | 2016-01-15 16:55:06 -0800 | [diff] [blame] | 688 | if (nr_swap) { |
| 689 | if (current->mm == mm) |
| 690 | sync_mm_rss(mm); |
| 691 | |
| 692 | add_mm_counter(mm, MM_SWAPENTS, nr_swap); |
| 693 | } |
Minchan Kim | 854e9ed | 2016-01-15 16:54:53 -0800 | [diff] [blame] | 694 | arch_leave_lazy_mmu_mode(); |
| 695 | pte_unmap_unlock(orig_pte, ptl); |
| 696 | cond_resched(); |
Minchan Kim | b8d3c4c | 2016-01-15 16:55:42 -0800 | [diff] [blame] | 697 | next: |
Minchan Kim | 854e9ed | 2016-01-15 16:54:53 -0800 | [diff] [blame] | 698 | return 0; |
| 699 | } |
| 700 | |
Christoph Hellwig | 7b86ac3 | 2019-08-28 16:19:54 +0200 | [diff] [blame] | 701 | static const struct mm_walk_ops madvise_free_walk_ops = { |
| 702 | .pmd_entry = madvise_free_pte_range, |
| 703 | }; |
Minchan Kim | 854e9ed | 2016-01-15 16:54:53 -0800 | [diff] [blame] | 704 | |
| 705 | static int madvise_free_single_vma(struct vm_area_struct *vma, |
| 706 | unsigned long start_addr, unsigned long end_addr) |
| 707 | { |
Minchan Kim | 854e9ed | 2016-01-15 16:54:53 -0800 | [diff] [blame] | 708 | struct mm_struct *mm = vma->vm_mm; |
Jérôme Glisse | ac46d4f | 2018-12-28 00:38:09 -0800 | [diff] [blame] | 709 | struct mmu_notifier_range range; |
Minchan Kim | 854e9ed | 2016-01-15 16:54:53 -0800 | [diff] [blame] | 710 | struct mmu_gather tlb; |
| 711 | |
Minchan Kim | 854e9ed | 2016-01-15 16:54:53 -0800 | [diff] [blame] | 712 | /* MADV_FREE works for only anon vma at the moment */ |
| 713 | if (!vma_is_anonymous(vma)) |
| 714 | return -EINVAL; |
| 715 | |
Jérôme Glisse | ac46d4f | 2018-12-28 00:38:09 -0800 | [diff] [blame] | 716 | range.start = max(vma->vm_start, start_addr); |
| 717 | if (range.start >= vma->vm_end) |
Minchan Kim | 854e9ed | 2016-01-15 16:54:53 -0800 | [diff] [blame] | 718 | return -EINVAL; |
Jérôme Glisse | ac46d4f | 2018-12-28 00:38:09 -0800 | [diff] [blame] | 719 | range.end = min(vma->vm_end, end_addr); |
| 720 | if (range.end <= vma->vm_start) |
Minchan Kim | 854e9ed | 2016-01-15 16:54:53 -0800 | [diff] [blame] | 721 | return -EINVAL; |
Jérôme Glisse | 7269f99 | 2019-05-13 17:20:53 -0700 | [diff] [blame] | 722 | mmu_notifier_range_init(&range, MMU_NOTIFY_CLEAR, 0, vma, mm, |
Jérôme Glisse | 6f4f13e | 2019-05-13 17:20:49 -0700 | [diff] [blame] | 723 | range.start, range.end); |
Minchan Kim | 854e9ed | 2016-01-15 16:54:53 -0800 | [diff] [blame] | 724 | |
| 725 | lru_add_drain(); |
Jérôme Glisse | ac46d4f | 2018-12-28 00:38:09 -0800 | [diff] [blame] | 726 | tlb_gather_mmu(&tlb, mm, range.start, range.end); |
Minchan Kim | 854e9ed | 2016-01-15 16:54:53 -0800 | [diff] [blame] | 727 | update_hiwater_rss(mm); |
| 728 | |
Jérôme Glisse | ac46d4f | 2018-12-28 00:38:09 -0800 | [diff] [blame] | 729 | mmu_notifier_invalidate_range_start(&range); |
Christoph Hellwig | 7b86ac3 | 2019-08-28 16:19:54 +0200 | [diff] [blame] | 730 | tlb_start_vma(&tlb, vma); |
| 731 | walk_page_range(vma->vm_mm, range.start, range.end, |
| 732 | &madvise_free_walk_ops, &tlb); |
| 733 | tlb_end_vma(&tlb, vma); |
Jérôme Glisse | ac46d4f | 2018-12-28 00:38:09 -0800 | [diff] [blame] | 734 | mmu_notifier_invalidate_range_end(&range); |
| 735 | tlb_finish_mmu(&tlb, range.start, range.end); |
Minchan Kim | 854e9ed | 2016-01-15 16:54:53 -0800 | [diff] [blame] | 736 | |
| 737 | return 0; |
| 738 | } |
| 739 | |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 740 | /* |
| 741 | * Application no longer needs these pages. If the pages are dirty, |
| 742 | * it's OK to just throw them away. The app will be more careful about |
| 743 | * data it wants to keep. Be sure to free swap resources too. The |
Fernando Luis Vazquez Cao | 7e6cbea | 2008-07-29 22:33:39 -0700 | [diff] [blame] | 744 | * zap_page_range call sets things up for shrink_active_list to actually free |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 745 | * these pages later if no one else has touched them in the meantime, |
| 746 | * although we could add these pages to a global reuse list for |
Fernando Luis Vazquez Cao | 7e6cbea | 2008-07-29 22:33:39 -0700 | [diff] [blame] | 747 | * shrink_active_list to pick up before reclaiming other pages. |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 748 | * |
| 749 | * NB: This interface discards data rather than pushes it out to swap, |
| 750 | * as some implementations do. This has performance implications for |
| 751 | * applications like large transactional databases which want to discard |
| 752 | * pages in anonymous maps after committing to backing store the data |
| 753 | * that was kept in them. There is no reason to write this data out to |
| 754 | * the swap area if the application is discarding it. |
| 755 | * |
| 756 | * An interface that causes the system to free clean pages and flush |
| 757 | * dirty pages is already available as msync(MS_INVALIDATE). |
| 758 | */ |
Mike Rapoport | 230ca98 | 2017-07-10 15:49:02 -0700 | [diff] [blame] | 759 | static long madvise_dontneed_single_vma(struct vm_area_struct *vma, |
| 760 | unsigned long start, unsigned long end) |
| 761 | { |
| 762 | zap_page_range(vma, start, end - start); |
| 763 | return 0; |
| 764 | } |
| 765 | |
| 766 | static long madvise_dontneed_free(struct vm_area_struct *vma, |
| 767 | struct vm_area_struct **prev, |
| 768 | unsigned long start, unsigned long end, |
| 769 | int behavior) |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 770 | { |
Minchan Kim | 0726b01 | 2020-10-17 16:14:50 -0700 | [diff] [blame] | 771 | struct mm_struct *mm = vma->vm_mm; |
| 772 | |
Prasanna Meda | 05b7438 | 2005-06-21 17:14:37 -0700 | [diff] [blame] | 773 | *prev = vma; |
Minchan Kim | 9c276cc | 2019-09-25 16:49:08 -0700 | [diff] [blame] | 774 | if (!can_madv_lru_vma(vma)) |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 775 | return -EINVAL; |
| 776 | |
Andrea Arcangeli | 70ccb92 | 2017-03-09 16:17:11 -0800 | [diff] [blame] | 777 | if (!userfaultfd_remove(vma, start, end)) { |
Michel Lespinasse | c1e8d7c | 2020-06-08 21:33:54 -0700 | [diff] [blame] | 778 | *prev = NULL; /* mmap_lock has been dropped, prev is stale */ |
Andrea Arcangeli | 70ccb92 | 2017-03-09 16:17:11 -0800 | [diff] [blame] | 779 | |
Minchan Kim | 0726b01 | 2020-10-17 16:14:50 -0700 | [diff] [blame] | 780 | mmap_read_lock(mm); |
| 781 | vma = find_vma(mm, start); |
Andrea Arcangeli | 70ccb92 | 2017-03-09 16:17:11 -0800 | [diff] [blame] | 782 | if (!vma) |
| 783 | return -ENOMEM; |
| 784 | if (start < vma->vm_start) { |
| 785 | /* |
| 786 | * This "vma" under revalidation is the one |
| 787 | * with the lowest vma->vm_start where start |
| 788 | * is also < vma->vm_end. If start < |
| 789 | * vma->vm_start it means an hole materialized |
| 790 | * in the user address space within the |
Mike Rapoport | 230ca98 | 2017-07-10 15:49:02 -0700 | [diff] [blame] | 791 | * virtual range passed to MADV_DONTNEED |
| 792 | * or MADV_FREE. |
Andrea Arcangeli | 70ccb92 | 2017-03-09 16:17:11 -0800 | [diff] [blame] | 793 | */ |
| 794 | return -ENOMEM; |
| 795 | } |
Minchan Kim | 9c276cc | 2019-09-25 16:49:08 -0700 | [diff] [blame] | 796 | if (!can_madv_lru_vma(vma)) |
Andrea Arcangeli | 70ccb92 | 2017-03-09 16:17:11 -0800 | [diff] [blame] | 797 | return -EINVAL; |
| 798 | if (end > vma->vm_end) { |
| 799 | /* |
| 800 | * Don't fail if end > vma->vm_end. If the old |
Michel Lespinasse | c1e8d7c | 2020-06-08 21:33:54 -0700 | [diff] [blame] | 801 | * vma was splitted while the mmap_lock was |
Andrea Arcangeli | 70ccb92 | 2017-03-09 16:17:11 -0800 | [diff] [blame] | 802 | * released the effect of the concurrent |
Mike Rapoport | 230ca98 | 2017-07-10 15:49:02 -0700 | [diff] [blame] | 803 | * operation may not cause madvise() to |
Andrea Arcangeli | 70ccb92 | 2017-03-09 16:17:11 -0800 | [diff] [blame] | 804 | * have an undefined result. There may be an |
| 805 | * adjacent next vma that we'll walk |
| 806 | * next. userfaultfd_remove() will generate an |
| 807 | * UFFD_EVENT_REMOVE repetition on the |
| 808 | * end-vma->vm_end range, but the manager can |
| 809 | * handle a repetition fine. |
| 810 | */ |
| 811 | end = vma->vm_end; |
| 812 | } |
| 813 | VM_WARN_ON(start >= end); |
| 814 | } |
Mike Rapoport | 230ca98 | 2017-07-10 15:49:02 -0700 | [diff] [blame] | 815 | |
| 816 | if (behavior == MADV_DONTNEED) |
| 817 | return madvise_dontneed_single_vma(vma, start, end); |
| 818 | else if (behavior == MADV_FREE) |
| 819 | return madvise_free_single_vma(vma, start, end); |
| 820 | else |
| 821 | return -EINVAL; |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 822 | } |
| 823 | |
Badari Pulavarty | f6b3ec2 | 2006-01-06 00:10:38 -0800 | [diff] [blame] | 824 | /* |
| 825 | * Application wants to free up the pages and associated backing store. |
| 826 | * This is effectively punching a hole into the middle of a file. |
Badari Pulavarty | f6b3ec2 | 2006-01-06 00:10:38 -0800 | [diff] [blame] | 827 | */ |
| 828 | static long madvise_remove(struct vm_area_struct *vma, |
Nick Piggin | 00e9fa2 | 2007-03-16 13:38:10 -0800 | [diff] [blame] | 829 | struct vm_area_struct **prev, |
Badari Pulavarty | f6b3ec2 | 2006-01-06 00:10:38 -0800 | [diff] [blame] | 830 | unsigned long start, unsigned long end) |
| 831 | { |
Hugh Dickins | 3f31d07 | 2012-05-29 15:06:40 -0700 | [diff] [blame] | 832 | loff_t offset; |
Hugh Dickins | 90ed52e | 2007-03-29 01:20:38 -0700 | [diff] [blame] | 833 | int error; |
Andy Lutomirski | 9ab4233 | 2012-07-05 16:00:11 -0700 | [diff] [blame] | 834 | struct file *f; |
Minchan Kim | 0726b01 | 2020-10-17 16:14:50 -0700 | [diff] [blame] | 835 | struct mm_struct *mm = vma->vm_mm; |
Badari Pulavarty | f6b3ec2 | 2006-01-06 00:10:38 -0800 | [diff] [blame] | 836 | |
Michel Lespinasse | c1e8d7c | 2020-06-08 21:33:54 -0700 | [diff] [blame] | 837 | *prev = NULL; /* tell sys_madvise we drop mmap_lock */ |
Nick Piggin | 00e9fa2 | 2007-03-16 13:38:10 -0800 | [diff] [blame] | 838 | |
Mike Kravetz | 72079ba | 2015-09-08 15:01:57 -0700 | [diff] [blame] | 839 | if (vma->vm_flags & VM_LOCKED) |
Badari Pulavarty | f6b3ec2 | 2006-01-06 00:10:38 -0800 | [diff] [blame] | 840 | return -EINVAL; |
| 841 | |
Andy Lutomirski | 9ab4233 | 2012-07-05 16:00:11 -0700 | [diff] [blame] | 842 | f = vma->vm_file; |
| 843 | |
| 844 | if (!f || !f->f_mapping || !f->f_mapping->host) { |
Badari Pulavarty | f6b3ec2 | 2006-01-06 00:10:38 -0800 | [diff] [blame] | 845 | return -EINVAL; |
| 846 | } |
| 847 | |
Hugh Dickins | 69cf0fa | 2006-04-17 22:46:32 +0100 | [diff] [blame] | 848 | if ((vma->vm_flags & (VM_SHARED|VM_WRITE)) != (VM_SHARED|VM_WRITE)) |
| 849 | return -EACCES; |
| 850 | |
Badari Pulavarty | f6b3ec2 | 2006-01-06 00:10:38 -0800 | [diff] [blame] | 851 | offset = (loff_t)(start - vma->vm_start) |
| 852 | + ((loff_t)vma->vm_pgoff << PAGE_SHIFT); |
Hugh Dickins | 90ed52e | 2007-03-29 01:20:38 -0700 | [diff] [blame] | 853 | |
Andy Lutomirski | 9ab4233 | 2012-07-05 16:00:11 -0700 | [diff] [blame] | 854 | /* |
| 855 | * Filesystem's fallocate may need to take i_mutex. We need to |
| 856 | * explicitly grab a reference because the vma (and hence the |
| 857 | * vma's reference to the file) can go away as soon as we drop |
Michel Lespinasse | c1e8d7c | 2020-06-08 21:33:54 -0700 | [diff] [blame] | 858 | * mmap_lock. |
Andy Lutomirski | 9ab4233 | 2012-07-05 16:00:11 -0700 | [diff] [blame] | 859 | */ |
| 860 | get_file(f); |
Andrea Arcangeli | 70ccb92 | 2017-03-09 16:17:11 -0800 | [diff] [blame] | 861 | if (userfaultfd_remove(vma, start, end)) { |
Michel Lespinasse | c1e8d7c | 2020-06-08 21:33:54 -0700 | [diff] [blame] | 862 | /* mmap_lock was not released by userfaultfd_remove() */ |
Minchan Kim | 0726b01 | 2020-10-17 16:14:50 -0700 | [diff] [blame] | 863 | mmap_read_unlock(mm); |
Andrea Arcangeli | 70ccb92 | 2017-03-09 16:17:11 -0800 | [diff] [blame] | 864 | } |
Anna Schumaker | 72c72bd | 2014-11-07 14:44:25 -0500 | [diff] [blame] | 865 | error = vfs_fallocate(f, |
Hugh Dickins | 3f31d07 | 2012-05-29 15:06:40 -0700 | [diff] [blame] | 866 | FALLOC_FL_PUNCH_HOLE | FALLOC_FL_KEEP_SIZE, |
| 867 | offset, end - start); |
Andy Lutomirski | 9ab4233 | 2012-07-05 16:00:11 -0700 | [diff] [blame] | 868 | fput(f); |
Minchan Kim | 0726b01 | 2020-10-17 16:14:50 -0700 | [diff] [blame] | 869 | mmap_read_lock(mm); |
Hugh Dickins | 90ed52e | 2007-03-29 01:20:38 -0700 | [diff] [blame] | 870 | return error; |
Badari Pulavarty | f6b3ec2 | 2006-01-06 00:10:38 -0800 | [diff] [blame] | 871 | } |
| 872 | |
Andi Kleen | 9893e49 | 2009-09-16 11:50:17 +0200 | [diff] [blame] | 873 | #ifdef CONFIG_MEMORY_FAILURE |
| 874 | /* |
| 875 | * Error injection support for memory error handling. |
| 876 | */ |
Anshuman Khandual | 97167a7 | 2017-05-03 14:55:25 -0700 | [diff] [blame] | 877 | static int madvise_inject_error(int behavior, |
| 878 | unsigned long start, unsigned long end) |
Andi Kleen | 9893e49 | 2009-09-16 11:50:17 +0200 | [diff] [blame] | 879 | { |
Mel Gorman | c461ad6 | 2017-08-31 16:15:30 -0700 | [diff] [blame] | 880 | struct zone *zone; |
Yunfeng Ye | d3cd257 | 2019-11-30 17:57:42 -0800 | [diff] [blame] | 881 | unsigned long size; |
Anshuman Khandual | 97167a7 | 2017-05-03 14:55:25 -0700 | [diff] [blame] | 882 | |
Andi Kleen | 9893e49 | 2009-09-16 11:50:17 +0200 | [diff] [blame] | 883 | if (!capable(CAP_SYS_ADMIN)) |
| 884 | return -EPERM; |
Anshuman Khandual | 97167a7 | 2017-05-03 14:55:25 -0700 | [diff] [blame] | 885 | |
Alexandru Moise | 19bfbe2 | 2017-10-03 16:14:31 -0700 | [diff] [blame] | 886 | |
Yunfeng Ye | d3cd257 | 2019-11-30 17:57:42 -0800 | [diff] [blame] | 887 | for (; start < end; start += size) { |
Dan Williams | 23e7b5c | 2018-07-13 21:50:06 -0700 | [diff] [blame] | 888 | unsigned long pfn; |
Oscar Salvador | dc7560b | 2020-10-15 20:06:53 -0700 | [diff] [blame] | 889 | struct page *page; |
Andrew Morton | 325c4ef | 2013-09-11 14:23:03 -0700 | [diff] [blame] | 890 | int ret; |
| 891 | |
Anshuman Khandual | 97167a7 | 2017-05-03 14:55:25 -0700 | [diff] [blame] | 892 | ret = get_user_pages_fast(start, 1, 0, &page); |
Andi Kleen | 9893e49 | 2009-09-16 11:50:17 +0200 | [diff] [blame] | 893 | if (ret != 1) |
| 894 | return ret; |
Dan Williams | 23e7b5c | 2018-07-13 21:50:06 -0700 | [diff] [blame] | 895 | pfn = page_to_pfn(page); |
Andrew Morton | 325c4ef | 2013-09-11 14:23:03 -0700 | [diff] [blame] | 896 | |
Alexandru Moise | 19bfbe2 | 2017-10-03 16:14:31 -0700 | [diff] [blame] | 897 | /* |
| 898 | * When soft offlining hugepages, after migrating the page |
| 899 | * we dissolve it, therefore in the second loop "page" will |
Yunfeng Ye | d3cd257 | 2019-11-30 17:57:42 -0800 | [diff] [blame] | 900 | * no longer be a compound page. |
Alexandru Moise | 19bfbe2 | 2017-10-03 16:14:31 -0700 | [diff] [blame] | 901 | */ |
Yunfeng Ye | d3cd257 | 2019-11-30 17:57:42 -0800 | [diff] [blame] | 902 | size = page_size(compound_head(page)); |
Alexandru Moise | 19bfbe2 | 2017-10-03 16:14:31 -0700 | [diff] [blame] | 903 | |
Anshuman Khandual | 97167a7 | 2017-05-03 14:55:25 -0700 | [diff] [blame] | 904 | if (behavior == MADV_SOFT_OFFLINE) { |
| 905 | pr_info("Soft offlining pfn %#lx at process virtual address %#lx\n", |
Oscar Salvador | dc7560b | 2020-10-15 20:06:53 -0700 | [diff] [blame] | 906 | pfn, start); |
Naoya Horiguchi | feec24a | 2019-11-30 17:53:38 -0800 | [diff] [blame] | 907 | ret = soft_offline_page(pfn, MF_COUNT_INCREASED); |
Oscar Salvador | dc7560b | 2020-10-15 20:06:53 -0700 | [diff] [blame] | 908 | } else { |
| 909 | pr_info("Injecting memory failure for pfn %#lx at process virtual address %#lx\n", |
| 910 | pfn, start); |
| 911 | /* |
| 912 | * Drop the page reference taken by get_user_pages_fast(). In |
| 913 | * the absence of MF_COUNT_INCREASED the memory_failure() |
| 914 | * routine is responsible for pinning the page to prevent it |
| 915 | * from being released back to the page allocator. |
| 916 | */ |
| 917 | put_page(page); |
| 918 | ret = memory_failure(pfn, 0); |
Andi Kleen | afcf938 | 2009-12-16 12:20:00 +0100 | [diff] [blame] | 919 | } |
Anshuman Khandual | 97167a7 | 2017-05-03 14:55:25 -0700 | [diff] [blame] | 920 | |
Naoya Horiguchi | 23a003b | 2016-03-15 14:56:36 -0700 | [diff] [blame] | 921 | if (ret) |
| 922 | return ret; |
Andi Kleen | 9893e49 | 2009-09-16 11:50:17 +0200 | [diff] [blame] | 923 | } |
Mel Gorman | c461ad6 | 2017-08-31 16:15:30 -0700 | [diff] [blame] | 924 | |
| 925 | /* Ensure that all poisoned pages are removed from per-cpu lists */ |
| 926 | for_each_populated_zone(zone) |
| 927 | drain_all_pages(zone); |
| 928 | |
Andrew Morton | 325c4ef | 2013-09-11 14:23:03 -0700 | [diff] [blame] | 929 | return 0; |
Andi Kleen | 9893e49 | 2009-09-16 11:50:17 +0200 | [diff] [blame] | 930 | } |
| 931 | #endif |
| 932 | |
suzuki | 165cd40 | 2005-07-27 11:43:59 -0700 | [diff] [blame] | 933 | static long |
| 934 | madvise_vma(struct vm_area_struct *vma, struct vm_area_struct **prev, |
| 935 | unsigned long start, unsigned long end, int behavior) |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 936 | { |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 937 | switch (behavior) { |
Badari Pulavarty | f6b3ec2 | 2006-01-06 00:10:38 -0800 | [diff] [blame] | 938 | case MADV_REMOVE: |
Hugh Dickins | 3866ea9 | 2009-09-21 17:01:52 -0700 | [diff] [blame] | 939 | return madvise_remove(vma, prev, start, end); |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 940 | case MADV_WILLNEED: |
Hugh Dickins | 3866ea9 | 2009-09-21 17:01:52 -0700 | [diff] [blame] | 941 | return madvise_willneed(vma, prev, start, end); |
Minchan Kim | 9c276cc | 2019-09-25 16:49:08 -0700 | [diff] [blame] | 942 | case MADV_COLD: |
| 943 | return madvise_cold(vma, prev, start, end); |
Minchan Kim | 1a4e58c | 2019-09-25 16:49:15 -0700 | [diff] [blame] | 944 | case MADV_PAGEOUT: |
| 945 | return madvise_pageout(vma, prev, start, end); |
Minchan Kim | 854e9ed | 2016-01-15 16:54:53 -0800 | [diff] [blame] | 946 | case MADV_FREE: |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 947 | case MADV_DONTNEED: |
Mike Rapoport | 230ca98 | 2017-07-10 15:49:02 -0700 | [diff] [blame] | 948 | return madvise_dontneed_free(vma, prev, start, end, behavior); |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 949 | default: |
Hugh Dickins | 3866ea9 | 2009-09-21 17:01:52 -0700 | [diff] [blame] | 950 | return madvise_behavior(vma, prev, start, end, behavior); |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 951 | } |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 952 | } |
| 953 | |
Nicholas Krause | 1ecef9e | 2015-09-04 15:48:24 -0700 | [diff] [blame] | 954 | static bool |
Nick Piggin | 75927af | 2009-06-16 15:32:38 -0700 | [diff] [blame] | 955 | madvise_behavior_valid(int behavior) |
| 956 | { |
| 957 | switch (behavior) { |
| 958 | case MADV_DOFORK: |
| 959 | case MADV_DONTFORK: |
| 960 | case MADV_NORMAL: |
| 961 | case MADV_SEQUENTIAL: |
| 962 | case MADV_RANDOM: |
| 963 | case MADV_REMOVE: |
| 964 | case MADV_WILLNEED: |
| 965 | case MADV_DONTNEED: |
Minchan Kim | 854e9ed | 2016-01-15 16:54:53 -0800 | [diff] [blame] | 966 | case MADV_FREE: |
Minchan Kim | 9c276cc | 2019-09-25 16:49:08 -0700 | [diff] [blame] | 967 | case MADV_COLD: |
Minchan Kim | 1a4e58c | 2019-09-25 16:49:15 -0700 | [diff] [blame] | 968 | case MADV_PAGEOUT: |
Hugh Dickins | f8af4da | 2009-09-21 17:01:57 -0700 | [diff] [blame] | 969 | #ifdef CONFIG_KSM |
| 970 | case MADV_MERGEABLE: |
| 971 | case MADV_UNMERGEABLE: |
| 972 | #endif |
Andrea Arcangeli | 0af4e98 | 2011-01-13 15:46:55 -0800 | [diff] [blame] | 973 | #ifdef CONFIG_TRANSPARENT_HUGEPAGE |
| 974 | case MADV_HUGEPAGE: |
Andrea Arcangeli | a664b2d | 2011-01-13 15:47:17 -0800 | [diff] [blame] | 975 | case MADV_NOHUGEPAGE: |
Andrea Arcangeli | 0af4e98 | 2011-01-13 15:46:55 -0800 | [diff] [blame] | 976 | #endif |
Jason Baron | accb61f | 2012-03-23 15:02:51 -0700 | [diff] [blame] | 977 | case MADV_DONTDUMP: |
| 978 | case MADV_DODUMP: |
Rik van Riel | d2cd9ed | 2017-09-06 16:25:15 -0700 | [diff] [blame] | 979 | case MADV_WIPEONFORK: |
| 980 | case MADV_KEEPONFORK: |
Anshuman Khandual | 5e451be | 2017-05-03 14:55:28 -0700 | [diff] [blame] | 981 | #ifdef CONFIG_MEMORY_FAILURE |
| 982 | case MADV_SOFT_OFFLINE: |
| 983 | case MADV_HWPOISON: |
| 984 | #endif |
Nicholas Krause | 1ecef9e | 2015-09-04 15:48:24 -0700 | [diff] [blame] | 985 | return true; |
Nick Piggin | 75927af | 2009-06-16 15:32:38 -0700 | [diff] [blame] | 986 | |
| 987 | default: |
Nicholas Krause | 1ecef9e | 2015-09-04 15:48:24 -0700 | [diff] [blame] | 988 | return false; |
Nick Piggin | 75927af | 2009-06-16 15:32:38 -0700 | [diff] [blame] | 989 | } |
| 990 | } |
Hugh Dickins | 3866ea9 | 2009-09-21 17:01:52 -0700 | [diff] [blame] | 991 | |
Minchan Kim | ecb8ac8 | 2020-10-17 16:14:59 -0700 | [diff] [blame] | 992 | static bool |
| 993 | process_madvise_behavior_valid(int behavior) |
| 994 | { |
| 995 | switch (behavior) { |
| 996 | case MADV_COLD: |
| 997 | case MADV_PAGEOUT: |
| 998 | return true; |
| 999 | default: |
| 1000 | return false; |
| 1001 | } |
| 1002 | } |
| 1003 | |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 1004 | /* |
| 1005 | * The madvise(2) system call. |
| 1006 | * |
| 1007 | * Applications can use madvise() to advise the kernel how it should |
| 1008 | * handle paging I/O in this VM area. The idea is to help the kernel |
| 1009 | * use appropriate read-ahead and caching techniques. The information |
| 1010 | * provided is advisory only, and can be safely disregarded by the |
| 1011 | * kernel without affecting the correct operation of the application. |
| 1012 | * |
| 1013 | * behavior values: |
| 1014 | * MADV_NORMAL - the default behavior is to read clusters. This |
| 1015 | * results in some read-ahead and read-behind. |
| 1016 | * MADV_RANDOM - the system should read the minimum amount of data |
| 1017 | * on any access, since it is unlikely that the appli- |
| 1018 | * cation will need more than what it asks for. |
| 1019 | * MADV_SEQUENTIAL - pages in the given range will probably be accessed |
| 1020 | * once, so they can be aggressively read ahead, and |
| 1021 | * can be freed soon after they are accessed. |
| 1022 | * MADV_WILLNEED - the application is notifying the system to read |
| 1023 | * some pages ahead. |
| 1024 | * MADV_DONTNEED - the application is finished with the given range, |
| 1025 | * so the kernel can free resources associated with it. |
Naoya Horiguchi | d7206a7 | 2016-03-15 14:56:58 -0700 | [diff] [blame] | 1026 | * MADV_FREE - the application marks pages in the given range as lazy free, |
| 1027 | * where actual purges are postponed until memory pressure happens. |
Badari Pulavarty | f6b3ec2 | 2006-01-06 00:10:38 -0800 | [diff] [blame] | 1028 | * MADV_REMOVE - the application wants to free up the given range of |
| 1029 | * pages and associated backing store. |
Hugh Dickins | 3866ea9 | 2009-09-21 17:01:52 -0700 | [diff] [blame] | 1030 | * MADV_DONTFORK - omit this area from child's address space when forking: |
| 1031 | * typically, to avoid COWing pages pinned by get_user_pages(). |
| 1032 | * MADV_DOFORK - cancel MADV_DONTFORK: no longer omit this area when forking. |
Yang Shi | c02c300 | 2017-10-13 15:57:37 -0700 | [diff] [blame] | 1033 | * MADV_WIPEONFORK - present the child process with zero-filled memory in this |
| 1034 | * range after a fork. |
| 1035 | * MADV_KEEPONFORK - undo the effect of MADV_WIPEONFORK |
Naoya Horiguchi | d7206a7 | 2016-03-15 14:56:58 -0700 | [diff] [blame] | 1036 | * MADV_HWPOISON - trigger memory error handler as if the given memory range |
| 1037 | * were corrupted by unrecoverable hardware memory failure. |
| 1038 | * MADV_SOFT_OFFLINE - try to soft-offline the given range of memory. |
Hugh Dickins | f8af4da | 2009-09-21 17:01:57 -0700 | [diff] [blame] | 1039 | * MADV_MERGEABLE - the application recommends that KSM try to merge pages in |
| 1040 | * this area with pages of identical content from other such areas. |
| 1041 | * MADV_UNMERGEABLE- cancel MADV_MERGEABLE: no longer merge pages with others. |
Naoya Horiguchi | d7206a7 | 2016-03-15 14:56:58 -0700 | [diff] [blame] | 1042 | * MADV_HUGEPAGE - the application wants to back the given range by transparent |
| 1043 | * huge pages in the future. Existing pages might be coalesced and |
| 1044 | * new pages might be allocated as THP. |
| 1045 | * MADV_NOHUGEPAGE - mark the given range as not worth being backed by |
| 1046 | * transparent huge pages so the existing pages will not be |
| 1047 | * coalesced into THP and new pages will not be allocated as THP. |
| 1048 | * MADV_DONTDUMP - the application wants to prevent pages in the given range |
| 1049 | * from being included in its core dump. |
| 1050 | * MADV_DODUMP - cancel MADV_DONTDUMP: no longer exclude from core dump. |
Minchan Kim | ecb8ac8 | 2020-10-17 16:14:59 -0700 | [diff] [blame] | 1051 | * MADV_COLD - the application is not expected to use this memory soon, |
| 1052 | * deactivate pages in this range so that they can be reclaimed |
| 1053 | * easily if memory pressure hanppens. |
| 1054 | * MADV_PAGEOUT - the application is not expected to use this memory soon, |
| 1055 | * page out the pages in this range immediately. |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 1056 | * |
| 1057 | * return values: |
| 1058 | * zero - success |
| 1059 | * -EINVAL - start + len < 0, start is not page-aligned, |
| 1060 | * "behavior" is not a valid value, or application |
Yang Shi | c02c300 | 2017-10-13 15:57:37 -0700 | [diff] [blame] | 1061 | * is attempting to release locked or shared pages, |
| 1062 | * or the specified address range includes file, Huge TLB, |
| 1063 | * MAP_SHARED or VMPFNMAP range. |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 1064 | * -ENOMEM - addresses in the specified range are not currently |
| 1065 | * mapped, or are outside the AS of the process. |
| 1066 | * -EIO - an I/O error occurred while paging in data. |
| 1067 | * -EBADF - map exists, but area maps something that isn't a file. |
| 1068 | * -EAGAIN - a kernel resource was temporarily unavailable. |
| 1069 | */ |
Minchan Kim | 0726b01 | 2020-10-17 16:14:50 -0700 | [diff] [blame] | 1070 | int do_madvise(struct mm_struct *mm, unsigned long start, size_t len_in, int behavior) |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 1071 | { |
Prasanna Meda | 05b7438 | 2005-06-21 17:14:37 -0700 | [diff] [blame] | 1072 | unsigned long end, tmp; |
Vladimir Cernov | ec9bed9 | 2013-09-11 14:20:15 -0700 | [diff] [blame] | 1073 | struct vm_area_struct *vma, *prev; |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 1074 | int unmapped_error = 0; |
| 1075 | int error = -EINVAL; |
Jason Baron | f797779 | 2007-07-15 23:38:21 -0700 | [diff] [blame] | 1076 | int write; |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 1077 | size_t len; |
Shaohua Li | 1998cc0 | 2013-02-22 16:32:31 -0800 | [diff] [blame] | 1078 | struct blk_plug plug; |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 1079 | |
Andrey Konovalov | 057d3389 | 2019-09-25 16:48:30 -0700 | [diff] [blame] | 1080 | start = untagged_addr(start); |
| 1081 | |
Nick Piggin | 75927af | 2009-06-16 15:32:38 -0700 | [diff] [blame] | 1082 | if (!madvise_behavior_valid(behavior)) |
| 1083 | return error; |
| 1084 | |
Wei Yang | df6c650 | 2019-11-30 17:57:46 -0800 | [diff] [blame] | 1085 | if (!PAGE_ALIGNED(start)) |
Rasmus Villemoes | 84d96d8 | 2013-04-29 15:08:23 -0700 | [diff] [blame] | 1086 | return error; |
Wei Yang | df6c650 | 2019-11-30 17:57:46 -0800 | [diff] [blame] | 1087 | len = PAGE_ALIGN(len_in); |
Rasmus Villemoes | 84d96d8 | 2013-04-29 15:08:23 -0700 | [diff] [blame] | 1088 | |
| 1089 | /* Check to see whether len was rounded up from small -ve to zero */ |
| 1090 | if (len_in && !len) |
| 1091 | return error; |
| 1092 | |
| 1093 | end = start + len; |
| 1094 | if (end < start) |
| 1095 | return error; |
| 1096 | |
| 1097 | error = 0; |
| 1098 | if (end == start) |
| 1099 | return error; |
| 1100 | |
Anshuman Khandual | 5e451be | 2017-05-03 14:55:28 -0700 | [diff] [blame] | 1101 | #ifdef CONFIG_MEMORY_FAILURE |
| 1102 | if (behavior == MADV_HWPOISON || behavior == MADV_SOFT_OFFLINE) |
| 1103 | return madvise_inject_error(behavior, start, start + len_in); |
| 1104 | #endif |
| 1105 | |
Jason Baron | f797779 | 2007-07-15 23:38:21 -0700 | [diff] [blame] | 1106 | write = madvise_need_mmap_write(behavior); |
Michal Hocko | dc0ef0d | 2016-05-23 16:25:27 -0700 | [diff] [blame] | 1107 | if (write) { |
Minchan Kim | 0726b01 | 2020-10-17 16:14:50 -0700 | [diff] [blame] | 1108 | if (mmap_write_lock_killable(mm)) |
Michal Hocko | dc0ef0d | 2016-05-23 16:25:27 -0700 | [diff] [blame] | 1109 | return -EINTR; |
| 1110 | } else { |
Minchan Kim | 0726b01 | 2020-10-17 16:14:50 -0700 | [diff] [blame] | 1111 | mmap_read_lock(mm); |
Michal Hocko | dc0ef0d | 2016-05-23 16:25:27 -0700 | [diff] [blame] | 1112 | } |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 1113 | |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 1114 | /* |
| 1115 | * If the interval [start,end) covers some unmapped address |
| 1116 | * ranges, just ignore them, but return -ENOMEM at the end. |
Prasanna Meda | 05b7438 | 2005-06-21 17:14:37 -0700 | [diff] [blame] | 1117 | * - different from the way of handling in mlock etc. |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 1118 | */ |
Minchan Kim | 0726b01 | 2020-10-17 16:14:50 -0700 | [diff] [blame] | 1119 | vma = find_vma_prev(mm, start, &prev); |
Hugh Dickins | 836d5ff | 2005-09-03 15:54:53 -0700 | [diff] [blame] | 1120 | if (vma && start > vma->vm_start) |
| 1121 | prev = vma; |
| 1122 | |
Shaohua Li | 1998cc0 | 2013-02-22 16:32:31 -0800 | [diff] [blame] | 1123 | blk_start_plug(&plug); |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 1124 | for (;;) { |
| 1125 | /* Still start < end. */ |
| 1126 | error = -ENOMEM; |
| 1127 | if (!vma) |
Rasmus Villemoes | 84d96d8 | 2013-04-29 15:08:23 -0700 | [diff] [blame] | 1128 | goto out; |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 1129 | |
Prasanna Meda | 05b7438 | 2005-06-21 17:14:37 -0700 | [diff] [blame] | 1130 | /* Here start < (end|vma->vm_end). */ |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 1131 | if (start < vma->vm_start) { |
| 1132 | unmapped_error = -ENOMEM; |
| 1133 | start = vma->vm_start; |
Prasanna Meda | 05b7438 | 2005-06-21 17:14:37 -0700 | [diff] [blame] | 1134 | if (start >= end) |
Rasmus Villemoes | 84d96d8 | 2013-04-29 15:08:23 -0700 | [diff] [blame] | 1135 | goto out; |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 1136 | } |
| 1137 | |
Prasanna Meda | 05b7438 | 2005-06-21 17:14:37 -0700 | [diff] [blame] | 1138 | /* Here vma->vm_start <= start < (end|vma->vm_end) */ |
| 1139 | tmp = vma->vm_end; |
| 1140 | if (end < tmp) |
| 1141 | tmp = end; |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 1142 | |
Prasanna Meda | 05b7438 | 2005-06-21 17:14:37 -0700 | [diff] [blame] | 1143 | /* Here vma->vm_start <= start < tmp <= (end|vma->vm_end). */ |
| 1144 | error = madvise_vma(vma, &prev, start, tmp, behavior); |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 1145 | if (error) |
Rasmus Villemoes | 84d96d8 | 2013-04-29 15:08:23 -0700 | [diff] [blame] | 1146 | goto out; |
Prasanna Meda | 05b7438 | 2005-06-21 17:14:37 -0700 | [diff] [blame] | 1147 | start = tmp; |
Hugh Dickins | 90ed52e | 2007-03-29 01:20:38 -0700 | [diff] [blame] | 1148 | if (prev && start < prev->vm_end) |
Prasanna Meda | 05b7438 | 2005-06-21 17:14:37 -0700 | [diff] [blame] | 1149 | start = prev->vm_end; |
| 1150 | error = unmapped_error; |
| 1151 | if (start >= end) |
Rasmus Villemoes | 84d96d8 | 2013-04-29 15:08:23 -0700 | [diff] [blame] | 1152 | goto out; |
Hugh Dickins | 90ed52e | 2007-03-29 01:20:38 -0700 | [diff] [blame] | 1153 | if (prev) |
| 1154 | vma = prev->vm_next; |
Michel Lespinasse | c1e8d7c | 2020-06-08 21:33:54 -0700 | [diff] [blame] | 1155 | else /* madvise_remove dropped mmap_lock */ |
Minchan Kim | 0726b01 | 2020-10-17 16:14:50 -0700 | [diff] [blame] | 1156 | vma = find_vma(mm, start); |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 1157 | } |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 1158 | out: |
Rasmus Villemoes | 84d96d8 | 2013-04-29 15:08:23 -0700 | [diff] [blame] | 1159 | blk_finish_plug(&plug); |
Jason Baron | f797779 | 2007-07-15 23:38:21 -0700 | [diff] [blame] | 1160 | if (write) |
Minchan Kim | 0726b01 | 2020-10-17 16:14:50 -0700 | [diff] [blame] | 1161 | mmap_write_unlock(mm); |
Nick Piggin | 0a27a14 | 2007-05-06 14:49:53 -0700 | [diff] [blame] | 1162 | else |
Minchan Kim | 0726b01 | 2020-10-17 16:14:50 -0700 | [diff] [blame] | 1163 | mmap_read_unlock(mm); |
Nick Piggin | 0a27a14 | 2007-05-06 14:49:53 -0700 | [diff] [blame] | 1164 | |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 1165 | return error; |
| 1166 | } |
Jens Axboe | db08ca2 | 2019-12-25 22:14:54 -0700 | [diff] [blame] | 1167 | |
| 1168 | SYSCALL_DEFINE3(madvise, unsigned long, start, size_t, len_in, int, behavior) |
| 1169 | { |
Minchan Kim | 0726b01 | 2020-10-17 16:14:50 -0700 | [diff] [blame] | 1170 | return do_madvise(current->mm, start, len_in, behavior); |
Jens Axboe | db08ca2 | 2019-12-25 22:14:54 -0700 | [diff] [blame] | 1171 | } |
Minchan Kim | ecb8ac8 | 2020-10-17 16:14:59 -0700 | [diff] [blame] | 1172 | |
| 1173 | SYSCALL_DEFINE5(process_madvise, int, pidfd, const struct iovec __user *, vec, |
| 1174 | size_t, vlen, int, behavior, unsigned int, flags) |
| 1175 | { |
| 1176 | ssize_t ret; |
| 1177 | struct iovec iovstack[UIO_FASTIOV], iovec; |
| 1178 | struct iovec *iov = iovstack; |
| 1179 | struct iov_iter iter; |
| 1180 | struct pid *pid; |
| 1181 | struct task_struct *task; |
| 1182 | struct mm_struct *mm; |
| 1183 | size_t total_len; |
| 1184 | unsigned int f_flags; |
| 1185 | |
| 1186 | if (flags != 0) { |
| 1187 | ret = -EINVAL; |
| 1188 | goto out; |
| 1189 | } |
| 1190 | |
| 1191 | ret = import_iovec(READ, vec, vlen, ARRAY_SIZE(iovstack), &iov, &iter); |
| 1192 | if (ret < 0) |
| 1193 | goto out; |
| 1194 | |
| 1195 | pid = pidfd_get_pid(pidfd, &f_flags); |
| 1196 | if (IS_ERR(pid)) { |
| 1197 | ret = PTR_ERR(pid); |
| 1198 | goto free_iov; |
| 1199 | } |
| 1200 | |
| 1201 | task = get_pid_task(pid, PIDTYPE_PID); |
| 1202 | if (!task) { |
| 1203 | ret = -ESRCH; |
| 1204 | goto put_pid; |
| 1205 | } |
| 1206 | |
| 1207 | if (task->mm != current->mm && |
| 1208 | !process_madvise_behavior_valid(behavior)) { |
| 1209 | ret = -EINVAL; |
| 1210 | goto release_task; |
| 1211 | } |
| 1212 | |
| 1213 | mm = mm_access(task, PTRACE_MODE_ATTACH_FSCREDS); |
| 1214 | if (IS_ERR_OR_NULL(mm)) { |
| 1215 | ret = IS_ERR(mm) ? PTR_ERR(mm) : -ESRCH; |
| 1216 | goto release_task; |
| 1217 | } |
| 1218 | |
| 1219 | total_len = iov_iter_count(&iter); |
| 1220 | |
| 1221 | while (iov_iter_count(&iter)) { |
| 1222 | iovec = iov_iter_iovec(&iter); |
| 1223 | ret = do_madvise(mm, (unsigned long)iovec.iov_base, |
| 1224 | iovec.iov_len, behavior); |
| 1225 | if (ret < 0) |
| 1226 | break; |
| 1227 | iov_iter_advance(&iter, iovec.iov_len); |
| 1228 | } |
| 1229 | |
| 1230 | if (ret == 0) |
| 1231 | ret = total_len - iov_iter_count(&iter); |
| 1232 | |
| 1233 | mmput(mm); |
Minchan Kim | ecb8ac8 | 2020-10-17 16:14:59 -0700 | [diff] [blame] | 1234 | release_task: |
| 1235 | put_task_struct(task); |
| 1236 | put_pid: |
| 1237 | put_pid(pid); |
| 1238 | free_iov: |
| 1239 | kfree(iov); |
| 1240 | out: |
| 1241 | return ret; |
| 1242 | } |