Patch Detail
get:
Show a patch.
patch:
Update a patch.
put:
Update a patch.
GET /api/patches/109288/?format=api
{ "id": 109288, "url": "http://patches.dpdk.org/api/patches/109288/?format=api", "web_url": "http://patches.dpdk.org/project/dpdk/patch/20220406151106.2915304-22-juraj.linkes@pantheon.tech/", "project": { "id": 1, "url": "http://patches.dpdk.org/api/projects/1/?format=api", "name": "DPDK", "link_name": "dpdk", "list_id": "dev.dpdk.org", "list_email": "dev@dpdk.org", "web_url": "http://core.dpdk.org", "scm_url": "git://dpdk.org/dpdk", "webscm_url": "http://git.dpdk.org/dpdk", "list_archive_url": "https://inbox.dpdk.org/dev", "list_archive_url_format": "https://inbox.dpdk.org/dev/{}", "commit_url_format": "" }, "msgid": "<20220406151106.2915304-22-juraj.linkes@pantheon.tech>", "list_archive_url": "https://inbox.dpdk.org/dev/20220406151106.2915304-22-juraj.linkes@pantheon.tech", "date": "2022-04-06T15:11:03", "name": "[RFC,v1,21/24] dts: merge DTS doc/dts_gsg/usr_guide/setup_dut.rst to DPDK", "commit_ref": null, "pull_url": null, "state": "rfc", "archived": true, "hash": "6bffe1f9270fcab66d95f9a1e5b8239ecea4794c", "submitter": { "id": 1626, "url": "http://patches.dpdk.org/api/people/1626/?format=api", "name": "Juraj Linkeš", "email": "juraj.linkes@pantheon.tech" }, "delegate": { "id": 1, "url": "http://patches.dpdk.org/api/users/1/?format=api", "username": "tmonjalo", "first_name": "Thomas", "last_name": "Monjalon", "email": "thomas@monjalon.net" }, "mbox": "http://patches.dpdk.org/project/dpdk/patch/20220406151106.2915304-22-juraj.linkes@pantheon.tech/mbox/", "series": [ { "id": 22379, "url": "http://patches.dpdk.org/api/series/22379/?format=api", "web_url": "http://patches.dpdk.org/project/dpdk/list/?series=22379", "date": "2022-04-06T15:10:42", "name": "merge DTS documentation files to DPDK", "version": 1, "mbox": "http://patches.dpdk.org/series/22379/mbox/" } ], "comments": "http://patches.dpdk.org/api/patches/109288/comments/", "check": "warning", "checks": "http://patches.dpdk.org/api/patches/109288/checks/", "tags": {}, "related": [], "headers": { "Return-Path": "<dev-bounces@dpdk.org>", "X-Original-To": "patchwork@inbox.dpdk.org", "Delivered-To": "patchwork@inbox.dpdk.org", "Received": [ "from mails.dpdk.org (mails.dpdk.org [217.70.189.124])\n\tby inbox.dpdk.org (Postfix) with ESMTP id 59264A0508;\n\tWed, 6 Apr 2022 17:14:04 +0200 (CEST)", "from [217.70.189.124] (localhost [127.0.0.1])\n\tby mails.dpdk.org (Postfix) with ESMTP id E74C14291D;\n\tWed, 6 Apr 2022 17:11:41 +0200 (CEST)", "from lb.pantheon.sk (lb.pantheon.sk [46.229.239.20])\n by mails.dpdk.org (Postfix) with ESMTP id 705F9428F0\n for <dev@dpdk.org>; Wed, 6 Apr 2022 17:11:34 +0200 (CEST)", "from localhost (localhost [127.0.0.1])\n by lb.pantheon.sk (Postfix) with ESMTP id D058B16BC11;\n Wed, 6 Apr 2022 17:11:33 +0200 (CEST)", "from lb.pantheon.sk ([127.0.0.1])\n by localhost (lb.pantheon.sk [127.0.0.1]) (amavisd-new, port 10024)\n with ESMTP id E22uZpEgIdjd; Wed, 6 Apr 2022 17:11:32 +0200 (CEST)", "from entguard.lab.pantheon.local (unknown [46.229.239.141])\n by lb.pantheon.sk (Postfix) with ESMTP id 03D6119E0DA;\n Wed, 6 Apr 2022 17:11:16 +0200 (CEST)" ], "X-Virus-Scanned": "amavisd-new at siecit.sk", "From": "=?utf-8?q?Juraj_Linke=C5=A1?= <juraj.linkes@pantheon.tech>", "To": "thomas@monjalon.net, david.marchand@redhat.com,\n Honnappa.Nagarahalli@arm.com, ohilyard@iol.unh.edu, lijuan.tu@intel.com", "Cc": "dev@dpdk.org, =?utf-8?q?Juraj_Linke=C5=A1?= <juraj.linkes@pantheon.tech>", "Subject": "[RFC PATCH v1 21/24] dts: merge DTS\n doc/dts_gsg/usr_guide/setup_dut.rst to DPDK", "Date": "Wed, 6 Apr 2022 15:11:03 +0000", "Message-Id": "<20220406151106.2915304-22-juraj.linkes@pantheon.tech>", "X-Mailer": "git-send-email 2.25.1", "In-Reply-To": "<20220406151106.2915304-1-juraj.linkes@pantheon.tech>", "References": "<20220406151106.2915304-1-juraj.linkes@pantheon.tech>", "MIME-Version": "1.0", "Content-Type": "text/plain; charset=UTF-8", "Content-Transfer-Encoding": "8bit", "X-BeenThere": "dev@dpdk.org", "X-Mailman-Version": "2.1.29", "Precedence": "list", "List-Id": "DPDK patches and discussions <dev.dpdk.org>", "List-Unsubscribe": "<https://mails.dpdk.org/options/dev>,\n <mailto:dev-request@dpdk.org?subject=unsubscribe>", "List-Archive": "<http://mails.dpdk.org/archives/dev/>", "List-Post": "<mailto:dev@dpdk.org>", "List-Help": "<mailto:dev-request@dpdk.org?subject=help>", "List-Subscribe": "<https://mails.dpdk.org/listinfo/dev>,\n <mailto:dev-request@dpdk.org?subject=subscribe>", "Errors-To": "dev-bounces@dpdk.org" }, "content": "---\n dts/doc/dts_gsg/usr_guide/setup_dut.rst | 150 ++++++++++++++++++++++++\n 1 file changed, 150 insertions(+)\n create mode 100644 dts/doc/dts_gsg/usr_guide/setup_dut.rst", "diff": "diff --git a/dts/doc/dts_gsg/usr_guide/setup_dut.rst b/dts/doc/dts_gsg/usr_guide/setup_dut.rst\nnew file mode 100644\nindex 0000000000..c47db8b781\n--- /dev/null\n+++ b/dts/doc/dts_gsg/usr_guide/setup_dut.rst\n@@ -0,0 +1,150 @@\n+Set up DUT\n+===========\n+\n+This chapter describes the packages required to compile the DPDK in DUT.\n+\n+BIOS Setting Prerequisite on x86\n+--------------------------------\n+\n+DPDK prefers devices bound to ``vfio-pci`` kernel module, therefore, `VT-x` and `VT-d` should be enabled.\n+\n+.. code-block:: console\n+\n+ Advanced -> Integrated IO Configuration -> Intel(R) VT for Directed I/O <Enabled>\n+ Advanced -> Processor Configuration -> Intel(R) Virtualization Technology <Enabled>\n+\n+\n+Set Hugepages\n+------------------\n+\n+Hugepage support is required for the large memory pool allocation used for packet buffers\n+(the HUGETLBFS option must be enabled in the running kernel as indicated the previous section).\n+By using hugepage allocations, performance is increased since fewer pages are needed,\n+and therefore less Translation Lookaside Buffers (TLBs, high speed translation caches),\n+which reduce the time it takes to translate a virtual page address to a physical page address.\n+Without hugepages, high TLB miss rates would occur with the standard 4k page size, slowing performance.\n+\n+\n+Edit /etc/default/grub\n+~~~~~~~~~~~~~~~~~~~~~~~\n+\n+Set GRUB_CMDLINE_LINUX in etc/default/grub:\n+\n+for 2M pagesize::\n+\n+ GRUB_CMDLINE_LINUX=\"intel_iommu=on iommu=pt hugepagesz=2M hugepages=1024 default_hugepagesz=2M intel_pstate=disable\"\n+\n+for 1G pagesize::\n+\n+ GRUB_CMDLINE_LINUX=\"intel_iommu=on iommu=pt hugepagesz=1G hugepages=16 default_hugepagesz=1G intel_pstate=disable\"\n+\n+Execute grub-mkconfig\n+~~~~~~~~~~~~~~~~~~~~~~~\n+\n+execute below command::\n+\n+ # grub-mkconfig -o /boot/grub/grub.cfg\n+\n+.. note::\n+\n+ some OS may need execute following command::\n+\n+ #grub2-mkconfig -o /boot/grub2/grub.cfg\n+\n+then reboot OS to make the hugepage setting take effect.\n+\n+Packages Required\n+------------------\n+\n+**Required Tools and Libraries:**\n+\n+.. note::\n+\n+ The setup commands and installed packages needed on various systems may be different.\n+ For details on Linux distributions and the versions tested, please consult the DPDK Release Notes.\n+\n+* General development tools including a supported C compiler such as gcc (version 4.9+) or clang (version 3.4+).\n+\n+ * For RHEL/Fedora systems these can be installed using ``dnf groupinstall \"Development Tools\"``\n+\n+ * For Ubuntu/Debian systems these can be installed using ``apt install build-essential``\n+\n+* Python 3.5 or later.\n+\n+* Meson (version 0.49.2+) and ninja\n+\n+ * ``meson`` & ``ninja-build`` packages in most Linux distributions\n+\n+ * If the packaged version is below the minimum version, the latest versions\n+ can be installed from Python's \"pip\" repository: ``pip3 install meson ninja``\n+\n+* ``pyelftools`` (version 0.22+)\n+\n+ * For Fedora systems it can be installed using ``dnf install python-pyelftools``\n+\n+ * For RHEL/CentOS systems it can be installed using ``pip3 install pyelftools``\n+\n+ * For Ubuntu/Debian it can be installed using ``apt install python3-pyelftools``\n+\n+* Library for handling NUMA (Non Uniform Memory Access).\n+\n+ * ``numactl-devel`` in RHEL/Fedora;\n+\n+ * ``libnuma-dev`` in Debian/Ubuntu;\n+\n+.. note::\n+\n+ Please ensure that the latest patches are applied to third party libraries\n+ and software to avoid any known vulnerabilities.\n+\n+\n+**Optional Tools:**\n+\n+* Intel® C++ Compiler (icc). For installation, additional libraries may be required.\n+ See the icc Installation Guide found in the Documentation directory under the compiler installation.\n+\n+* IBM® Advance ToolChain for Powerlinux. This is a set of open source development tools and runtime libraries\n+ which allows users to take leading edge advantage of IBM's latest POWER hardware features on Linux. To install\n+ it, see the IBM official installation document.\n+\n+**Additional Libraries**\n+\n+A number of DPDK components, such as libraries and poll-mode drivers (PMDs) have additional dependencies.\n+For DPDK builds, the presence or absence of these dependencies will be automatically detected\n+enabling or disabling the relevant components appropriately.\n+\n+In each case, the relevant library development package (``-devel`` or ``-dev``) is needed to build the DPDK components.\n+\n+For libraries the additional dependencies include:\n+\n+* libarchive: for some unit tests using tar to get their resources.\n+\n+* libelf: to compile and use the bpf library.\n+\n+\n+Compile DPDK\n+-------------\n+\n+Now we can compile the DPDK to check whether the DUT ENV is OK.\n+\n+commands::\n+\n+ CC=gcc meson --werror -Denable_kmods=True -Dlibdir=lib --default-library=static x86_64-native-linuxapp-gcc\n+ ninja -C x86_64-native-linuxapp-gcc -j 110\n+\n+if there are no errors occurred during the compilation and the DPDK apps have been generated,\n+it means the DUT ENV is OK now.\n+\n+Check dpdk-testpmd::\n+\n+ root@dpdk:~/dpdk# ./x86_64-native-linuxapp-gcc/app/dpdk-testpmd --help\n+ EAL: Detected 72 lcore(s)\n+ EAL: Detected 2 NUMA nodes\n+\n+ Usage: ./x86_64-native-linuxapp-gcc/app/dpdk-testpmd [options]\n+\n+ EAL common options:\n+ -c COREMASK Hexadecimal bitmask of cores to run on\n+ -l CORELIST List of cores to run on\n+ ...\n+ --match-allocations Free hugepages exactly as allocated\n", "prefixes": [ "RFC", "v1", "21/24" ] }