debian/dpdk.conf

   1 #
   2 # The number of 2M hugepages to reserve on system boot
   3 #
   4 # Default is 0
   5 # To e.g. let it reserve 128M via 64x 2M Hugepages set:
   6 # NR_2M_PAGES=64
   7
   8 #
   9 # The number of 1G hugepages to reserve on system boot
  10 #
  11 # Default is 0
  12 # To e.g. let it reserve 2G via 2x 1G Hugepages set:
  13 # NR_1G_PAGES=2
  14
  15 # The number of 16M hugepages to reserve, supported e.g. on ppc64el
  16 #
  17 # Default is 0
  18 # To e.g. let it reserve 512M via 32x 16M Hugepages set:
  19 # NR_16M_PAGES=32
  20
  21 #
  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.
  26 #
  27 # Default is 0
  28 # Set to 1 to enable it
  29 #DROPCACHE_BEFORE_HP_ALLOC=0
  30
  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
  37 # the DPDK library.
  38
  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
  46
  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 ...
  55 #
  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
  59 #
  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.
  63 #
  64 # example:
  65 # GRUB_CMDLINE_LINUX_DEFAULT="... hugepages=16 hugepagesz=1G hugepages=2"
  66 #
  67 # If the system supports it, this will reserve 16x 2M pages and 2x 1G pages.
  68 #