[dpdk-dev] [PATCH v6] usertools: add a huge page setup script
Ajit Khaparde
ajit.khaparde at broadcom.com
Wed Sep 9 21:26:34 CEST 2020
::::snip::::
>
> diff --git a/doc/guides/tools/hugepages.rst
> b/doc/guides/tools/hugepages.rst
> new file mode 100644
> index 000000000000..a82b71620011
> --- /dev/null
> +++ b/doc/guides/tools/hugepages.rst
> @@ -0,0 +1,79 @@
> +.. SPDX-License-Identifier: BSD-3-Clause
> + Copyright (c) 2020 Microsoft Corporation
> +
> +dpdk-hugpages Application
>
Should this be dpdk-hugepages ?
+==========================
> +
> +The ``dpdk-hugpages`` tool is a Data Plane Development Kit (DPDK) utility
> +that helps in reserving hugepages.
> +As well as checking for current settings.
> +
> +
> +Running the Application
> +-----------------------
> +
> +The tool has a number of command line options:
> +
> +.. code-block:: console
> +
> +
> + dpdk-hugpages [options]
>
s/hugpages/hugepages ?
> +
> +
> +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.
> +
> +
> +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
>
> ::::snip::::
>
More information about the dev
mailing list