2 * Copyright (c) 2017 Cisco and/or its affiliates.
3 * Licensed under the Apache License, Version 2.0 (the "License");
4 * you may not use this file except in compliance with the License.
5 * You may obtain a copy of the License at:
7 * http://www.apache.org/licenses/LICENSE-2.0
9 * Unless required by applicable law or agreed to in writing, software
10 * distributed under the License is distributed on an "AS IS" BASIS,
11 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
12 * See the License for the specific language governing permissions and
13 * limitations under the License.
18 #include <sys/types.h>
21 #include <sys/mount.h>
24 #include <linux/mempolicy.h>
25 #include <linux/memfd.h>
27 #include <vppinfra/clib.h>
28 #include <vppinfra/mem.h>
29 #include <vppinfra/time.h>
30 #include <vppinfra/format.h>
31 #include <vppinfra/clib_error.h>
32 #include <vppinfra/linux/syscall.h>
33 #include <vppinfra/linux/sysfs.h>
35 #ifndef F_LINUX_SPECIFIC_BASE
36 #define F_LINUX_SPECIFIC_BASE 1024
40 #define F_ADD_SEALS (F_LINUX_SPECIFIC_BASE + 9)
41 #define F_GET_SEALS (F_LINUX_SPECIFIC_BASE + 10)
43 #define F_SEAL_SEAL 0x0001 /* prevent further seals from being set */
44 #define F_SEAL_SHRINK 0x0002 /* prevent file from shrinking */
45 #define F_SEAL_GROW 0x0004 /* prevent file from growing */
46 #define F_SEAL_WRITE 0x0008 /* prevent writes */
50 #define MFD_HUGETLB 0x0004U
53 #ifndef MAP_HUGE_SHIFT
54 #define MAP_HUGE_SHIFT 26
57 #ifndef MFD_HUGE_SHIFT
58 #define MFD_HUGE_SHIFT 26
61 #ifndef MAP_FIXED_NOREPLACE
62 #define MAP_FIXED_NOREPLACE 0x100000
66 clib_mem_get_default_hugepage_size (void)
68 unformat_input_t input;
76 * If the kernel doesn't support hugepages, /proc/meminfo won't
77 * say anything about it. Use the regular page size as a default.
79 size = clib_mem_get_page_size () / 1024;
81 if ((fd = open ("/proc/meminfo", 0)) == -1)
84 unformat_init_clib_file (&input, fd);
86 while (unformat_check_input (&input) != UNFORMAT_END_OF_INPUT)
88 if (unformat (&input, "Hugepagesize:%_%u kB", &size))
91 unformat_skip_line (&input);
93 unformat_free (&input);
96 return 1024ULL * size;
99 static clib_mem_page_sz_t
100 legacy_get_log2_default_hugepage_size (void)
102 clib_mem_page_sz_t log2_page_size = CLIB_MEM_PAGE_SZ_UNKNOWN;
106 if ((fp = fopen ("/proc/meminfo", "r")) == NULL)
107 return CLIB_MEM_PAGE_SZ_UNKNOWN;
109 while (fscanf (fp, "%32s", tmp) > 0)
110 if (strncmp ("Hugepagesize:", tmp, 13) == 0)
113 if (fscanf (fp, "%u", &size) > 0)
114 log2_page_size = 10 + min_log2 (size);
119 return log2_page_size;
123 clib_mem_main_init ()
125 clib_mem_main_t *mm = &clib_mem_main;
130 if (mm->log2_page_sz != CLIB_MEM_PAGE_SZ_UNKNOWN)
133 /* system page size */
134 page_size = sysconf (_SC_PAGESIZE);
135 mm->log2_page_sz = min_log2 (page_size);
137 /* default system hugeppage size */
138 if ((fd = memfd_create ("test", MFD_HUGETLB)) != -1)
140 mm->log2_default_hugepage_sz = clib_mem_get_fd_log2_page_size (fd);
143 else /* likely kernel older than 4.14 */
144 mm->log2_default_hugepage_sz = legacy_get_log2_default_hugepage_size ();
147 va = mmap (0, page_size, PROT_READ | PROT_WRITE, MAP_PRIVATE |
148 MAP_ANONYMOUS, -1, 0);
149 if (va == MAP_FAILED)
152 if (mlock (va, page_size))
155 for (int i = 0; i < CLIB_MAX_NUMAS; i++)
158 if (move_pages (0, 1, &va, &i, &status, 0) == 0)
159 mm->numa_node_bitmap |= 1ULL << i;
163 munmap (va, page_size);
167 clib_mem_get_fd_page_size (int fd)
169 struct stat st = { 0 };
170 if (fstat (fd, &st) == -1)
172 return st.st_blksize;
176 clib_mem_get_fd_log2_page_size (int fd)
178 uword page_size = clib_mem_get_fd_page_size (fd);
179 return page_size ? min_log2 (page_size) : CLIB_MEM_PAGE_SZ_UNKNOWN;
183 clib_mem_vm_randomize_va (uword * requested_va,
184 clib_mem_page_sz_t log2_page_size)
188 if (log2_page_size <= 12)
190 else if (log2_page_size > 12 && log2_page_size <= 16)
196 (clib_cpu_time_now () & bit_mask) * (1ull << log2_page_size);
200 clib_mem_vm_ext_alloc (clib_mem_vm_alloc_t * a)
202 clib_mem_main_t *mm = &clib_mem_main;
204 clib_error_t *err = 0;
211 long unsigned int old_mask[16] = { 0 };
213 /* save old numa mem policy if needed */
214 if (a->flags & (CLIB_MEM_VM_F_NUMA_PREFER | CLIB_MEM_VM_F_NUMA_FORCE))
217 rv = get_mempolicy (&old_mpol, old_mask, sizeof (old_mask) * 8 + 1,
222 if (a->numa_node != 0 && (a->flags & CLIB_MEM_VM_F_NUMA_FORCE) != 0)
224 err = clib_error_return_unix (0, "get_mempolicy");
232 if (a->flags & CLIB_MEM_VM_F_LOCKED)
233 mmap_flags |= MAP_LOCKED;
235 /* if we are creating shared segment, we need file descriptor */
236 if (a->flags & CLIB_MEM_VM_F_SHARED)
238 mmap_flags |= MAP_SHARED;
239 /* if hugepages are needed we need to create mount point */
240 if (a->flags & CLIB_MEM_VM_F_HUGETLB)
242 log2_page_size = CLIB_MEM_PAGE_SZ_DEFAULT_HUGE;
243 mmap_flags |= MAP_LOCKED;
246 log2_page_size = CLIB_MEM_PAGE_SZ_DEFAULT;
248 if ((fd = clib_mem_vm_create_fd (log2_page_size, "%s", a->name)) == -1)
250 err = clib_error_return (0, "%U", format_clib_error, mm->error);
254 log2_page_size = clib_mem_get_fd_log2_page_size (fd);
255 if (log2_page_size == 0)
257 err = clib_error_return_unix (0, "cannot determine page size");
263 clib_mem_vm_randomize_va (&a->requested_va, log2_page_size);
264 mmap_flags |= MAP_FIXED;
267 else /* not CLIB_MEM_VM_F_SHARED */
269 mmap_flags |= MAP_PRIVATE | MAP_ANONYMOUS;
270 if (a->flags & CLIB_MEM_VM_F_HUGETLB)
272 mmap_flags |= MAP_HUGETLB;
277 log2_page_size = min_log2 (sysconf (_SC_PAGESIZE));
281 n_pages = ((a->size - 1) >> log2_page_size) + 1;
283 if (a->flags & CLIB_MEM_VM_F_HUGETLB_PREALLOC)
285 err = clib_sysfs_prealloc_hugepages (a->numa_node, log2_page_size,
293 if ((ftruncate (fd, (u64) n_pages * (1 << log2_page_size))) == -1)
295 err = clib_error_return_unix (0, "ftruncate");
302 long unsigned int mask[16] = { 0 };
303 mask[0] = 1 << a->numa_node;
304 rv = set_mempolicy (MPOL_BIND, mask, sizeof (mask) * 8 + 1);
305 if (rv == -1 && a->numa_node != 0 &&
306 (a->flags & CLIB_MEM_VM_F_NUMA_FORCE) != 0)
308 err = clib_error_return_unix (0, "set_mempolicy");
313 addr = mmap (uword_to_pointer (a->requested_va, void *), a->size,
314 (PROT_READ | PROT_WRITE), mmap_flags, fd, 0);
315 if (addr == MAP_FAILED)
317 err = clib_error_return_unix (0, "mmap");
321 /* re-apply old numa memory policy */
322 if (old_mpol != -1 &&
323 set_mempolicy (old_mpol, old_mask, sizeof (old_mask) * 8 + 1) == -1)
325 err = clib_error_return_unix (0, "set_mempolicy");
329 a->log2_page_size = log2_page_size;
330 a->n_pages = n_pages;
333 CLIB_MEM_UNPOISON (addr, a->size);
346 clib_mem_vm_ext_free (clib_mem_vm_alloc_t * a)
350 clib_mem_vm_free (a->addr, 1ull << a->log2_page_size);
357 legacy_memfd_create (u8 * name)
359 clib_mem_main_t *mm = &clib_mem_main;
364 /* create mount directory */
365 if ((mount_dir = mkdtemp ("/tmp/hugepage_mount.XXXXXX")) == 0)
367 vec_reset_length (mm->error);
368 mm->error = clib_error_return_unix (mm->error, "mkdtemp");
369 return CLIB_MEM_ERROR;
372 if (mount ("none", mount_dir, "hugetlbfs", 0, NULL))
374 rmdir ((char *) mount_dir);
375 vec_reset_length (mm->error);
376 mm->error = clib_error_return_unix (mm->error, "mount");
377 return CLIB_MEM_ERROR;
380 filename = format (0, "%s/%s%c", mount_dir, name, 0);
382 if ((fd = open ((char *) filename, O_CREAT | O_RDWR, 0755)) == -1)
384 vec_reset_length (mm->error);
385 mm->error = clib_error_return_unix (mm->error, "mkdtemp");
388 umount2 ((char *) mount_dir, MNT_DETACH);
389 rmdir ((char *) mount_dir);
396 clib_mem_vm_create_fd (clib_mem_page_sz_t log2_page_size, char *fmt, ...)
398 clib_mem_main_t *mm = &clib_mem_main;
400 unsigned int memfd_flags;
404 if (log2_page_size == mm->log2_page_sz)
405 log2_page_size = CLIB_MEM_PAGE_SZ_DEFAULT;
407 switch (log2_page_size)
409 case CLIB_MEM_PAGE_SZ_UNKNOWN:
410 return CLIB_MEM_ERROR;
411 case CLIB_MEM_PAGE_SZ_DEFAULT:
412 memfd_flags = MFD_ALLOW_SEALING;
414 case CLIB_MEM_PAGE_SZ_DEFAULT_HUGE:
415 memfd_flags = MFD_HUGETLB;
418 memfd_flags = MFD_HUGETLB | log2_page_size << MFD_HUGE_SHIFT;
422 s = va_format (0, fmt, &va);
425 /* memfd_create maximum string size is 249 chars without trailing zero */
426 if (vec_len (s) > 249)
430 /* memfd_create introduced in kernel 3.17, we don't support older kernels */
431 fd = memfd_create ((char *) s, memfd_flags);
433 /* kernel versions < 4.14 does not support memfd_create for huge pages */
434 if (fd == -1 && errno == EINVAL &&
435 log2_page_size == CLIB_MEM_PAGE_SZ_DEFAULT_HUGE)
437 fd = legacy_memfd_create (s);
441 vec_reset_length (mm->error);
442 mm->error = clib_error_return_unix (mm->error, "memfd_create");
444 return CLIB_MEM_ERROR;
449 if ((memfd_flags & MFD_ALLOW_SEALING) &&
450 ((fcntl (fd, F_ADD_SEALS, F_SEAL_SHRINK)) == -1))
452 vec_reset_length (mm->error);
453 mm->error = clib_error_return_unix (mm->error, "fcntl (F_ADD_SEALS)");
455 return CLIB_MEM_ERROR;
462 clib_mem_vm_reserve (uword start, uword size, clib_mem_page_sz_t log2_page_sz)
464 clib_mem_main_t *mm = &clib_mem_main;
465 uword pagesize = 1ULL << log2_page_sz;
466 uword sys_page_sz = 1ULL << mm->log2_page_sz;
470 size = round_pow2 (size, pagesize);
472 /* in adition of requested reservation, we also rserve one system page
473 * (typically 4K) adjacent to the start off reservation */
477 /* start address is provided, so we just need to make sure we are not
478 * replacing existing map */
479 if (start & pow2_mask (log2_page_sz))
482 base = (void *) start - sys_page_sz;
483 base = mmap (base, size + sys_page_sz, PROT_NONE,
484 MAP_PRIVATE | MAP_ANONYMOUS | MAP_FIXED_NOREPLACE, -1, 0);
485 return (base == MAP_FAILED) ? ~0 : start;
488 /* to make sure that we get reservation aligned to page_size we need to
489 * request one additional page as mmap will return us address which is
490 * aligned only to system page size */
491 base = mmap (0, size + pagesize, PROT_NONE,
492 MAP_PRIVATE | MAP_ANONYMOUS, -1, 0);
494 if (base == MAP_FAILED)
497 /* return additional space at the end of allocation */
498 p = base + size + pagesize;
499 n_bytes = (uword) p & pow2_mask (log2_page_sz);
506 /* return additional space at the start of allocation */
507 n_bytes = pagesize - sys_page_sz - n_bytes;
510 munmap (base, n_bytes);
514 return (uword) base + sys_page_sz;
517 clib_mem_vm_map_hdr_t *
518 clib_mem_vm_get_next_map_hdr (clib_mem_vm_map_hdr_t * hdr)
520 clib_mem_main_t *mm = &clib_mem_main;
521 uword sys_page_sz = 1 << mm->log2_page_sz;
522 clib_mem_vm_map_hdr_t *next;
527 mprotect (hdr, sys_page_sz, PROT_READ);
531 mprotect (hdr, sys_page_sz, PROT_NONE);
533 mprotect (next, sys_page_sz, PROT_READ);
538 clib_mem_vm_map_internal (void *base, clib_mem_page_sz_t log2_page_sz,
539 uword size, int fd, uword offset, char *name)
541 clib_mem_main_t *mm = &clib_mem_main;
542 clib_mem_vm_map_hdr_t *hdr;
543 uword sys_page_sz = 1 << mm->log2_page_sz;
544 int mmap_flags = MAP_FIXED, is_huge = 0;
548 mmap_flags |= MAP_SHARED;
549 log2_page_sz = clib_mem_get_fd_log2_page_size (fd);
550 if (log2_page_sz > mm->log2_page_sz)
555 mmap_flags |= MAP_PRIVATE | MAP_ANONYMOUS;
557 if (log2_page_sz == mm->log2_page_sz)
558 log2_page_sz = CLIB_MEM_PAGE_SZ_DEFAULT;
560 switch (log2_page_sz)
562 case CLIB_MEM_PAGE_SZ_UNKNOWN:
563 /* will fail later */
565 case CLIB_MEM_PAGE_SZ_DEFAULT:
566 log2_page_sz = mm->log2_page_sz;
568 case CLIB_MEM_PAGE_SZ_DEFAULT_HUGE:
569 mmap_flags |= MAP_HUGETLB;
570 log2_page_sz = mm->log2_default_hugepage_sz;
574 mmap_flags |= MAP_HUGETLB;
575 mmap_flags |= log2_page_sz << MAP_HUGE_SHIFT;
580 if (log2_page_sz == CLIB_MEM_PAGE_SZ_UNKNOWN)
581 return CLIB_MEM_VM_MAP_FAILED;
583 size = round_pow2 (size, 1 << log2_page_sz);
585 base = (void *) clib_mem_vm_reserve ((uword) base, size, log2_page_sz);
587 if (base == (void *) ~0)
588 return CLIB_MEM_VM_MAP_FAILED;
590 base = mmap (base, size, PROT_READ | PROT_WRITE, mmap_flags, fd, offset);
592 if (base == MAP_FAILED)
593 return CLIB_MEM_VM_MAP_FAILED;
595 if (is_huge && (mlock (base, size) != 0))
598 return CLIB_MEM_VM_MAP_FAILED;
601 hdr = mmap (base - sys_page_sz, sys_page_sz, PROT_READ | PROT_WRITE,
602 MAP_ANONYMOUS | MAP_PRIVATE | MAP_FIXED, -1, 0);
604 if (hdr != base - sys_page_sz)
607 return CLIB_MEM_VM_MAP_FAILED;
612 mprotect (mm->last_map, sys_page_sz, PROT_READ | PROT_WRITE);
613 mm->last_map->next = hdr;
614 mprotect (mm->last_map, sys_page_sz, PROT_NONE);
620 hdr->prev = mm->last_map;
623 hdr->base_addr = (uword) base;
624 hdr->log2_page_sz = log2_page_sz;
625 hdr->num_pages = size >> log2_page_sz;
627 snprintf (hdr->name, CLIB_VM_MAP_HDR_NAME_MAX_LEN - 1, "%s", (char *) name);
628 hdr->name[CLIB_VM_MAP_HDR_NAME_MAX_LEN - 1] = 0;
629 mprotect (hdr, sys_page_sz, PROT_NONE);
631 CLIB_MEM_UNPOISON (base, size);
636 clib_mem_vm_unmap (void *base)
638 clib_mem_main_t *mm = &clib_mem_main;
639 uword size, sys_page_sz = 1 << mm->log2_page_sz;
640 clib_mem_vm_map_hdr_t *hdr = base - sys_page_sz;;
642 if (mprotect (hdr, sys_page_sz, PROT_READ | PROT_WRITE) != 0)
643 return CLIB_MEM_ERROR;
645 size = hdr->num_pages << hdr->log2_page_sz;
646 if (munmap ((void *) hdr->base_addr, size) != 0)
647 return CLIB_MEM_ERROR;
651 mprotect (hdr->next, sys_page_sz, PROT_READ | PROT_WRITE);
652 hdr->next->prev = hdr->prev;
653 mprotect (hdr->next, sys_page_sz, PROT_NONE);
656 mm->last_map = hdr->prev;
660 mprotect (hdr->prev, sys_page_sz, PROT_READ | PROT_WRITE);
661 hdr->prev->next = hdr->next;
662 mprotect (hdr->prev, sys_page_sz, PROT_NONE);
665 mm->first_map = hdr->next;
667 if (munmap (hdr, sys_page_sz) != 0)
668 return CLIB_MEM_ERROR;
674 clib_mem_get_page_stats (void *start, clib_mem_page_sz_t log2_page_size,
675 uword n_pages, clib_mem_page_stats_t * stats)
680 log2_page_size = clib_mem_log2_page_size_validate (log2_page_size);
682 vec_validate (status, n_pages - 1);
683 vec_validate (ptr, n_pages - 1);
685 for (i = 0; i < n_pages; i++)
686 ptr[i] = start + (i << log2_page_size);
688 clib_memset (stats, 0, sizeof (clib_mem_page_stats_t));
690 if (move_pages (0, n_pages, ptr, 0, status, 0) != 0)
692 stats->unknown = n_pages;
696 for (i = 0; i < n_pages; i++)
698 if (status[i] >= 0 && status[i] < CLIB_MAX_NUMAS)
701 stats->per_numa[status[i]]++;
703 else if (status[i] == -EFAULT)
712 clib_mem_vm_get_paddr (void *mem, clib_mem_page_sz_t log2_page_size,
715 int pagesize = sysconf (_SC_PAGESIZE);
720 log2_page_size = clib_mem_log2_page_size_validate (log2_page_size);
722 if ((fd = open ((char *) "/proc/self/pagemap", O_RDONLY)) == -1)
725 for (i = 0; i < n_pages; i++)
727 u64 seek, pagemap = 0;
728 uword vaddr = pointer_to_uword (mem) + (((u64) i) << log2_page_size);
729 seek = ((u64) vaddr / pagesize) * sizeof (u64);
730 if (lseek (fd, seek, SEEK_SET) != seek)
733 if (read (fd, &pagemap, sizeof (pagemap)) != (sizeof (pagemap)))
736 if ((pagemap & (1ULL << 63)) == 0)
739 pagemap &= pow2_mask (55);
740 vec_add1 (r, pagemap * pagesize);
745 if (vec_len (r) != n_pages)
754 clib_mem_set_numa_affinity (u8 numa_node, int force)
756 clib_mem_main_t *mm = &clib_mem_main;
757 long unsigned int mask[16] = { 0 };
758 int mask_len = sizeof (mask) * 8 + 1;
760 /* no numa support */
761 if (mm->numa_node_bitmap == 0)
765 vec_reset_length (mm->error);
766 mm->error = clib_error_return (mm->error, "%s: numa not supported",
768 return CLIB_MEM_ERROR;
774 mask[0] = 1 << numa_node;
776 if (set_mempolicy (force ? MPOL_BIND : MPOL_PREFERRED, mask, mask_len))
779 vec_reset_length (mm->error);
783 vec_reset_length (mm->error);
784 mm->error = clib_error_return_unix (mm->error, (char *) __func__);
785 return CLIB_MEM_ERROR;
789 clib_mem_set_default_numa_affinity ()
791 clib_mem_main_t *mm = &clib_mem_main;
793 if (set_mempolicy (MPOL_DEFAULT, 0, 0))
795 vec_reset_length (mm->error);
796 mm->error = clib_error_return_unix (mm->error, (char *) __func__);
797 return CLIB_MEM_ERROR;
803 * fd.io coding-style-patch-verification: ON
806 * eval: (c-set-style "gnu")