From patchwork Thu Feb 22 18:40:19 2024 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Andrew Boyer X-Patchwork-Id: 137046 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 6754F43B7F; Thu, 22 Feb 2024 19:41:24 +0100 (CET) Received: from mails.dpdk.org (localhost [127.0.0.1]) by mails.dpdk.org (Postfix) with ESMTP id BED63410E6; Thu, 22 Feb 2024 19:40:54 +0100 (CET) Received: from NAM12-MW2-obe.outbound.protection.outlook.com (mail-mw2nam12on2054.outbound.protection.outlook.com [40.107.244.54]) by mails.dpdk.org (Postfix) with ESMTP id 623CF40ECF for ; Thu, 22 Feb 2024 19:40:50 +0100 (CET) ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=HIERSINJA0FGCIYivMQPR1aNwJH5qpXIdxMP6+6QVupg/POWh/mAWldrZ8yjqAxSJ34I3CQVEIekpuZ4Uc0eKTJjfgjMNm7NbCk0YWsTsewi72Qsrl5XgfgK6i/f70+53WTJsvOIWqhRoH9IP8B9eD4WFnoCfqTOtikBuiOGqjcguaqpoeJqaRkGdFh3H/hZUTjxQrSi3agWnZQ6qvU3MJ1k8nIwTTppQBIVGErW6sNDVTQxVO7AK5bZmDDP22doRgq8mee1hXZ22oL0U6VOSiojOMVC3PECUnTtqmXaPSKwq0mRWAru3j02Paj5GB02NJKwFkKvGdinAHSB3bKypg== 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=qLj7nv6i6xSRNGJMKfvX522Z6BS/fLgjGsb/qgCEpYk=; b=dFzu2Xv5svpitJhDkA6YRWJRFR+GnWEaAdNIKx9z+anLK5Ga6FUpPEGBVeHEtHPIh9zL8sVxHWD/TUZTKDmCSlkRrrPjd5BRmnrywI2vNqWqv6AZdTvPshfEfnbnJzzHZcLSCwhi+lCug0g+Kl924SRGWo0e8/zdqcpi5jVfDvqt6mPnDGmF/hlczKEn0Z4mcF+HXDFt31TGHZOJmcwOJywSaYIJl8Dnwp476afxp5HvGCHB7gMIhO8c54XuThh990p5pVtcI4fybVB5N2FGcwvxigNnuvqGdwhkbGbI1Cjikv0DGT1wFW8gEE97Mvy1RSQ5FnHgv/7/9puITDk2tw== 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=qLj7nv6i6xSRNGJMKfvX522Z6BS/fLgjGsb/qgCEpYk=; b=1Ju63NXPvoVSOgNp1BKXqX45O5Xc86Gs+SVwRsc1kjGRCA4Rj/gulXQwRRYe+UisWfguCDXVXQy8bl6d5tl2co3I9xuLe+j696yz7VoMtSK5ZKdjs/zpRFbJdM00v0r5U6du+X5l4aEi6SEbRKoxQWTlOtoZovDGsRyPkNMHMuk= Received: from BN9PR03CA0601.namprd03.prod.outlook.com (2603:10b6:408:106::6) by CH2PR12MB4954.namprd12.prod.outlook.com (2603:10b6:610:63::18) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.7316.24; Thu, 22 Feb 2024 18:40:47 +0000 Received: from BN3PEPF0000B06B.namprd21.prod.outlook.com (2603:10b6:408:106:cafe::b5) by BN9PR03CA0601.outlook.office365.com (2603:10b6:408:106::6) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.7292.42 via Frontend Transport; Thu, 22 Feb 2024 18:40:47 +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 BN3PEPF0000B06B.mail.protection.outlook.com (10.167.243.70) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256) id 15.20.7339.0 via Frontend Transport; Thu, 22 Feb 2024 18:40:47 +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; Thu, 22 Feb 2024 12:40:45 -0600 From: Andrew Boyer To: CC: Akhil Goyal , Andrew Boyer Subject: [RFC 5/5] crypto/ionic: add documentation Date: Thu, 22 Feb 2024 10:40:19 -0800 Message-ID: <20240222184019.15301-6-andrew.boyer@amd.com> X-Mailer: git-send-email 2.17.1 In-Reply-To: <20240222184019.15301-1-andrew.boyer@amd.com> References: <20240222184019.15301-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: BN3PEPF0000B06B:EE_|CH2PR12MB4954:EE_ X-MS-Office365-Filtering-Correlation-Id: b3b03e2e-6cc6-44ea-4c50-08dc33d5c8f3 X-MS-Exchange-SenderADCheck: 1 X-MS-Exchange-AntiSpam-Relay: 0 X-Microsoft-Antispam: BCL:0; X-Microsoft-Antispam-Message-Info: tgrQLVE2BoaLTnfJBnYqRnJRezMGrUVjx+XrpsiUeYSo4zXPir/QJTpOokLjulSjcUT5uqwAlre7gDEaoGW/fKrgEFf4jKjbSeum2bf8s8Uo1kQ6k6wfHyBvVK2iQaSo6zXkCeMHJRspwfYkcC1Xxtd+mnKmD3se1D58pIfBSCdBImt++7siF5frPEB+ConzNekfNig6HByXqW1SSQO2/rrZo3UNto5+6hn+7HoKUkCScz63sT8fbtTRplgav5oPJrew2jxoAVNvP3lTbrmwHXf/YzeK7lu5QImnjRyx7SKu3J9wPhUPIeQ2ImbYp6hupzhxUk5SdcEidhATKWS3wCybipJn700bMyp5QszxT4cp0vz5h5Z2Dj3GFRWYfl0DrxlXU+GH+bBPuKc1KQwXikeE0UfGfxjwYV9sq2kvq8whWC7IQMLLzfk6lsPU3rOdc4utfBx68kXVpc4/QK7yMAqEh6A1xJoqqoBsquT7XAW9fMtGBG8kWsy2i3r345mJj2f8yr8ig7dx9J3zLmFL8MufXxkTLF9FwQT0lYgGTv5s4aU8I0m6AceS2eV69Wblr3ljg82aLJ3I0O0pCFGkJtzbQKm3mriveqle7FMNVEzQRQOJmGBLH2pW63CTjgcs59nnKoDJHzv692vUolHfrw== 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)(46966006)(40470700004); DIR:OUT; SFP:1101; X-OriginatorOrg: amd.com X-MS-Exchange-CrossTenant-OriginalArrivalTime: 22 Feb 2024 18:40:47.0800 (UTC) X-MS-Exchange-CrossTenant-Network-Message-Id: b3b03e2e-6cc6-44ea-4c50-08dc33d5c8f3 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: BN3PEPF0000B06B.namprd21.prod.outlook.com X-MS-Exchange-CrossTenant-AuthAs: Anonymous X-MS-Exchange-CrossTenant-FromEntityHeader: HybridOnPrem X-MS-Exchange-Transport-CrossTenantHeadersStamped: CH2PR12MB4954 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 (basic) guide for the ionic crypto PMD. Signed-off-by: Andrew Boyer --- MAINTAINERS | 7 +++++ doc/guides/cryptodevs/features/ionic.ini | 40 ++++++++++++++++++++++++ doc/guides/cryptodevs/ionic.rst | 39 +++++++++++++++++++++++ 3 files changed, 86 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 4ca34319da..d5453b78c7 100644 --- a/MAINTAINERS +++ b/MAINTAINERS @@ -1067,6 +1067,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/ionic.rst b/doc/guides/cryptodevs/ionic.rst new file mode 100644 index 0000000000..5cf00acdbd --- /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``