From patchwork Thu Jul 18 22:09:10 2019 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Stephen Hemminger X-Patchwork-Id: 56744 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 0EDC2326C; Fri, 19 Jul 2019 00:09:16 +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 C7CEC2BC7 for ; Fri, 19 Jul 2019 00:09:14 +0200 (CEST) Received: by mail-pg1-f193.google.com with SMTP id f5so4668933pgu.5 for ; Thu, 18 Jul 2019 15:09:14 -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; bh=vBrfdnaeKO/BfHULu4SACnezEx0Qs418xcI/CRBAk3w=; b=iNReX6I4y+SxYeAs8pgsU0yzN8itBrVHNZuFECqZbmEXY4+DOBCoOldB092GPT/dt3 wKBAIgwZ0w0StBJpVnw+i4tRZ+E1jqyvjsNrR0ofZvXRSicFV6/9pVg5F+IWKusV6Uxy WQ4wTmRIjmgd6TSv+pVKwxewWhk7XBcl+RoftJpgm/GfgYVZwDKbM7FwQtDYETJ8y9ou F4yO8mCO/bOgwDfmkn437c/1pXXvIX1jh+pWQxr0mTXWvrxja19I3YkhcNNsAkT7bDd4 +soXot2D76qxmESGk35KRDKX8OYQL8cmJRbWVTfXYT4MNan5ogJBWkJqESUl0005fkUY ix6g== 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; bh=vBrfdnaeKO/BfHULu4SACnezEx0Qs418xcI/CRBAk3w=; b=r4eWrxR9Mk79vNT6SFncXhXJ5PA7Ouab8q1+s8nD/EdIezFX88/GofXlOs674sLYMP mctfNQIdpupBQ3E73j5q7rU9NfI6LFtIbqznsyh7Ed4Js+GgEHhCz/CIHPe2BxneH46t IzZp+nD2SbFYYqQyH7HQI56xP0t9ykHBfxuG7qhrkIQ8JLuCon2a76wSVP/bvr8hzScQ t+HJNlTKoj6C6FMkbrR0SJfPt+HN4HV74b3UfgGLCK/MO4m9D0QgyFFHqldVtarcruAg yRgLIszYwRE4ezXvVZveLbzEpCPvdlX/EoKJPDVdtVLSJGKutqkQvCfmA8wEDAvTLMcd Y02A== X-Gm-Message-State: APjAAAV4Xj7DM6Cj98vFVbGzVTUp8XbzGlE3Kts6Ej3tT/xwG5COa3DR vcwMTAE9ne83SHkC9fOJ2q1iSPq9 X-Google-Smtp-Source: APXvYqzkjK2OgPgcyQQidx+aEJQPELFa4hmKuBUYy69cMwpUQsOzoDH5lMacFC4f344d31Y//uoEHA== X-Received: by 2002:a63:f807:: with SMTP id n7mr51673974pgh.119.1563487753585; Thu, 18 Jul 2019 15:09:13 -0700 (PDT) Received: from localhost.localdomain ([67.23.203.6]) by smtp.gmail.com with ESMTPSA id f15sm13219075pgu.2.2019.07.18.15.09.12 (version=TLS1_3 cipher=AEAD-AES256-GCM-SHA384 bits=256/256); Thu, 18 Jul 2019 15:09:12 -0700 (PDT) From: Stephen Hemminger To: dev@dpdk.org Cc: Stephen Hemminger Date: Thu, 18 Jul 2019 15:09:10 -0700 Message-Id: <20190718220910.8248-1-stephen@networkplumber.org> X-Mailer: git-send-email 2.17.1 In-Reply-To: <20190709150257.GB497@bricha3-MOBL.ger.corp.intel.com> References: <20190709150257.GB497@bricha3-MOBL.ger.corp.intel.com> Subject: [dpdk-dev] [PATCH] 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 --- doc/guides/rel_notes/deprecation.rst | 9 +++++++++ 1 file changed, 9 insertions(+) diff --git a/doc/guides/rel_notes/deprecation.rst b/doc/guides/rel_notes/deprecation.rst index a7796f49b9fe..9c20a47b3e4c 100644 --- a/doc/guides/rel_notes/deprecation.rst +++ b/doc/guides/rel_notes/deprecation.rst @@ -82,3 +82,12 @@ 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 defintions will change attributes. + The Ethernet address struct will no longer be marked as packed since + since the packed attribute is meaningless on a byte array. + The Etherne header will be marked as aligned on a 2 byte boundary (and + no longer packed). This allows for efficient access on all CPU's. + These changes should not impact normal usage drivers naturally + align the Ethernet header on receive, and almost every encapsulation + preserves the alignment.