Introduce MACsec offload SKB extension
Subsystems (3)
v2 cover Introduce MACsec offload SKB extension
This patchset introduces MACsec SKB extension to lay the ground for MACsec HW offload.
MACsec is an IEEE standard (IEEE 802.1AE) for MAC security. It defines a way to establish a protocol independent connection between two hosts with data confidentiality, authenticity and/or integrity, using GCM-AES. MACsec operates on the Ethernet layer and as such is a layer 2 protocol, which means it’s designed to secure traffic within a layer 2 network, including DHCP or ARP requests.
Linux has a software implementation of the MACsec standard and HW offloading support.
The offloading is re-using the logic, netlink API and data structures of the existing MACsec software implementation.
For Tx:
In the current MACsec offload implementation, MACsec interfaces are sharing the same MAC address of their parent interface by default. Therefore, HW can't distinguish if a packet was sent from MACsec interface and need to be offloaded or not.
Also, it can't distinguish from which MACsec interface it was sent in case there are multiple MACsec interface with the same MAC address.
Used SKB extension, so SW can mark if a packet is needed to be offloaded and use the SCI, which is unique value for each MACsec interface, to notify the HW from which MACsec interface the packet is sent.
For Rx:
Like in the Tx changes, packet that don't have SecTAG
header aren't necessary been offloaded by the HW.
Therefore, the MACsec driver needs to distinguish if the packet was offloaded or not and handle accordingly.
Moreover, if there are more than one MACsec device with the same MAC address as in the packet's destination MAC, the packet will forward only to this device and only to the desired one.
Used SKB extension and marking it by the HW if the packet was offloaded and to which MACsec offload device it belongs according to the packet's SCI.
1) patch 0001-0002, Add support to SKB extension in MACsec code:
net/macsec: Add MACsec skb extension Tx Data path support net/macsec: Add MACsec skb extension Rx Data path support
2) patch 0003, Move some MACsec driver code for sharing with various drivers that implements offload:
net/macsec: Move some code for sharing with various drivers that implements offload
Follow-up patchset for Nvidia MACsec HW offload will be submitted later on.
drivers/net/Kconfig | 1 + drivers/net/macsec.c | 45 ++++++++++++++++-------------------------- include/linux/skbuff.h | 3 +++ include/net/macsec.h | 27 +++++++++++++++++++++++++ net/core/gro.c | 16 +++++++++++++++ net/core/skbuff.c | 7 +++++++ 6 files changed, 71 insertions(+), 28 deletions(-)
Signature · 1 line
2.25.4
PATCH v2 1/3 net/macsec: Add MACsec skb extension Tx Data path support
In the current MACsec offload implementation, MACsec interfaces are sharing the same MAC address of their parent interface by default. Therefore, HW can't distinguish if a packet was sent from MACsec interface and need to be offloaded or not.
Also, it can't distinguish from which MACsec interface it was sent in case there are multiple MACsec interface with the same MAC address.
Used SKB extension, so SW can mark if a packet is needed to be offloaded and use the SCI, which is unique value for each MACsec interface, to notify the HW from which MACsec interface the packet is sent.
Issue: 2978949
---v1->v2:
- removed offloaded field from struct macsec_ext
--- drivers/net/Kconfig | 1 + drivers/net/macsec.c | 4 ++++ include/linux/skbuff.h | 3 +++ include/net/macsec.h | 5 +++++ net/core/skbuff.c | 7 +++++++ 5 files changed, 20 insertions(+)
drivers/net/Kconfig +1 -0
@@ -313,6 +313,7 @@ config MACSEC select CRYPTO_AES select CRYPTO_GCM select GRO_CELLS + select SKB_EXTENSIONS help MACsec is an encryption standard for Ethernet.
drivers/net/macsec.c +4 -0
@@ -3379,6 +3379,10 @@ static netdev_tx_t macsec_start_xmit(struct sk_buff *skb,int ret, len;if (macsec_is_offloaded (netdev_priv (dev))) { +struct macsec_ext *secext =skb_ext_add (skb,SKB_EXT_MACSEC ); + + secext->sci = secy->sci; + skb->dev = macsec->real_dev;return dev_queue_xmit (skb); }
include/linux/skbuff.h +3 -0
@@ -4495,6 +4495,9 @@ enum skb_ext_id {#endif #if IS_ENABLED (CONFIG_MCTP_FLOWS ) SKB_EXT_MCTP, +#endif +#if IS_ENABLED (CONFIG_MACSEC ) +SKB_EXT_MACSEC , #endif SKB_EXT_NUM, /* must be last */ };
include/net/macsec.h +5 -0
@@ -20,6 +20,11 @@typedef u64 __bitwise sci_t ;typedef u32 __bitwise ssci_t ; +/* MACsec sk_buff extension data */ +struct macsec_ext { +sci_t sci; +}; + typedef union salt { struct { u32 ssci;
net/core/skbuff.c +7 -0
@@ -72,6 +72,7 @@#include <net/mptcp.h> #include <net/mctp.h> #include <net/page_pool.h> +#include <net/macsec.h> #include <linux/uaccess.h> #include <trace/events/skb.h>
@@ -4346,6 +4347,9 @@ static const u8 skb_ext_type_len[] = {#if IS_ENABLED (CONFIG_MCTP_FLOWS ) [SKB_EXT_MCTP] = SKB_EXT_CHUNKSIZEOF(struct mctp_flow), #endif +#if IS_ENABLED(CONFIG_MACSEC) + [SKB_EXT_MACSEC] = SKB_EXT_CHUNKSIZEOF(struct macsec_ext), +#endif }; static __always_inline unsigned int skb_ext_total_length(void)
@@ -4365,6 +4369,9 @@ static __always_inline unsigned int skb_ext_total_length(void)#endif #if IS_ENABLED (CONFIG_MCTP_FLOWS ) skb_ext_type_len[SKB_EXT_MCTP] + +#endif +#if IS_ENABLED (CONFIG_MACSEC ) + skb_ext_type_len[SKB_EXT_MACSEC] +#endif 0 ; }
Signature · 1 line
2.25.4
PATCH v2 2/3 net/macsec: Add MACsec skb extension Rx Data path support
In reply to Lior NahmansonLike in the Tx changes, packet that don't have SecTAG
header aren't necessary been offloaded by the HW.
Therefore, the MACsec driver needs to distinguish if the packet was offloaded or not and handle accordingly.
Moreover, if there are more than one MACsec device with the same MAC address as in the packet's destination MAC, the packet will forward only to this device and only to the desired one.
Used SKB extension and marking it by the HW if the packet was offloaded and to which MACsec offload device it belongs according to the packet's SCI.
Issue: 2978949
---v1->v2:
- added GRO support
- added offloaded field to struct macsec_ext
--- drivers/net/macsec.c | 8 +++++++- include/net/macsec.h | 1 + net/core/gro.c | 16 ++++++++++++++++ 3 files changed, 24 insertions(+), 1 deletion(-)
drivers/net/macsec.c +7 -1
@@ -999,11 +999,13 @@ static enum rx_handler_result handle_not_macsec(struct sk_buff *skb)/* Deliver to the uncontrolled port by default */ enum rx_handler_result ret =RX_HANDLER_PASS ;struct ethhdr *hdr =eth_hdr (skb); +struct macsec_ext *macsec_ext;struct macsec_rxh_data *rxd;struct macsec_dev *macsec;rcu_read_lock (); rxd =macsec_data_rcu (skb->dev); + macsec_ext =skb_ext_find (skb,SKB_EXT_MACSEC );list_for_each_entry_rcu (macsec, &rxd->secys, secys) {struct sk_buff *nskb;
@@ -1013,7 +1015,11 @@ static enum rx_handler_result handle_not_macsec(struct sk_buff *skb)/* If h/w offloading is enabled, HW decodes frames and strips * the SecTAG, so we have to deduce which port to deliver to. */ -if (macsec_is_offloaded (macsec) &&netif_running (ndev)) { +if (macsec_is_offloaded (macsec) &&netif_running (ndev) && + (!macsec_ext || macsec_ext->offloaded)) { +if ((macsec_ext) && (!find_rx_sc (&macsec->secy, macsec_ext->sci))) +continue ; +if (ether_addr_equal_64bits (hdr->h_dest, ndev->dev_addr)) {/* exact match, divert skb to this port */
include/net/macsec.h +1 -0
@@ -23,6 +23,7 @@ typedef u32 __bitwise ssci_t;/* MACsec sk_buff extension data */ struct macsec_ext {sci_t sci; +bool offloaded; }; typedef union salt {
net/core/gro.c +16 -0
@@ -1,5 +1,6 @@// SPDX-License-Identifier: GPL-2.0-or-later #include <net/gro.h> +#include <net/macsec.h> #include <net/dst_metadata.h> #include <net/busy_poll.h> #include <trace/events/net.h>
@@ -390,6 +391,10 @@ static void gro_list_prepare(const struct list_head *head,struct tc_skb_ext *skb_ext;struct tc_skb_ext *p_ext;#endif +#if IS_ENABLED (CONFIG_SKB_EXTENSIONS ) &&IS_ENABLED (CONFIG_MACSEC ) +struct macsec_ext *macsec_skb_ext; +struct macsec_ext *macsec_p_ext; +#endif diffs |= p->sk != skb->sk; diffs |=skb_metadata_dst_cmp (p, skb);
@@ -402,6 +407,17 @@ static void gro_list_prepare(const struct list_head *head, diffs |= (!!p_ext) ^ (!!skb_ext);if (!diffs &&unlikely (skb_ext)) diffs |= p_ext->chain ^ skb_ext->chain; +#endif +#if IS_ENABLED (CONFIG_SKB_EXTENSIONS ) &&IS_ENABLED (CONFIG_MACSEC ) + macsec_skb_ext =skb_ext_find (skb,SKB_EXT_MACSEC ); + macsec_p_ext =skb_ext_find (p,SKB_EXT_MACSEC ); + + diffs |= (!!macsec_p_ext) ^ (!!macsec_skb_ext); +if (!diffs &&unlikely (macsec_skb_ext)) { + diffs |= (__force unsigned long )macsec_p_ext->sci ^ + (__force unsigned long )macsec_skb_ext->sci; + diffs |= macsec_p_ext->offloaded ^ macsec_skb_ext->offloaded; + }#endif }
Signature · 1 line
2.25.4
PATCH v2 3/3 net/macsec: Move some code for sharing with various drivers that implements offload
In reply to Lior NahmansonSome MACsec infrastructure like defines and functions, which may be useful for other drivers who implemented MACsec offload, aren't accessible since they aren't located in any header file.
Moved those values to MACsec header file will allow those drivers to use them and avoid code duplication.
Issue: 2980522
---v1->v2:
- moved MACSEC_PORT_ES from .c to .h
--- drivers/net/macsec.c | 33 ++++++--------------------------- include/net/macsec.h | 21 +++++++++++++++++++++ 2 files changed, 27 insertions(+), 27 deletions(-)
drivers/net/macsec.c +6 -27
@@ -24,8 +24,6 @@#include <uapi/linux/if_macsec.h> -#define MACSEC_SCI_LEN 8 -/* SecTAG length = macsec_eth_header without the optional SCI */ #define MACSEC_TAG_LEN 6
@@ -46,20 +44,10 @@ struct macsec_eth_header {u8 secure_channel_id[8 ];/* optional */ } __packed; -#define MACSEC_TCI_VERSION 0x80 -#define MACSEC_TCI_ES 0x40/* end station */ -#define MACSEC_TCI_SC 0x20/* SCI present */ -#define MACSEC_TCI_SCB 0x10/* epon */ -#define MACSEC_TCI_E 0x08/* encryption */ -#define MACSEC_TCI_C 0x04/* changed text */ -#define MACSEC_AN_MASK 0x03/* association number */ -#define MACSEC_TCI_CONFID (MACSEC_TCI_E | MACSEC_TCI_C) -/* minimum secure data length deemed "not short", see IEEE 802.1AE-2006 9.7 */ #define MIN_NON_SHORT_LEN 48#define GCM_AES_IV_LEN 12 -#define DEFAULT_ICV_LEN 16#define for_each_rxsc (secy, sc) \ for (sc = rcu_dereference_bh(secy->rx_sc); \
@@ -230,7 +218,6 @@ static struct macsec_cb *macsec_skb_cb(struct sk_buff *skb)return (struct macsec_cb *)skb->cb; } -#define MACSEC_PORT_ES (htons(0x0001))#define MACSEC_PORT_SCB (0x0000)#define MACSEC_UNDEF_SCI ((__force sci_t)0xffffffffffffffffULL)#define MACSEC_UNDEF_SSCI ((__force ssci_t)0xffffffff)
@@ -244,14 +231,6 @@ static struct macsec_cb *macsec_skb_cb(struct sk_buff *skb)#define DEFAULT_ENCRYPT false#define DEFAULT_ENCODING_SA 0 -static bool send_sci (const struct macsec_secy *secy) -{ -const struct macsec_tx_sc *tx_sc = &secy->tx_sc; - -return tx_sc->send_sci || - (secy->n_rx_sc >1 && !tx_sc->end_station && !tx_sc->scb); -} -static sci_t make_sci (const u8 *addr,__be16 port) {sci_t sci;
@@ -316,7 +295,7 @@ static void macsec_fill_sectag(struct macsec_eth_header *h,/* with GCM, C/E clear for !encrypt, both set for encrypt */ if (tx_sc->encrypt) h->tci_an |=MACSEC_TCI_CONFID ; -else if (secy->icv_len !=DEFAULT_ICV_LEN ) +else if (secy->icv_len !=MACSEC_DEFAULT_ICV_LEN ) h->tci_an |=MACSEC_TCI_C ; h->tci_an |= tx_sc->encoding_sa;
@@ -634,7 +613,7 @@ static struct sk_buff *macsec_encrypt(struct sk_buff *skb, unprotected_len = skb->len; eth =eth_hdr (skb); - sci_present =send_sci (secy); + sci_present =macsec_send_sci (secy); hh =skb_push (skb,macsec_extra_len (sci_present));memmove (hh, eth,2 *ETH_ALEN );
@@ -1268,7 +1247,7 @@ static rx_handler_result_t macsec_handle_frame(struct sk_buff **pskb)/* 10.6.1 if the SC is not found */ cbit = !!(hdr->tci_an &MACSEC_TCI_C );if (!cbit) -macsec_finalize_skb (skb,DEFAULT_ICV_LEN , +macsec_finalize_skb (skb,MACSEC_DEFAULT_ICV_LEN ,macsec_extra_len (macsec_skb_cb (skb)->has_sci));list_for_each_entry_rcu (macsec, &rxd->secys, secys) {
@@ -4007,7 +3986,7 @@ static int macsec_newlink(struct net *net, struct net_device *dev, {struct macsec_dev *macsec =macsec_priv (dev);rx_handler_func_t *rx_handler; -u8 icv_len =DEFAULT_ICV_LEN ; +u8 icv_len =MACSEC_DEFAULT_ICV_LEN ;struct net_device *real_dev;int err, mtu;sci_t sci;
@@ -4131,7 +4110,7 @@ static int macsec_validate_attr(struct nlattr *tb[], struct nlattr *data[], struct netlink_ext_ack *extack) {u64 csid =MACSEC_DEFAULT_CIPHER_ID ; -u8 icv_len =DEFAULT_ICV_LEN ; +u8 icv_len =MACSEC_DEFAULT_ICV_LEN ;int flag;bool es, scb, sci;
@@ -4143,7 +4122,7 @@ static int macsec_validate_attr(struct nlattr *tb[], struct nlattr *data[],if (data[IFLA_MACSEC_ICV_LEN ]) { icv_len =nla_get_u8 (data[IFLA_MACSEC_ICV_LEN ]); -if (icv_len !=DEFAULT_ICV_LEN ) { +if (icv_len !=MACSEC_DEFAULT_ICV_LEN ) {char dummy_key[DEFAULT_SAK_LEN ] = {0 };struct crypto_aead *dummy_tfm;
include/net/macsec.h +21 -0
@@ -17,6 +17,20 @@#define MACSEC_SALT_LEN 12#define MACSEC_NUM_AN 4/* 2 bits for the association number */ +#define MACSEC_SCI_LEN 8 +#define MACSEC_PORT_ES (htons(0x0001)) + +#define MACSEC_TCI_VERSION 0x80 +#define MACSEC_TCI_ES 0x40/* end station */ +#define MACSEC_TCI_SC 0x20/* SCI present */ +#define MACSEC_TCI_SCB 0x10/* epon */ +#define MACSEC_TCI_E 0x08/* encryption */ +#define MACSEC_TCI_C 0x04/* changed text */ +#define MACSEC_AN_MASK 0x03/* association number */ +#define MACSEC_TCI_CONFID (MACSEC_TCI_E | MACSEC_TCI_C) + +#define MACSEC_DEFAULT_ICV_LEN 16 +typedef u64 __bitwise sci_t ;typedef u32 __bitwise ssci_t ;
@@ -295,5 +309,12 @@ struct macsec_ops { };void macsec_pn_wrapped (struct macsec_secy *secy,struct macsec_tx_sa *tx_sa); +static inline bool macsec_send_sci (const struct macsec_secy *secy) +{ +const struct macsec_tx_sc *tx_sc = &secy->tx_sc; + +return tx_sc->send_sci || + (secy->n_rx_sc >1 && !tx_sc->end_station && !tx_sc->scb); +}#endif /* _NET_MACSEC_H_ */
Signature · 1 line
2.25.4