2 # The number of 2M hugepages to reserve on system boot
5 # To e.g. let it reserve 128M via 64x 2M Hugepages set:
9 # The number of 1G hugepages to reserve on system boot
12 # To e.g. let it reserve 2G via 2x 1G Hugepages set:
15 # The number of 16M hugepages to reserve, supported e.g. on ppc64el
18 # To e.g. let it reserve 512M via 32x 16M Hugepages set:
22 # Dropping slab and pagecache can help to successfully allocate hugepages,
23 # especially later in the lifecycle of a system.
24 # This comes at the cost of loosing all slab and pagecache on (re)start
25 # of the dpdk service - therefore the default is off.
28 # Set to 1 to enable it
29 #DROPCACHE_BEFORE_HP_ALLOC=0
31 # The DPDK library will use the first mounted hugetlbfs.
32 # The init scripts try to ensure there is at least one default hugetlbfs
33 # mountpoint on start.
34 # If you have multiple hugetlbfs mountpoints for a complex (e.g. specific numa
35 # policies) setup it should be controlled by the admin instead of this init
36 # script. In that case specific mountpoints can be provided as parameters to
39 # Also please be aware that multiple huge page sizes and their mountpoints
40 # can confuse other programs as well. For example libvirt/qemu might pick one
41 # of the paths created for DPDKs larger pages or any such.
42 # It is recommended in these cases to consider configuring the respective
43 # applications as well to not "guess" when picking a hugepage path.
44 # In the libvirt/qemu case that would for example be the setting
45 # hugetlbfs_mount in /etc/libvirt/qemu.conf
47 # Hardware may support other granularities of hugepages (like 4M). But the
48 # larger the hugepages the earlier those should be allocated.
49 # Note: the dpdk init scripts will report warnings, but not fail if they could
50 # not allocate the requested amount of hugepages.
51 # The more or the larger the hugepages to be allocated are, the more it is
52 # recommended to do the reservation as kernel commandline arguments.
53 # To do so edit /etc/default/grub: GRUB_CMDLINE_LINUX_DEFAULT
54 # and add [hugepagesz=xx] hugepages=yy ...
56 # Kernel commandline config:
57 # hugepagesz sets the size for the next hugepages reservation (default 2M)
58 # hugepages reserves the given number of hugepages of the size set before
60 # After modifying /etc/default/grub, the command "update-grub" has to be
61 # run in order to re-generate the grub config files. The new values will
62 # be used after next reboot.
65 # GRUB_CMDLINE_LINUX_DEFAULT="... hugepages=16 hugepagesz=1G hugepages=2"
67 # If the system supports it, this will reserve 16x 2M pages and 2x 1G pages.