From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from dpdk.org (dpdk.org [92.243.14.124]) by inbox.dpdk.org (Postfix) with ESMTP id 7499FA04B7; Wed, 14 Oct 2020 16:10:31 +0200 (CEST) Received: from [92.243.14.124] (localhost [127.0.0.1]) by dpdk.org (Postfix) with ESMTP id 154641DDA3; Wed, 14 Oct 2020 16:10:30 +0200 (CEST) Received: from EUR03-AM5-obe.outbound.protection.outlook.com (mail-eopbgr30055.outbound.protection.outlook.com [40.107.3.55]) by dpdk.org (Postfix) with ESMTP id 3CC831DCCC for ; Wed, 14 Oct 2020 16:10:29 +0200 (CEST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=armh.onmicrosoft.com; s=selector2-armh-onmicrosoft-com; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=SuaRGwjxWNtLc0ew+2C65XEQzFrMIxIFB5ZJw+/sMek=; b=NrGyzOdIMZzT5DBLlDA9QQIolDi789J7tBmqClL7s87Ped9jWvebj+aRhD3Z4T32IWh0t30WtvRYHuraV8nvsuk2bCaFhc604NQNOHdU6vmSD+w48kGGKkaszF42p9ygONP+16eJ+9XB//VpuOf8vz+tEKiLYbngyRrA9oEbA5Y= Received: from AM6PR04CA0023.eurprd04.prod.outlook.com (2603:10a6:20b:92::36) by DB7PR08MB3403.eurprd08.prod.outlook.com (2603:10a6:10:4b::24) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.3455.26; Wed, 14 Oct 2020 14:10:26 +0000 Received: from VE1EUR03FT013.eop-EUR03.prod.protection.outlook.com (2603:10a6:20b:92:cafe::b7) by AM6PR04CA0023.outlook.office365.com (2603:10a6:20b:92::36) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.3477.21 via Frontend Transport; Wed, 14 Oct 2020 14:10:26 +0000 X-MS-Exchange-Authentication-Results: spf=pass (sender IP is 63.35.35.123) smtp.mailfrom=arm.com; dpdk.org; dkim=pass (signature was verified) header.d=armh.onmicrosoft.com;dpdk.org; dmarc=pass action=none header.from=arm.com; Received-SPF: Pass (protection.outlook.com: domain of arm.com designates 63.35.35.123 as permitted sender) receiver=protection.outlook.com; client-ip=63.35.35.123; helo=64aa7808-outbound-1.mta.getcheckrecipient.com; Received: from 64aa7808-outbound-1.mta.getcheckrecipient.com (63.35.35.123) by VE1EUR03FT013.mail.protection.outlook.com (10.152.19.37) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.3477.21 via Frontend Transport; Wed, 14 Oct 2020 14:10:25 +0000 Received: ("Tessian outbound d5e343850048:v64"); Wed, 14 Oct 2020 14:10:25 +0000 X-CR-MTA-TID: 64aa7808 Received: from e343d191fc6b.1 by 64aa7808-outbound-1.mta.getcheckrecipient.com id 204E131F-7ACB-42B3-83CD-9B7BC85F075A.1; Wed, 14 Oct 2020 14:10:20 +0000 Received: from EUR04-VI1-obe.outbound.protection.outlook.com by 64aa7808-outbound-1.mta.getcheckrecipient.com with ESMTPS id e343d191fc6b.1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384); Wed, 14 Oct 2020 14:10:20 +0000 ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=dHuVvSzVka86olkv2CqIKZ9QmmnsP0s/q6MJt1MKs/I39gRfDMeXWwhbQU5xF4c/qr5jYpJzicgX2wdlOY+f3vPoTTAzb+Gb3vHPtS5AVnLDx5qFJLuL7fBb/ehuZXk37eX4kD6uR/T3b97xRTmgfjdNDL/hiEXF+axkzRb/FfUkP2NP2zG2ECJZtfWNx2JkT5+3f9U0EgQB4amlyzgn8jjSqHoSZP+2AThu6ksrpegi4Ns2woYniKhfdF2VU0kHiQhC++HWattmtkoIKIm/pLiVS9EgCf0CpOHUu9tqC7LYlG1atpkdy9z6KIkMTd1S37t5PnXSdteO+1oy4Xdzzg== 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-SenderADCheck; bh=SuaRGwjxWNtLc0ew+2C65XEQzFrMIxIFB5ZJw+/sMek=; b=n4Ke6u+6xfr3lPRP5Y4ejtTjIMwsEdhrgvuwaC8IDgHWsfvBbcLZziZlZqB//BmQNGc37xCMsWZXGdwtA9uokvec9aAHl9248RdubYOmrT0X2ceUHU2jR8Q++I+FXjf3B+K0/Dj8caWoyoHTKnNfayu+sTdNdQB4lYNNzZeLZ/d1Jo9CFPeJ8tWq4uv82miXBE1mSTeNGbgl/vj6dPHcRXnax2hABcPYFEYZiefY1rkVdqPc5XA+VvmF+4CYgeClsZpEEeeeTYDxNVGR9dJV21r8l77R4E5dJ/xCwAHXc+AhzMoCHEJkpwtxtUSiV4qxDlNq0r/M6KPzTNWcDfC4mQ== ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass smtp.mailfrom=arm.com; dmarc=pass action=none header.from=arm.com; dkim=pass header.d=arm.com; arc=none DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=armh.onmicrosoft.com; s=selector2-armh-onmicrosoft-com; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=SuaRGwjxWNtLc0ew+2C65XEQzFrMIxIFB5ZJw+/sMek=; b=NrGyzOdIMZzT5DBLlDA9QQIolDi789J7tBmqClL7s87Ped9jWvebj+aRhD3Z4T32IWh0t30WtvRYHuraV8nvsuk2bCaFhc604NQNOHdU6vmSD+w48kGGKkaszF42p9ygONP+16eJ+9XB//VpuOf8vz+tEKiLYbngyRrA9oEbA5Y= Received: from DBAPR08MB5814.eurprd08.prod.outlook.com (2603:10a6:10:1b1::6) by DB7PR08MB3084.eurprd08.prod.outlook.com (2603:10a6:5:22::31) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.3455.24; Wed, 14 Oct 2020 14:10:17 +0000 Received: from DBAPR08MB5814.eurprd08.prod.outlook.com ([fe80::7814:9c1:781f:475d]) by DBAPR08MB5814.eurprd08.prod.outlook.com ([fe80::7814:9c1:781f:475d%4]) with mapi id 15.20.3477.020; Wed, 14 Oct 2020 14:10:17 +0000 From: Honnappa Nagarahalli To: Ruifeng Wang , Ruifeng Wang CC: "dev@dpdk.org" , "Akhil.goyal@nxp.com" , nd , Honnappa Nagarahalli , nd Thread-Topic: [PATCH] doc: update build guide for armv8 crypto PMD Thread-Index: AQHWogvdi1ayUj+nCUyZYyCZYt7CLKmXIxBQ Date: Wed, 14 Oct 2020 14:10:17 +0000 Message-ID: References: <20201014092414.9532-1-ruifeng.wang@arm.com> In-Reply-To: <20201014092414.9532-1-ruifeng.wang@arm.com> Accept-Language: en-US Content-Language: en-US X-MS-Has-Attach: X-MS-TNEF-Correlator: x-ts-tracking-id: D15F113C97F70241A1098C5B3DDFA766.0 x-checkrecipientchecked: true Authentication-Results-Original: arm.com; dkim=none (message not signed) header.d=none;arm.com; dmarc=none action=none header.from=arm.com; x-originating-ip: [217.140.110.7] x-ms-publictraffictype: Email X-MS-Office365-Filtering-HT: Tenant X-MS-Office365-Filtering-Correlation-Id: 20c9443f-780e-4c5c-d1ef-08d8704ae5d2 x-ms-traffictypediagnostic: DB7PR08MB3084:|DB7PR08MB3403: x-ld-processed: f34e5979-57d9-4aaa-ad4d-b122a662184d,ExtAddr x-ms-exchange-transport-forked: True X-Microsoft-Antispam-PRVS: x-checkrecipientrouted: true nodisclaimer: true x-ms-oob-tlc-oobclassifiers: OLM:7219;OLM:7219; X-MS-Exchange-SenderADCheck: 1 X-Microsoft-Antispam-Untrusted: BCL:0; X-Microsoft-Antispam-Message-Info-Original: sR9OUs2Z3QXTNC2pGqAwYkNSUcgUsccs3df7Fbwm9p4EAOuaH2CVXND4mUe432t+jimI+swUR3BYrv8qNuO8senrhSzUOGKdx2P+tUgGO/d8jU0pNxQPO9FsucYILp32/HBc0ymkB4c89OaQloPxZFbO5YoTgE+te4Vy3P2kK1mundQs8+jXO0X0WRUjQO5MtC0Q7niuJL9RPgSlirLy07T+ICZOwm7UveleIUEOSkNf2J77L1UQMClCgwIhsmdUhCPB5A0TWqmX/i++Og0PWTYGy6yXMixwan3ZoAfUJD5/VG2+8ZgVigVCu+s4/BSQxFC8AtdEYTrpBpSkso6LLaU1bau7JfCTDd7q/E+xooDqbkncXvaHtP3AYBNfcdUSuwXQpVW0PNgencBWAABlHA== X-Forefront-Antispam-Report-Untrusted: CIP:255.255.255.255; CTRY:; LANG:en; SCL:1; SRV:; IPV:NLI; SFV:NSPM; H:DBAPR08MB5814.eurprd08.prod.outlook.com; PTR:; CAT:NONE; SFS:(4636009)(346002)(376002)(39860400002)(136003)(396003)(366004)(6636002)(186003)(86362001)(8676002)(4326008)(33656002)(83380400001)(478600001)(6506007)(2906002)(9686003)(15650500001)(71200400001)(7696005)(83080400001)(55016002)(26005)(64756008)(316002)(54906003)(52536014)(66446008)(76116006)(110136005)(66946007)(5660300002)(8936002)(66476007)(66556008); DIR:OUT; SFP:1101; x-ms-exchange-antispam-messagedata: nG4o23aUu1k7J05bfIL+z+BBk7gqFp8HDE59Mn2ZWF+rVE1rFmj6lY7pJEbPDFrhiH0XymBe7nY8hvWNbrjv1Xp9jaF1dJNT/RSUeautm0pRBWkCDF0AuWIRp0t6KhpULA7LKwHFjdH1R0THg101ML8PqPyC4GwEjKlCWv7bda5Ub0ncBIdaNbcOQtVv15kEpuPbwiDAzgTzXagfCTnZ6URLgjfZCYai1HtbCkSBc5AzntLBPsOnJODnDOio3YqDsg9LLuvv4axXnZuzukh6q3pJtHqddfurCOofVR1cETtV3CVnMRcDd6iqiTArg8dIrjwCIZf/plGTKwaZep/6BmkuPEZQk4jnVa7dXFcckl+dLX3spHy5A+hKAcGynKDvQLAb+H3VDsJ5MZ51AR8+NGyJBqSYZy+1/VB2R/KdhVQEMCdNV8WoU3dTJfcay3+oVMd2ld6Sz5xr/V8SVb1XPlOp6FAODMddb6Dp9uVpTjtPiP/83McK75qybYnJYu5KMETEL55gQOS6/4VGqvO75Zufa3hHnHM7UBqfS55LlqYBJvpztPlcaVPcO3x60E0PH3KBO2feS2DhWiRGzPxoFMNJ+9Vxw/Unlpcg4iO3vnG1cJuypuYQYSkKkJq4sfIkbVR6HRT/7IWD0qIB0Um7TQ== Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: quoted-printable MIME-Version: 1.0 X-MS-Exchange-Transport-CrossTenantHeadersStamped: DB7PR08MB3084 Original-Authentication-Results: arm.com; dkim=none (message not signed) header.d=none;arm.com; dmarc=none action=none header.from=arm.com; X-EOPAttributedMessage: 0 X-MS-Exchange-Transport-CrossTenantHeadersStripped: VE1EUR03FT013.eop-EUR03.prod.protection.outlook.com X-MS-Office365-Filtering-Correlation-Id-Prvs: 670c486b-b9da-4f92-d9f0-08d8704ae0f6 X-Microsoft-Antispam: BCL:0; X-Microsoft-Antispam-Message-Info: hwWl8Y1hKS7RFAykFzsQV2KgiWJfkTTK2MzxggYj6sLtYPHGPJCJcGGRpKqUMCqStp8yCbJcEDvVhqwEaqjCX2R/sdBFeiD8PJglaz5ZxvtOQnYR5ng5lQ6hm08ysi2yfXahv89iWX7whtw6r69U3+dPYuwLwh+uwDU6D3r/9FU8E0n6hjBCwYwHHkPG83EcDUXtRIf4G2JdR3mpYF3SRY7mIW6NcLHazWDtSp6b8TzJFxPOrx0xQGZeaU+3+dZDP7dhGVgSBkR6JPH2wwcxef0SF5hWqXmnGvqbBuXqaILROEz/zx9vd5FPklIn/yx3OfHzm6KyUjwHp24TXnquS4PVEs1kSAStDt1H/vQ8Lb8XtjbSvzJudDLv7ml2d7fC1IqKKbR+o0ruVvwjL6eu3iP+QKQ5hV841tMkMLVXumNQl70hIfq7Sfm+X72qhA3uxcm1NYLLDjSbydULjPA0xJQoZzniDznEFWhnNGgLWX4= X-Forefront-Antispam-Report: CIP:63.35.35.123; CTRY:IE; LANG:en; SCL:1; SRV:; IPV:CAL; SFV:NSPM; H:64aa7808-outbound-1.mta.getcheckrecipient.com; PTR:ec2-63-35-35-123.eu-west-1.compute.amazonaws.com; CAT:NONE; SFS:(4636009)(346002)(396003)(39860400002)(376002)(136003)(46966005)(478600001)(8936002)(5660300002)(70586007)(54906003)(6636002)(83380400001)(110136005)(86362001)(2906002)(316002)(336012)(356005)(15650500001)(82310400003)(8676002)(70206006)(6506007)(9686003)(55016002)(186003)(7696005)(52536014)(83080400001)(81166007)(47076004)(82740400003)(26005)(4326008)(33656002); DIR:OUT; SFP:1101; X-OriginatorOrg: arm.com X-MS-Exchange-CrossTenant-OriginalArrivalTime: 14 Oct 2020 14:10:25.7485 (UTC) X-MS-Exchange-CrossTenant-Network-Message-Id: 20c9443f-780e-4c5c-d1ef-08d8704ae5d2 X-MS-Exchange-CrossTenant-Id: f34e5979-57d9-4aaa-ad4d-b122a662184d X-MS-Exchange-CrossTenant-OriginalAttributedTenantConnectingIp: TenantId=f34e5979-57d9-4aaa-ad4d-b122a662184d; Ip=[63.35.35.123]; Helo=[64aa7808-outbound-1.mta.getcheckrecipient.com] X-MS-Exchange-CrossTenant-AuthSource: VE1EUR03FT013.eop-EUR03.prod.protection.outlook.com X-MS-Exchange-CrossTenant-AuthAs: Anonymous X-MS-Exchange-CrossTenant-FromEntityHeader: HybridOnPrem X-MS-Exchange-Transport-CrossTenantHeadersStamped: DB7PR08MB3403 Subject: Re: [dpdk-dev] [PATCH] doc: update build guide for armv8 crypto PMD X-BeenThere: dev@dpdk.org X-Mailman-Version: 2.1.15 Precedence: list List-Id: DPDK patches and discussions List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: dev-bounces@dpdk.org Sender: "dev" >=20 > Removed references to Makefile and added guide about building by using > meson. >=20 > Also added the command to create virtual device. >=20 > Suggested-by: Akhil Goyal > Signed-off-by: Ruifeng Wang > --- > doc/guides/cryptodevs/armv8.rst | 20 +++++++++++--------- > 1 file changed, 11 insertions(+), 9 deletions(-) >=20 > diff --git a/doc/guides/cryptodevs/armv8.rst > b/doc/guides/cryptodevs/armv8.rst index fee85354b..d11efe08d 100644 > --- a/doc/guides/cryptodevs/armv8.rst > +++ b/doc/guides/cryptodevs/armv8.rst > @@ -26,22 +26,23 @@ Supported authentication algorithms: > Installation > ------------ >=20 > -In order to enable this virtual crypto PMD, user must: > +To build DPDK with this virtual crypto PMD, the user is required to: >=20 > * Download AArch64 crypto library source code from > - `here `_ > + `here `_. >=20 > -* Export the environmental variable ARMV8_CRYPTO_LIB_PATH with > - the path to ``AArch64cryptolib`` library. > - > -* Build the library by invoking: > +* Build the ``AArch64cryptolib`` library: >=20 > .. code-block:: console >=20 > - make -C $ARMV8_CRYPTO_LIB_PATH/ > + make > + > +* Build DPDK with meson option ``- > Darmv8_crypto_dir=3D``: > + > +.. code-block:: console >=20 > -* Set CONFIG_RTE_LIBRTE_PMD_ARMV8_CRYPTO=3Dy in How is the flag set for Meson? Does it need to be documented here? > - config/defconfig_arm64-armv8a-linux-gcc > + meson -Darmv8_crypto_dir=3D build > + ninja -C build >=20 > The corresponding device can be created only if the following features = are > supported by the CPU: > @@ -53,6 +54,7 @@ are supported by the CPU: >=20 > Initialization > -------------- > +Use ``--vdev "crypto_armv8"`` in the EAL options to create virtual crypt= o > device. >=20 > User can use app/test application to check how to use this PMD and to ve= rify > crypto processing. > -- > 2.17.1