4. dpdk-hugepages Application

The dpdk-hugepages tool is a Data Plane Development Kit (DPDK) utility that helps in reserving hugepages. As well as checking for current settings.

4.1. Running the Application

The tool has a number of command line options:

dpdk-hugepages [options]

4.2. Options

  • -h, --help

    Display usage information and quit

  • -s, --show

    Print the current huge page configuration

  • -c driver, --clear

    Clear existing huge page reservation

  • -m, --mount

    Mount the huge page filesystem

  • -u, --unmount

    Unmount the huge page filesystem

  • -n NODE, --node=NODE

    Set NUMA node to reserve pages on

  • -p SIZE, --pagesize=SIZE

    Select hugepage size to use.

    If not specified the default system huge page size is used.

  • -r SIZE, --reserve=SIZE

    Reserve huge pages.

    Size is in bytes with K, M or G suffix.

  • --setup SIZE

    Short cut to clear, unmount, reserve and mount.

Warning

While any user can run the dpdk-hugpages.py script to view the status of huge pages, modifying the setup requires root privileges.

4.3. Examples

To display current huge page settings:

dpdk-hugpages.py -s

To a complete setup of with 2 Gigabyte of 1G huge pages:

dpdk-hugpages.py -p 1G --setup 2G