From patchwork Wed Sep 28 12:22:51 2022 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Akhil Goyal X-Patchwork-Id: 117048 X-Patchwork-Delegate: thomas@monjalon.net 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 6EFC4A00C4; Wed, 28 Sep 2022 14:23:26 +0200 (CEST) Received: from [217.70.189.124] (localhost [127.0.0.1]) by mails.dpdk.org (Postfix) with ESMTP id 5C76541143; Wed, 28 Sep 2022 14:23:26 +0200 (CEST) Received: from mx0b-0016f401.pphosted.com (mx0b-0016f401.pphosted.com [67.231.156.173]) by mails.dpdk.org (Postfix) with ESMTP id E890241143 for ; Wed, 28 Sep 2022 14:23:24 +0200 (CEST) Received: from pps.filterd (m0045851.ppops.net [127.0.0.1]) by mx0b-0016f401.pphosted.com (8.17.1.5/8.17.1.5) with ESMTP id 28SA52mX027391; Wed, 28 Sep 2022 05:23:22 -0700 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=marvell.com; h=from : to : cc : subject : date : message-id : in-reply-to : references : mime-version : content-transfer-encoding : content-type; s=pfpt0220; bh=cSItdOk2a7V2lUl4y6uSrq+0o7UXaHqU9E/06cIswlc=; b=PpQg149473atL382Z/2nrkPTRvnBPe4tnUE7DW1G2Jv5STk5dmARPR3v157jFhzR5FV3 OmKMBqUNQ8PjvuQFK/lT09U3uMtywugilNREeBNnxFM69pk5HjmyL55Vg5pBpVUtHcDW Ro8jy7NsVNTKKHt9DNMc9+S00Jf9V433Vw2X7kYx9RhNxVIAW5nSTWJk/ODpM/wLCngs Rj/t8Dl5K27yqgaVlL1Ap7AXRCMe+O6+R0b5wzQbHHjCKkcLcagdyolBCXEGZAS0Z3K9 /0BHGON6xdpsX6pLjr9RisZKsvfXjTFNzkyL5WhSk78kppOHKQCtpS+ViW5aqLI7gfU4 NA== Received: from dc5-exch01.marvell.com ([199.233.59.181]) by mx0b-0016f401.pphosted.com (PPS) with ESMTPS id 3jt1dpee0x-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-SHA384 bits=256 verify=NOT); Wed, 28 Sep 2022 05:23:16 -0700 Received: from DC5-EXCH02.marvell.com (10.69.176.39) by DC5-EXCH01.marvell.com (10.69.176.38) with Microsoft SMTP Server (TLS) id 15.0.1497.2; Wed, 28 Sep 2022 05:23:07 -0700 Received: from maili.marvell.com (10.69.176.80) by DC5-EXCH02.marvell.com (10.69.176.39) with Microsoft SMTP Server id 15.0.1497.18 via Frontend Transport; Wed, 28 Sep 2022 05:23:07 -0700 Received: from localhost.localdomain (unknown [10.28.36.102]) by maili.marvell.com (Postfix) with ESMTP id 9062D3F7112; Wed, 28 Sep 2022 05:23:02 -0700 (PDT) From: Akhil Goyal To: CC: , , , , , , , , , , , , , , , Akhil Goyal Subject: [PATCH v2 1/3] net: add MACsec header Date: Wed, 28 Sep 2022 17:52:51 +0530 Message-ID: <20220928122253.23108-2-gakhil@marvell.com> X-Mailer: git-send-email 2.25.1 In-Reply-To: <20220928122253.23108-1-gakhil@marvell.com> References: <20220814184620.512343-1-gakhil@marvell.com> <20220928122253.23108-1-gakhil@marvell.com> MIME-Version: 1.0 X-Proofpoint-ORIG-GUID: _Ltk34UIwVWfn8xPswArfhQopi7Fz9pC X-Proofpoint-GUID: _Ltk34UIwVWfn8xPswArfhQopi7Fz9pC X-Proofpoint-Virus-Version: vendor=baseguard engine=ICAP:2.0.205,Aquarius:18.0.895,Hydra:6.0.528,FMLib:17.11.122.1 definitions=2022-09-28_04,2022-09-28_01,2022-06-22_01 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 Added MACsec protocol header to be used for supporting MACsec protocol offload in hardware or directly in the application. Signed-off-by: Akhil Goyal Acked-by: Olivier Matz Acked-by: Ori Kam --- doc/api/doxy-api-index.md | 3 +- lib/net/meson.build | 1 + lib/net/rte_macsec.h | 61 +++++++++++++++++++++++++++++++++++++++ 3 files changed, 64 insertions(+), 1 deletion(-) create mode 100644 lib/net/rte_macsec.h diff --git a/doc/api/doxy-api-index.md b/doc/api/doxy-api-index.md index 186a258be4..99e49340d3 100644 --- a/doc/api/doxy-api-index.md +++ b/doc/api/doxy-api-index.md @@ -126,7 +126,8 @@ The public API headers are grouped by topics: [Geneve](@ref rte_geneve.h), [eCPRI](@ref rte_ecpri.h), [L2TPv2](@ref rte_l2tpv2.h), - [PPP](@ref rte_ppp.h) + [PPP](@ref rte_ppp.h), + [MACsec](@ref rte_macsec.h) - **QoS**: [metering](@ref rte_meter.h), diff --git a/lib/net/meson.build b/lib/net/meson.build index e899846578..3e63abaca8 100644 --- a/lib/net/meson.build +++ b/lib/net/meson.build @@ -21,6 +21,7 @@ headers = files( 'rte_geneve.h', 'rte_l2tpv2.h', 'rte_ppp.h', + 'rte_macsec.h', ) sources = files( diff --git a/lib/net/rte_macsec.h b/lib/net/rte_macsec.h new file mode 100644 index 0000000000..b391d21ecd --- /dev/null +++ b/lib/net/rte_macsec.h @@ -0,0 +1,61 @@ +/* SPDX-License-Identifier: BSD-3-Clause + * Copyright(C) 2022 Marvell. + */ + +#ifndef _RTE_MACSEC_H_ +#define _RTE_MACSEC_H_ + +/** + * @file + * + * MACsec-related defines + */ + +#include + +#ifdef __cplusplus +extern "C" { +#endif + +#define RTE_MACSEC_TCI_VER_MASK 0x80 /**< Version mask for MACsec. Should be 0. */ +#define RTE_MACSEC_TCI_ES 0x40 /**< Mask for End station(ES) bit - SCI is not valid. */ +#define RTE_MACSEC_TCI_SC 0x20 /**< Mask for SCI present bit. */ +#define RTE_MACSEC_TCI_SCB 0x10 /**< Mask for EPON single copy broadcast bit. */ +#define RTE_MACSEC_TCI_E 0x08 /**< Mask for encrypted user data bit. */ +#define RTE_MACSEC_TCI_C 0x04 /**< Mask for changed user data bit (because of encryption). */ +#define RTE_MACSEC_AN_MASK 0x03 /**< Association number mask in tci_an. */ + +/** + * MACsec Header(SecTAG) + */ +struct rte_macsec_hdr { + /** + * Tag control information and Association number of secure channel. + * Various bits of TCI and AN are masked using RTE_MACSEC_TCI_* and RTE_MACSEC_AN_MASK. + */ + uint8_t tci_an; +#if RTE_BYTE_ORDER == RTE_LITTLE_ENDIAN + uint8_t short_length:6; /**< Short Length. */ + uint8_t unused:2; +#elif RTE_BYTE_ORDER == RTE_BIG_ENDIAN + uint8_t unused:2; + uint8_t short_length:6; /**< Short Length. */ +#endif + rte_be32_t packet_number; /**< Packet number to support replay protection. */ +} __rte_packed; + +/** SCI length in MACsec header if present. */ +#define RTE_MACSEC_SCI_LEN 8 + +/** + * MACsec SCI header(8 bytes) after the MACsec header which is present if SC bit is set in tci_an. + */ +struct rte_macsec_sci_hdr { + uint8_t sci[RTE_MACSEC_SCI_LEN]; /**< Optional secure channel id. */ +} __rte_packed; + +#ifdef __cplusplus +} +#endif + +#endif /* RTE_MACSEC_H_ */