From patchwork Fri Apr 19 19:53:10 2024 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Andrew Boyer X-Patchwork-Id: 139557 X-Patchwork-Delegate: gakhil@marvell.com Return-Path: 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]) by inbox.dpdk.org (Postfix) with ESMTP id 0537C43EB5; Fri, 19 Apr 2024 21:54:27 +0200 (CEST) Received: from mails.dpdk.org (localhost [127.0.0.1]) by mails.dpdk.org (Postfix) with ESMTP id 13F5F40DFD; Fri, 19 Apr 2024 21:53:59 +0200 (CEST) Received: from NAM10-BN7-obe.outbound.protection.outlook.com (mail-bn7nam10on2070.outbound.protection.outlook.com [40.107.92.70]) by mails.dpdk.org (Postfix) with ESMTP id 9E4DE40DCD for ; Fri, 19 Apr 2024 21:53:57 +0200 (CEST) ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=Fd3JoH+vpZIXTwQOEOoqkphroJ2iiEsy6XSLZzNbkr4KfN9E/VJiCIhHSwCESkhA04ApRWHItpikoR3GtWjWEc0/TurlL3NMGv2pmfpDNcXLstl2kqmyKpzskNk/N6Tz1IvLp8Hotl5LNX0Nq6gHCSEhRjO2GlSN7imFjet7fNv8RFatMuOd4kAmdowitrKHLkPnbUOz0BD0wcTTgVhr42IW6RZMSUMQCcNfyLsLxYplkN+PbJy13IVwYbfGIvZVRP2pfLwbjWwwI92aSa0mMYQpd633KD7hwK2hHBWZiGuCcAlRFox8nfcvl7uRz7phuIloUjJ+AWnfsoMrWt2LnQ== 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=NqDPYpUJqFz70nyQHGIsrG9urSMPbgvvjWs+v/iEUTo=; b=ZnCataMpiAeERqPYNhcrA4yaPfAbmj/If4xm1P+vdL6ZzmfmyebaUTUwhaZOyHnG9EIcwo8I61lkZL2QpjXdzyXPECc5ZaxVEs7MMMp1W0xV0yIG4a+K/X95x3BX4/+4y7C08gXPm3Te09OvwTMUukg+H2BXVkHkXHPDoi+htklbzka10Vy9wS2k2TOeu0pM6JJ2CpahYeHE/Rh449hPE+uCJnZH6DhiTRb0y+cCrUYqz4m+Q5OV4WKLManUaG8Aru5eWcYJZU11hG/HPM8VLXiGG83LvVfP0rPsdE2WY43uxko3I3AM630HCtR9pr6UtctoM10sm1I/MkF6awiE9A== ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass (sender ip is 165.204.84.17) smtp.rcpttodomain=dpdk.org smtp.mailfrom=amd.com; dmarc=pass (p=quarantine sp=quarantine pct=100) action=none header.from=amd.com; dkim=none (message not signed); arc=none (0) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=amd.com; s=selector1; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=NqDPYpUJqFz70nyQHGIsrG9urSMPbgvvjWs+v/iEUTo=; b=xaEWWpbIMnKe6xIZn4OTu7bYQfVzqR7Xyg7B2RtKy6OB38loL3yEC725NN5Std9YEYdIrJqYjUskxnpirAMJqU0gQHzFtVSvDiro974ejeYK8QeHrn7D50aB0CrV+6dHkc2/u4z5YlqIh4MKFXsIs0ozlBVldarY3x3owTih+yw= Received: from SA0PR11CA0066.namprd11.prod.outlook.com (2603:10b6:806:d2::11) by BY1PR12MB8447.namprd12.prod.outlook.com (2603:10b6:a03:525::13) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.7472.37; Fri, 19 Apr 2024 19:53:55 +0000 Received: from SA2PEPF00001504.namprd04.prod.outlook.com (2603:10b6:806:d2:cafe::60) by SA0PR11CA0066.outlook.office365.com (2603:10b6:806:d2::11) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.7495.31 via Frontend Transport; Fri, 19 Apr 2024 19:53:55 +0000 X-MS-Exchange-Authentication-Results: spf=pass (sender IP is 165.204.84.17) smtp.mailfrom=amd.com; dkim=none (message not signed) header.d=none;dmarc=pass action=none header.from=amd.com; Received-SPF: Pass (protection.outlook.com: domain of amd.com designates 165.204.84.17 as permitted sender) receiver=protection.outlook.com; client-ip=165.204.84.17; helo=SATLEXMB04.amd.com; pr=C Received: from SATLEXMB04.amd.com (165.204.84.17) by SA2PEPF00001504.mail.protection.outlook.com (10.167.242.36) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256) id 15.20.7452.22 via Frontend Transport; Fri, 19 Apr 2024 19:53:55 +0000 Received: from driver-dev1.pensando.io (10.180.168.240) by SATLEXMB04.amd.com (10.181.40.145) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256) id 15.1.2507.35; Fri, 19 Apr 2024 14:53:54 -0500 From: Andrew Boyer To: CC: Akhil Goyal , Andrew Boyer Subject: [PATCH 6/6] crypto/ionic: add documentation and connect to build Date: Fri, 19 Apr 2024 12:53:10 -0700 Message-ID: <20240419195310.21432-7-andrew.boyer@amd.com> X-Mailer: git-send-email 2.17.1 In-Reply-To: <20240419195310.21432-1-andrew.boyer@amd.com> References: <20240419195310.21432-1-andrew.boyer@amd.com> MIME-Version: 1.0 X-Originating-IP: [10.180.168.240] X-ClientProxiedBy: SATLEXMB04.amd.com (10.181.40.145) To SATLEXMB04.amd.com (10.181.40.145) X-EOPAttributedMessage: 0 X-MS-PublicTrafficType: Email X-MS-TrafficTypeDiagnostic: SA2PEPF00001504:EE_|BY1PR12MB8447:EE_ X-MS-Office365-Filtering-Correlation-Id: c7492c5f-22de-4f1b-85d5-08dc60aa71fa X-MS-Exchange-SenderADCheck: 1 X-MS-Exchange-AntiSpam-Relay: 0 X-Microsoft-Antispam: BCL:0; X-Microsoft-Antispam-Message-Info: wMnLDZTOwHZNoWvIJvkzomcvAKIw0jk2QOWJTJ+zYcssr3ctTWt1jFWmkSLsReq+0qjNGEWbQF0uMsLB3zhGtx7Kh/XEwhhYWTrWjoaQFluRnUJ2pEk6a5yrlltSDDlyQua1S9MCINaQTdFVKf3lBvdFTyZyDzLG0lyiRpLNbwxf4D+hu0fx3EpKkiov5wimrXJFxDocpRox8mcTdqIlo5n6iEt2eb/HfnKPVcGOsjF3cXgzgrbWwjAxFlTuNiJRZTzZH7vLIubCfyEXDvURwxP3e2WiUwPUlduV+5ZObg4b8Y8ugqiIUaFdGD1pn2LqiKhzNCM7LIXot5S/Dab4mJHnF2mzXEQP9/gQsHUSetH1r+5cn5qwQbj5kXiHGKvRJphgHVcOIlF3vxhjLweXV+Ghwjxo64ZNsQlW9NQp/98Vqep0SZ3/2h2i9PLcZhYOkkHgK6u4ZuQ2/qQnWMGP06QNlXB+qy103gGpTLFeEZlN6MZN+L7xcLeTC9CuSW294axx86bCFBySl2HkJLglIJVFWFqNzraRlVeAe9ZbHOAQJAbYMieI/F/2PPKAP8Q0IH7ikUALE82yBkCztkboU7NExAT44UMrqsWrQR+8Q83m9g9rn2ac1SvPAe2hVDFfXIwutsrQyqfw0S8QLTFnmPElsQ3OCsBfE7WK+/IUEUK9RN+AB6QeW+Ud0XUYpDgzmujD3otM8Mcw16zyM6rudMWoyMownWx+OVTtM1rqyQjU8+sttzp5O6TfMI/UQZ5FcnqaLK+oAi38ySnHKCp2hwbmUOJxB0zCVtypAPkXaLVelgNAOPuV7+GIGnHxEjJlli4Ttc2Zx3sRw4zipUw95K5pTkmeF6ZbNGhqmL4TI74gz22sNZNwFDMXMV409qhaIIP7hn6NxkybCD5Ko0qeZVHcNfO/SgQUyJCt7WcZXX/DLh0s2m/zrjyeA9vihk7s8lpr2pTZYtecUQ9oarendElCuKPVlJppeAgZqEG4FqW3F8laCMMkeQ+Ki27T3BovWtWjU4gRA3RA67R65q3ywju5vt5lGXLkczgqJLg2Bn8jwMqv1+ofefLjAvTZe/rltmVgTJmbUbHbFyIU+B10510JUtOnckoby8N07TVDBq1taDkL8yZQA0HBkjR79tIsPJ77OLXf44sBiWJ8IxJOJUvcUHk6Jru8j4ptLSgK/1IIkVv85vcohirKc7zCyHUuQhsF/5x0QUsSm8juirC8KRToRGDAtJFaTTpKswOrf4l/xl1HxWv6o/gA8zdDfRxzPs61Qo9XnfCv1deaJGVar5WqY5u/Zu0o/DQME1JGyjFmeruelnR9yTs1pkB9NUFoqOc7ZyOifq2TIX+uRiKql05qiCBbwaoj+mCoUK/kGoKCaRzwatQmFQsYZF/h8PXH X-Forefront-Antispam-Report: CIP:165.204.84.17; CTRY:US; LANG:en; SCL:1; SRV:; IPV:CAL; SFV:NSPM; H:SATLEXMB04.amd.com; PTR:InfoDomainNonexistent; CAT:NONE; SFS:(13230031)(36860700004)(82310400014)(1800799015)(376005); DIR:OUT; SFP:1101; X-OriginatorOrg: amd.com X-MS-Exchange-CrossTenant-OriginalArrivalTime: 19 Apr 2024 19:53:55.2093 (UTC) X-MS-Exchange-CrossTenant-Network-Message-Id: c7492c5f-22de-4f1b-85d5-08dc60aa71fa X-MS-Exchange-CrossTenant-Id: 3dd8961f-e488-4e60-8e11-a82d994e183d X-MS-Exchange-CrossTenant-OriginalAttributedTenantConnectingIp: TenantId=3dd8961f-e488-4e60-8e11-a82d994e183d; Ip=[165.204.84.17]; Helo=[SATLEXMB04.amd.com] X-MS-Exchange-CrossTenant-AuthSource: SA2PEPF00001504.namprd04.prod.outlook.com X-MS-Exchange-CrossTenant-AuthAs: Anonymous X-MS-Exchange-CrossTenant-FromEntityHeader: HybridOnPrem X-MS-Exchange-Transport-CrossTenantHeadersStamped: BY1PR12MB8447 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 Add a features list and guide for the ionic crypto PMD. Hook the new PMD up to the build. Signed-off-by: Andrew Boyer --- MAINTAINERS | 7 +++++ doc/guides/cryptodevs/features/ionic.ini | 40 ++++++++++++++++++++++++ doc/guides/cryptodevs/index.rst | 1 + doc/guides/cryptodevs/ionic.rst | 39 +++++++++++++++++++++++ drivers/crypto/meson.build | 1 + 5 files changed, 88 insertions(+) create mode 100644 doc/guides/cryptodevs/features/ionic.ini create mode 100644 doc/guides/cryptodevs/ionic.rst diff --git a/MAINTAINERS b/MAINTAINERS index 7abb3aee49..7cf999371c 100644 --- a/MAINTAINERS +++ b/MAINTAINERS @@ -1075,6 +1075,13 @@ F: drivers/crypto/ccp/ F: doc/guides/cryptodevs/ccp.rst F: doc/guides/cryptodevs/features/ccp.ini +AMD Pensando ionic crypto +M: Andrew Boyer +F: drivers/crypto/ionic/ +F: drivers/common/ionic/ +F: doc/guides/cryptodevs/ionic.rst +F: doc/guides/cryptodevs/features/ionic.ini + ARMv8 Crypto M: Ruifeng Wang F: drivers/crypto/armv8/ diff --git a/doc/guides/cryptodevs/features/ionic.ini b/doc/guides/cryptodevs/features/ionic.ini new file mode 100644 index 0000000000..d3e00bd795 --- /dev/null +++ b/doc/guides/cryptodevs/features/ionic.ini @@ -0,0 +1,40 @@ +; +; Supported features of the 'ionic' crypto driver. +; +; Refer to default.ini for the full list of available PMD features. +; +[Features] +Symmetric crypto = Y +HW Accelerated = Y +In Place SGL = Y +OOP SGL In LB Out = Y +OOP SGL In SGL Out = Y +OOP LB In LB Out = Y + +; +; Supported crypto algorithms of 'ionic' crypto driver. +; +[Cipher] + +; +; Supported authentication algorithms of 'ionic' crypto driver. +; +[Auth] + +; +; Supported AEAD algorithms of 'ionic' crypto driver. +; +[AEAD] +AES GCM (128) = Y +AES GCM (256) = Y + +; +; Supported Asymmetric algorithms of the 'ionic' crypto driver. +; +[Asymmetric] + +; +; Supported Operating systems of the 'ionic' crypto driver. +; +[OS] +Linux = Y diff --git a/doc/guides/cryptodevs/index.rst b/doc/guides/cryptodevs/index.rst index cb4ce227e9..1e57a9fe86 100644 --- a/doc/guides/cryptodevs/index.rst +++ b/doc/guides/cryptodevs/index.rst @@ -20,6 +20,7 @@ Crypto Device Drivers cnxk dpaa2_sec dpaa_sec + ionic kasumi octeontx openssl diff --git a/doc/guides/cryptodevs/ionic.rst b/doc/guides/cryptodevs/ionic.rst new file mode 100644 index 0000000000..9d557f7cc2 --- /dev/null +++ b/doc/guides/cryptodevs/ionic.rst @@ -0,0 +1,39 @@ +.. SPDX-License-Identifier: BSD-3-Clause + Copyright 2021-2024 Advanced Micro Devices, Inc. + +IONIC Crypto Driver +=================== + +The ionic crypto driver provides support for offloading cryptographic operations +to hardware cryptographic blocks on AMD Pensando server adapters. +It currently supports the below models: + +- DSC-25 dual-port 25G Distributed Services Card `(pdf) `__ +- DSC-100 dual-port 100G Distributed Services Card `(pdf) `__ +- DSC-200 dual-port 200G Distributed Services Card `(pdf) `__ + +Please visit the AMD Pensando web site at https://www.amd.com/en/accelerators/pensando for more information. + +Device Support +-------------- + +The ionic crypto PMD currently supports running directly on the device's embedded +processors. It does not yet support host-side access via PCI. +For help running the PMD, please contact AMD Pensando support. + +Runtime Configuration +--------------------- + +None + +Features +-------- + +The ionic crypto PMD has support for: + +Symmetric Crypto Algorithms +~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +AEAD algorithms: + +* ``RTE_CRYPTO_AEAD_AES_GCM`` diff --git a/drivers/crypto/meson.build b/drivers/crypto/meson.build index ee5377deff..e799861bb6 100644 --- a/drivers/crypto/meson.build +++ b/drivers/crypto/meson.build @@ -10,6 +10,7 @@ drivers = [ 'cnxk', 'dpaa_sec', 'dpaa2_sec', + 'ionic', 'ipsec_mb', 'mlx5', 'mvsam',