| From: Baolin Wang <baolin.wang@linux.alibaba.com> |
| Subject: docs: hugetlbpage.rst: add hugetlb migration description |
| Date: Wed, 6 Mar 2024 18:13:28 +0800 |
| |
| Add some description of the hugetlb migration strategy. |
| |
| Link: https://lkml.kernel.org/r/63fb16e7a4ebc5cb69ce655af86e29b2d8e9ba34.1709719720.git.baolin.wang@linux.alibaba.com |
| Signed-off-by: Baolin Wang <baolin.wang@linux.alibaba.com> |
| Reviewed-by: Oscar Salvador <osalvador@suse.de> |
| Cc: David Hildenbrand <david@redhat.com> |
| Cc: Miaohe Lin <linmiaohe@huawei.com> |
| Cc: Michal Hocko <mhocko@kernel.org> |
| Cc: Muchun Song <muchun.song@linux.dev> |
| Cc: Naoya Horiguchi <nao.horiguchi@gmail.com> |
| Signed-off-by: Andrew Morton <akpm@linux-foundation.org> |
| --- |
| |
| Documentation/admin-guide/mm/hugetlbpage.rst | 7 +++++++ |
| 1 file changed, 7 insertions(+) |
| |
| --- a/Documentation/admin-guide/mm/hugetlbpage.rst~docs-hugetlbpagerst-add-hugetlb-migration-description |
| +++ a/Documentation/admin-guide/mm/hugetlbpage.rst |
| @@ -376,6 +376,13 @@ Note that the number of overcommit and r |
| as we don't know until fault time, when the faulting task's mempolicy is |
| applied, from which node the huge page allocation will be attempted. |
| |
| +The hugetlb may be migrated between the per-node hugepages pool in the following |
| +scenarios: memory offline, memory failure, longterm pinning, syscalls(mbind, |
| +migrate_pages and move_pages), alloc_contig_range() and alloc_contig_pages(). |
| +Now only memory offline, memory failure and syscalls allow fallbacking to allocate |
| +a new hugetlb on a different node if the current node is unable to allocate during |
| +hugetlb migration, that means these 3 cases can break the per-node hugepages pool. |
| + |
| .. _using_huge_pages: |
| |
| Using Huge Pages |
| _ |
