From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mails.dpdk.org (mails.dpdk.org [217.70.189.124]) by inbox.dpdk.org (Postfix) with ESMTP id 01C5C42635; Mon, 25 Sep 2023 14:20:45 +0200 (CEST) Received: from mails.dpdk.org (localhost [127.0.0.1]) by mails.dpdk.org (Postfix) with ESMTP id 7E204402DF; Mon, 25 Sep 2023 14:20:45 +0200 (CEST) Received: from mgamail.intel.com (mgamail.intel.com [192.55.52.43]) by mails.dpdk.org (Postfix) with ESMTP id 5966C402DE for ; Mon, 25 Sep 2023 14:20:43 +0200 (CEST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=intel.com; i=@intel.com; q=dns/txt; s=Intel; t=1695644443; x=1727180443; h=date:from:to:cc:subject:message-id:references: content-transfer-encoding:in-reply-to:mime-version; bh=zMusNPKhfb8KnlBb1xPoZQlywhSsSz1HZKQwFIRxIkE=; b=DpTjmut+qoGG4vcS8UwNSBS83HCnN1X7z6O0wxChuuUb2N/sQRdH/roX HuF1hwkWH7lhD8Pkb1KER6V2hBxKeueazC4W0Vsf/EoC8UzaoPTHFKXVC MX7eH/CnP+KZ/ql2GiboCIx6zQMJcHUTtBC/bKBt2BQE1f+lDyhONpa8l zF5XjaH5IPYhzffc+t5d/9ldf+guVZ0meHGK3UCa4+mQRvnoOS4fcDInT 2oaRqgWLYFKS+4BG6kmxR0I0ANCbD+DS5h9iBmuGhR6B/dVcPxtZ53aa5 B+flDINYG1xQnnG5uokLPbUh1bddaTMDJgLW7kIXcZoEk71uqIwp/wq4F w==; X-IronPort-AV: E=McAfee;i="6600,9927,10843"; a="467521986" X-IronPort-AV: E=Sophos;i="6.03,174,1694761200"; d="scan'208";a="467521986" Received: from orsmga008.jf.intel.com ([10.7.209.65]) by fmsmga105.fm.intel.com with ESMTP/TLS/ECDHE-RSA-AES256-GCM-SHA384; 25 Sep 2023 05:20:41 -0700 X-ExtLoop1: 1 X-IronPort-AV: E=McAfee;i="6600,9927,10843"; a="777630091" X-IronPort-AV: E=Sophos;i="6.03,174,1694761200"; d="scan'208";a="777630091" Received: from fmsmsx601.amr.corp.intel.com ([10.18.126.81]) by orsmga008.jf.intel.com with ESMTP/TLS/AES256-GCM-SHA384; 25 Sep 2023 05:20:41 -0700 Received: from fmsmsx611.amr.corp.intel.com (10.18.126.91) by fmsmsx601.amr.corp.intel.com (10.18.126.81) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256) id 15.1.2507.32; Mon, 25 Sep 2023 05:20:40 -0700 Received: from fmsmsx610.amr.corp.intel.com (10.18.126.90) by fmsmsx611.amr.corp.intel.com (10.18.126.91) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256) id 15.1.2507.32; Mon, 25 Sep 2023 05:20:40 -0700 Received: from FMSEDG603.ED.cps.intel.com (10.1.192.133) by fmsmsx610.amr.corp.intel.com (10.18.126.90) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256) id 15.1.2507.32 via Frontend Transport; Mon, 25 Sep 2023 05:20:40 -0700 Received: from NAM04-MW2-obe.outbound.protection.outlook.com (104.47.73.169) by edgegateway.intel.com (192.55.55.68) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.1.2507.32; Mon, 25 Sep 2023 05:20:34 -0700 ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=Pjbws6e4AbFe1093tXYb91RqZ/IV28wLlFhzj7UM16GJsu1/W1mSsspRIb98DR3iwEn3C+8kvaXkOUm+ZRVBqhM8ocwyFxSkxaYIDiAyqWgzU+jXcrPr5ZVIADpFHvzmhQ9irR5pLtU6I9NdtOJlNWCbFW4IEtNfraaKzq4helxAb7UiTeimgg810St0FJjN5MAjb+KdNkU/E3dJcT3eQXidS+WJzNMYQyjYRLfC8aP4PD+V2ws6MrmYZTXFDenkfUSoOlVbnmSS0yoe0Na4J16TKY12GFCgJegXxDIaofg+VNUf0/0trdvXRajmUSc07ZMd2CWYgKWmIpT/cjcC8A== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=microsoft.com; s=arcselector9901; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-AntiSpam-MessageData-ChunkCount:X-MS-Exchange-AntiSpam-MessageData-0:X-MS-Exchange-AntiSpam-MessageData-1; bh=vuLjQIUuOK3UZcpIkbZGRu+/LhgzQ675m/XwMWinGvo=; b=f2nTutVYDXTu2aHWp+8t9o6e6a8zgQHlwqi/nFRM2AFnPsCcI23+EJmHExMbNtF7sqlkxnDFWpgySDzoynm+poIf1ZznnvNI1DqPwjjvGG7PCTN8+h8n051EBqikYypNUWhGHnjfYCKB4FMeTnbdUQA4PD/vAH7MxeEYBm7eDHNoxBrk/kr7JMIB80kpW4W2GvAz6jAuq5yTJjZ8E+QHm2+a+zfOanm2nBlRTpUK2hI3OjPby39uMVTTxuE+avUex5Zej5vTLr9rWv4MDMgtjzCxb+BCW8DVtgnMMizmsj+QqrTVHzyBZARgq5XmX8qviiGWHkqUuaUXThXg5ZrD0Q== ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass smtp.mailfrom=intel.com; dmarc=pass action=none header.from=intel.com; dkim=pass header.d=intel.com; arc=none Authentication-Results: dkim=none (message not signed) header.d=none;dmarc=none action=none header.from=intel.com; Received: from DS0PR11MB7309.namprd11.prod.outlook.com (2603:10b6:8:13e::17) by PH0PR11MB5829.namprd11.prod.outlook.com (2603:10b6:510:140::8) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.6792.27; Mon, 25 Sep 2023 12:20:32 +0000 Received: from DS0PR11MB7309.namprd11.prod.outlook.com ([fe80::43d1:af60:464:347]) by DS0PR11MB7309.namprd11.prod.outlook.com ([fe80::43d1:af60:464:347%5]) with mapi id 15.20.6768.029; Mon, 25 Sep 2023 12:20:32 +0000 Date: Mon, 25 Sep 2023 13:20:24 +0100 From: Bruce Richardson To: Ferruh Yigit CC: David Young , Subject: Re: [PATCH 2/6] Section 2: Install and Build DPDK Message-ID: References: <20230920154817.617-1-dave@youngcopy.com> <20230920154817.617-3-dave@youngcopy.com> <42a18fab-e4a3-4cf6-8892-1434e4727289@amd.com> Content-Type: text/plain; charset="utf-8" Content-Disposition: inline Content-Transfer-Encoding: 8bit In-Reply-To: <42a18fab-e4a3-4cf6-8892-1434e4727289@amd.com> X-ClientProxiedBy: DB8P191CA0010.EURP191.PROD.OUTLOOK.COM (2603:10a6:10:130::20) To DS0PR11MB7309.namprd11.prod.outlook.com (2603:10b6:8:13e::17) MIME-Version: 1.0 X-MS-PublicTrafficType: Email X-MS-TrafficTypeDiagnostic: DS0PR11MB7309:EE_|PH0PR11MB5829:EE_ X-MS-Office365-Filtering-Correlation-Id: 79554381-11ec-49c6-cd24-08dbbdc1d069 X-MS-Exchange-SenderADCheck: 1 X-MS-Exchange-AntiSpam-Relay: 0 X-Microsoft-Antispam: BCL:0; X-Microsoft-Antispam-Message-Info: z377Po1Dapj2BdcGe6iPu7Ai9RhIWJofgmwl7O1MLphCRbKF7NI3K57c9OHeaZUOThLf/4D4vfsilJC1MwINcHFZOVTblwH0fPSE59ddwY9SBpHu3t7csKwnpXOVGTCRFaYn1/SZttFrFRbV+PPc8npHdFGc3JoqAv2N95Vp36RuXTRkYw9r4NM4YdotHcAJ/zs2kWB7rTXAVQAOTnwG7vS5rCqVOwW+KTxqKj21KdVjUzjUT44rtTZRH+V/5IxJ8kxV8fsX8AlLF7LDiVaL7XdZiiglMQMk7GcHnJsDQ82jIvCfJBN0lUep421MUSHmUu4eq4ueUcixSEQMf40RcE6FKJeiYx9Bn/i04iEQVRXar3Wh0K9b/Y9oG6+H/EdMszBy9hqTD2K8phWdiJMxS+WDfT6a6WSkMrQ8VvSJf8ADQhnza3bQ0CWips50ZIOE1HjBc11MnwglYz8B1lKgAlp6F6PV3stDYdsUlZ8E6g/rqBv143rB5usQx52wUhQKe0aqW7s8fHJGnYwTELC6WVAQu9Udq87J8O5yFs97NgmuaEgGP8bSegP21q2CM08spPC2yMfZ5s51vtdX/aV2/g== X-Forefront-Antispam-Report: CIP:255.255.255.255; CTRY:; LANG:en; SCL:1; SRV:; IPV:NLI; SFV:NSPM; H:DS0PR11MB7309.namprd11.prod.outlook.com; PTR:; CAT:NONE; SFS:(13230031)(346002)(136003)(396003)(366004)(39860400002)(376002)(230922051799003)(1800799009)(186009)(451199024)(26005)(6666004)(478600001)(966005)(83380400001)(86362001)(82960400001)(5660300002)(6486002)(53546011)(6506007)(38100700002)(6512007)(4326008)(2906002)(8676002)(41300700001)(316002)(6916009)(66946007)(66476007)(66556008)(8936002)(44832011); DIR:OUT; SFP:1102; X-MS-Exchange-AntiSpam-MessageData-ChunkCount: 1 X-MS-Exchange-AntiSpam-MessageData-0: =?utf-8?B?V0NYb0FTQmdONkM0UVprclZKYU9XUG5wSWZhRmVtRHNzSXkvcHJVWUdjRzd5?= =?utf-8?B?eGp4dWFwdEJUdjZiUXYxbXVuaVpSSjlJRGpJdG1FYk9MbXQwK0RqalluSnlC?= =?utf-8?B?ZVQwL0JwVWlKbmhiMjNWa052cnpmTTNmdGw2Z2t3Y1BLVVRSVnlnSEhNUWNC?= =?utf-8?B?UGQ3N0I4UEtrY25RRXZOaVZ0WWZkSC9YanRPTnVZYm9GVTVVK0xsaHZtRXdV?= =?utf-8?B?NzYwNDRBWHhrYkJoeDBMSndvYk1XYTk5Tzk4TVdFNzdSanpiNHhEcGNqNlVm?= =?utf-8?B?UVFlbEVtWUpxQkR5dnlTRDA4ckUzeVEvMm93ZVFRMG02TlJTYlBlTEFCa3o3?= =?utf-8?B?QnF6ZGhTU3BzMXUxMnlYckVIcVN0NktKcGNoalRpSmNtYkRxNVZ5UzYyR2JE?= =?utf-8?B?d1BrUTAxakU2cWwwRWtqeU1ORUtFOHoxeVFYR0pRaG02NWZscHVKdFp2SUFH?= =?utf-8?B?eE11UjB3MnBVU1ZCY3A1THFZdElIMy92UzhnbGU3UDE4OEdwaFRXbnVDcGtP?= =?utf-8?B?TVpvT3l3Z0tpU3QyaGlWTC9YeksxQnA4Vmcvenk4TVBEMzZhTzdrZTdKN3Jk?= =?utf-8?B?SGx3SGVrMkw5THpqNWg0MU1lSHZDSDNWcEJQdEdaM003ajZtZHZzYk9zWEVF?= =?utf-8?B?WXR6aXFoS1hxK1k2RVQwVzVhK3QzQ1ZiczBNNlBrcG5UdnZJbWFIcDFYZXBB?= =?utf-8?B?dmpqLzFWUlg2L0J1ZzltOWgwUmNBemJyTFI1bWZQV2Z0K3ErYlNWdTRwb2pl?= =?utf-8?B?MzJ0bXlzbGljQXJCRG1CZFhpUFRxcUlCVHBQZkVHajJEbUtWQ1dKMHZsVTZl?= =?utf-8?B?OStxY010NVRXdFNzdUxhVkxGaXlybllyNW1kOFJYV3d4clIxYU5ybHNWRlA3?= =?utf-8?B?b0JlWEFiSFpQajc4UUY2RnNrNWlpMU5BU2ZFaDhleC9nOXVnQWJyUVEyOWFR?= =?utf-8?B?dkNEcmYyTzVNSm5wM2drZlVrWWhzWUxmdXNuY2V1TGRuWHg4dlpzM1pLcDYy?= =?utf-8?B?V1hqZTl3eCtGVys1bFpCVllvV0RXV096WEJlcVFyNjZOV0xxVVJhY1FLaWhF?= =?utf-8?B?ejNVYU5haUhpazhxc1FjNXBmV0ZITnVFSTdhWCtQN204TjZsdEsrV0pyejFy?= =?utf-8?B?L1F0eDFReDFsSHY3dlR1M24wS0xWUmZYOXlPQUxpc2dIazhZQXhjbVE4YmNN?= =?utf-8?B?UEZ6bjljeXkyUlJxQmNFOGRJUGhWeHd2TzBpREtwdHIxU1gyTWZwcEZlYjdX?= =?utf-8?B?QlVXSjgzdm5pZDhHWnZxRjRUYVJEeTJoNTg3eGdiZGFOZ3JhdmQycStXUWI5?= =?utf-8?B?MEJQNGJhU1lWMkxtRzhNcHY3NXpUSlBkOG9tNFNYeC9xZjRBd1RRK2hTbStS?= =?utf-8?B?WjlOVG5rOUdGeGw1L2VIZEwzUkRlRVJxUVA3NXQvVktGUEtqMzFGSWRaNUJm?= =?utf-8?B?eW1xWVBEZURxaUZlTnhXRk40c29FUG1kMmZESVlLWHd1TC9OV01hWnpDT3Bh?= =?utf-8?B?akRWTVVuaVRRVlBncit5dEVzZG94OVk3OWdRK0phNUFaUXNtQXgzcUphS2FY?= =?utf-8?B?K0pMWlZhRG8rQTFHNzh5M3RtUHdsdnZ5QmdqVndrNjUzbFRteVJseW5sa0Jw?= =?utf-8?B?bHdQRWF6NStQdUlxb1QzQjJwdzdNYnc3SXZ4ajNFMmZMWXVMVmVYeW5HRUc1?= =?utf-8?B?blVmKzhPSUI2TWN6VFh6OTh6OElRU1lsQmJFZnl0dktXQzdya3NuYmlmRmk0?= =?utf-8?B?MkhWWVNISFhMT0k3Rmlvd0kwY0NOZ2VzMHNBLzNPdFJTZ1pHdDBONXdMOEdY?= =?utf-8?B?TVB6VlF2SndoMnh3d2tkazVzTGhsMlNBYzFYdjlMbHlQcEtKRUFCazZFWjl4?= =?utf-8?B?VEJPcFNTN2ZtTkpBNUtKMjJVeFdZRGRXaXltd0lleWZpenkvWkdjKzVPRVNt?= =?utf-8?B?ZzRNUW1NNzNFS09SYmlnTG5RVFI5MkdBZFl4aXJTWlU3UTVFeXZUbGlIYzN3?= =?utf-8?B?VjhXRGFrWkFhQnNxL3hjVzNGNlhNbUtJTXgwUmxLRjNRZXhGM2lVd2tNRXhZ?= =?utf-8?B?QU1YNnFaVmQvTGRybGdiQmJKbzBnNFZlL3lIVGFheVYxeGkyZjNUTFE1blJm?= =?utf-8?B?a2dKUml6MHVhRFdPOEwxMjFwTnh2TDNhV2NuQUVmQW1jMjhNZkRBS1E1eXBt?= =?utf-8?B?SHc9PQ==?= X-MS-Exchange-CrossTenant-Network-Message-Id: 79554381-11ec-49c6-cd24-08dbbdc1d069 X-MS-Exchange-CrossTenant-AuthSource: DS0PR11MB7309.namprd11.prod.outlook.com X-MS-Exchange-CrossTenant-AuthAs: Internal X-MS-Exchange-CrossTenant-OriginalArrivalTime: 25 Sep 2023 12:20:32.8406 (UTC) X-MS-Exchange-CrossTenant-FromEntityHeader: Hosted X-MS-Exchange-CrossTenant-Id: 46c98d88-e344-4ed4-8496-4ed7712e255d X-MS-Exchange-CrossTenant-MailboxType: HOSTED X-MS-Exchange-CrossTenant-UserPrincipalName: ZDS2ALy8MTofWHil9DQhvQqpFS/Dcbz13XH2Y1H4JFTDcCXiJhYtKgdTHKNcbEXx/WZDCJKx7yrdZMrdtpMUzfe++wPp+mnhCJ06R7gZ7fY= X-MS-Exchange-Transport-CrossTenantHeadersStamped: PH0PR11MB5829 X-OriginatorOrg: intel.com X-BeenThere: dev@dpdk.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: DPDK patches and discussions List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: dev-bounces@dpdk.org On Mon, Sep 25, 2023 at 12:30:35PM +0100, Ferruh Yigit wrote: > On 9/20/2023 4:48 PM, David Young wrote: > > --- > > .../building_from_sources.rst | 108 ++++++++++++++++++ > > .../install_and_build/index.rst | 15 +++ > > .../installing_prebuilt_packages.rst | 54 +++++++++ > > .../windows_install_build.rst | 93 +++++++++++++++ > > 4 files changed, 270 insertions(+) > > create mode 100644 doc/guides/getting_started_guide/install_and_build/building_from_sources.rst > > create mode 100644 doc/guides/getting_started_guide/install_and_build/index.rst > > create mode 100644 doc/guides/getting_started_guide/install_and_build/installing_prebuilt_packages.rst > > create mode 100644 doc/guides/getting_started_guide/install_and_build/windows_install_build.rst > > > > diff --git a/doc/guides/getting_started_guide/install_and_build/building_from_sources.rst b/doc/guides/getting_started_guide/install_and_build/building_from_sources.rst > > new file mode 100644 > > index 0000000000..e4ee8e436d > > --- /dev/null > > +++ b/doc/guides/getting_started_guide/install_and_build/building_from_sources.rst > > @@ -0,0 +1,108 @@ > > +.. SPDX-License-Identifier: BSD-3-Clause > > + Copyright(c) 2010-2025 Intel Corporation. > > + > > +.. _building_from_sources: > > + > > +Building and Installing DPDK from Sources > > +========================================= > > + > > +This chapter provides a comprehensive guide for building DPDK from sources on both > > +Linux and FreeBSD platforms. It covers the necessary steps, prerequisites, > > +and considerations for different architectures and compilers. > > + > > +Required Tools > > +-------------- > > + > > +To build DPDK, you'll need the following tools: > > + > > +- A C compiler like ``gcc`` (version 5+) or ``clang`` (version 3.6+) > > +- ``pkg-config`` or ``pkgconf`` > > +- Python 3.6 or later > > +- ``meson`` (version 0.53.2+) and ``ninja`` > > +- ``pyelftools`` (version 0.22+) > > + > > > > Is 'libnuma' also a dependency? > > When I remove it in my platform and build DPDK again, getting following > in meson stage: > > " > config/meson.build:419:4: ERROR: Problem encountered: > No NUMA library (development package) found, yet DPDK configured for > multiple NUMA nodes. > Please install libnuma, or set 'max_numa_nodes' option to '1' to build > without NUMA support. > " > Realistically, yes it is a dependency and we should include it here. > > > > +Here's how to install them: > > + > > +Linux > > +^^^^^ > > + > > +Alpine > > + > > +.. code-block:: bash > > + > > + sudo apk add alpine-sdk bsd-compat-headers > > + pip install meson ninja > > + > > +Debian and Ubuntu and derivatives > > + > > +.. code-block:: bash > > + > > + sudo apt install build-essential > > + pip install meson ninja > > + > > +Fedora and RedHat Enterprise Linux RHEL > > + > > +.. code-block:: bash > > + > > + sudo dnf groupinstall "Development Tools" > > + pip install meson ninja > > + > > Above are missing some of the dependencies above, just to confirm if > they are installed by default? > And even if so, if we should provide explicit commands to install all, > to be sure? > > > > > +openSUSE > > + > > +.. code-block:: bash > > + > > + sudo zypper install -t pattern devel_basis python3-pyelftools > > + pip install meson ninja > > + > > +FreeBSD > > +^^^^^^^ > > + > > +FreeBSD (as root) > > + > > +.. code-block:: bash > > + > > + pkg install meson pkgconf py38-pyelftools > > + > > +Note: If you're using FreeBSD, you'll also need kernel sources. Make sure they're included during the FreeBSD installation. > > + > > +Getting the DPDK Source > > +----------------------- > > + > > +Download the DPDK source code from the official repository > > +``https://fast.dpdk.org/rel/``. > > + > > +Use ``wget`` to grab the DPDK version:: > > + > > + wget https://fast.dpdk.org/rel/dpdk-.tar.xz > > + > > +Extract the downloaded archive: > > + > > +.. code-block:: bash > > + > > + tar -xvf dpdk-.tar.gz > > + > > +Navigate to the DPDK directory: > > + > > +.. code-block:: bash > > + > > + cd dpdk- > > + > > +Building DPDK > > +------------- > > + > > +Configure the build based on your needs, hardware, and environment. > > +This might include setting specific flags or options. For example: “meson setup -Dbuildtype=debugoptimized build”. Then compile using “ninja” and install using “meson install”. > > + > > +.. code-block:: bash > > + > > + ninja -C build > > + cd build > > + sudo ninja install> > > Above mentions from "meson install", here using "ninja install", should > we unify it to one? > Yes, we should standardize on meson install. >