From patchwork Fri Jul 19 16:56:31 2019 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Stephen Hemminger X-Patchwork-Id: 56797 X-Patchwork-Delegate: thomas@monjalon.net Return-Path: X-Original-To: patchwork@dpdk.org Delivered-To: patchwork@dpdk.org Received: from [92.243.14.124] (localhost [127.0.0.1]) by dpdk.org (Postfix) with ESMTP id CFFE55B3E; Fri, 19 Jul 2019 18:56:40 +0200 (CEST) Received: from mail-pg1-f193.google.com (mail-pg1-f193.google.com [209.85.215.193]) by dpdk.org (Postfix) with ESMTP id A416EA3 for ; Fri, 19 Jul 2019 18:56:39 +0200 (CEST) Received: by mail-pg1-f193.google.com with SMTP id x15so4378563pgg.8 for ; Fri, 19 Jul 2019 09:56:39 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=networkplumber-org.20150623.gappssmtp.com; s=20150623; h=from:to:cc:subject:date:message-id:in-reply-to:references :mime-version:content-transfer-encoding; bh=FCVug+nHrfiESS3pEEiid6B7VTjfUj0rEEbEEe79TW8=; b=G74bn1gChD5TujhPLhEqHrQDOWiF3JG2v7B5ZHa8gRcJJNsDL0hQQn6VKNw56aYKKN 5p/Lrgw7xyvmk2xcEi7hbntxxs8IxTQ6hZO1YPcgMEbUOuYdE2VHDgQCbJiXzo2tI97p FxcK9JVEHyCmpyUF0oxNRNP7eQNgJGopoY3r2pI8OY6LqHvmu1NBV16oedqKYqHCzp+E bxq+aPEMh1gk5Zyc4xzNQq7p3fKpF8pmeQ3ubIQuBQyVi9MfKSNHD92C6F3KY4H2beio XcqlGNB+Qa1k1QYbr/A6CmJR7Y3w4ETidYo/LKSFPpMlTS+sFLnGcVVlHh/2mK6194VE QRdA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:from:to:cc:subject:date:message-id:in-reply-to :references:mime-version:content-transfer-encoding; bh=FCVug+nHrfiESS3pEEiid6B7VTjfUj0rEEbEEe79TW8=; b=lTCdS9rvKipbSzp9xSWxDbQ3Mmx222EFMegLapy/9t/WCgQkkdYpl5IgKs4ysMO5Ck IdOG+5fobUA3ZaCFtJbH7OnLGSMci9/CZzNXYlB/o/hT4fwxjSqxCUhxlObVu2MPVq63 JlxLYxwqFnfpsKLMA6XQX+OpC/q08vCiXNlQl+3WP+XPOr8OmDjf6Nzfk27hfQORmAdJ RGZNCkuoow14aEylm45+82Gm2FVY0a1h1bIRW1HcNOU1ym1xLPb5sYZIFIeEX+aXOx9y ffMXe+oivUgVWQcQKASIcEaPyqX51I+DX9r007c6BCcwU5RPXZk8TJRRymfTiNyHPWFb j4Yg== X-Gm-Message-State: APjAAAUrMnj15vNPb1JpF7P6vv4ueKcIJiwUrcyBI/jMyxNGDhd5nmhG 4AqKcjMEPueaSMgcl8Q9m572wQRK X-Google-Smtp-Source: APXvYqxoHg+zwdPJ7g5BLzkHDWpv9/7ZHufXn0CR6YPSwJv8nh/LT7b65hXjiJg8LV+a0LS8eu+dMw== X-Received: by 2002:a17:90a:22aa:: with SMTP id s39mr58580883pjc.39.1563555398601; Fri, 19 Jul 2019 09:56:38 -0700 (PDT) Received: from hermes.lan (204-195-22-127.wavecable.com. [204.195.22.127]) by smtp.gmail.com with ESMTPSA id f19sm42012533pfk.180.2019.07.19.09.56.37 (version=TLS1_3 cipher=AEAD-AES256-GCM-SHA384 bits=256/256); Fri, 19 Jul 2019 09:56:37 -0700 (PDT) From: Stephen Hemminger To: dev@dpdk.org Cc: Stephen Hemminger , Bruce Richardson Date: Fri, 19 Jul 2019 09:56:31 -0700 Message-Id: <20190719165631.9235-1-stephen@networkplumber.org> X-Mailer: git-send-email 2.20.1 In-Reply-To: <20190709150257.GB497@bricha3-MOBL.ger.corp.intel.com> References: <20190709150257.GB497@bricha3-MOBL.ger.corp.intel.com> MIME-Version: 1.0 Subject: [dpdk-dev] [PATCH v2] doc: add deprecation notice about changes to ethernet structures 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" Tell users about upcoming changes to rte_ether_addr and rte_ether_header. Signed-off-by: Stephen Hemminger Acked-by: Bruce Richardson Acked-by: Andrew Rybchenko Acked-by: Ferruh Yigit Acked-by: Thomas Monjalon --- v2 - reword and fix spelling doc/guides/rel_notes/deprecation.rst | 10 ++++++++++ 1 file changed, 10 insertions(+) diff --git a/doc/guides/rel_notes/deprecation.rst b/doc/guides/rel_notes/deprecation.rst index a7796f49b9fe..307f831cee60 100644 --- a/doc/guides/rel_notes/deprecation.rst +++ b/doc/guides/rel_notes/deprecation.rst @@ -82,3 +82,13 @@ Deprecation Notices to set new power environment if power environment was already initialized. In this case the function will return -1 unless the environment is unset first (using ``rte_power_unset_env``). Other function usage scenarios will not change. + +* net: the Ethernet address and header definitions will change + attributes. The Ethernet address struct will no longer be marked as + packed since the packed attribute is meaningless on a byte + array. The Ethernet header will be marked as aligned on a 2-byte + boundary and will no longer have the packed attribute. This allows + for efficient access on CPU architectures where unaligned access is + expensive. These changes should not impact normal usage because drivers + naturally align the Ethernet header on receive and all known + encapsulations preserve the alignment of the header.