From mboxrd@z Thu Jan 1 00:00:00 1970 From: Stephen Hemminger Subject: Re: [PATCH] doc: announce API change for rte_ether.h Date: Fri, 11 Dec 2015 08:33:35 -0800 Message-ID: <20151211083335.38c1478f@xeon-e3> References: <1449790022-24126-1-git-send-email-stephen@networkplumber.org> <566A9750.7070507@redhat.com> Mime-Version: 1.0 Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: 7bit Cc: dev@dpdk.org To: Panu Matilainen Return-path: Received: from mail-pa0-f47.google.com (mail-pa0-f47.google.com [209.85.220.47]) by dpdk.org (Postfix) with ESMTP id 54A278E7B for ; Fri, 11 Dec 2015 17:33:27 +0100 (CET) Received: by pacdm15 with SMTP id dm15so67828690pac.3 for ; Fri, 11 Dec 2015 08:33:26 -0800 (PST) In-Reply-To: <566A9750.7070507@redhat.com> List-Id: patches and discussions about DPDK List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: dev-bounces@dpdk.org Sender: "dev" On Fri, 11 Dec 2015 11:28:48 +0200 Panu Matilainen wrote: > On 12/11/2015 01:27 AM, Stephen Hemminger wrote: > > Plan to change to version of struct ether_addr in > > DPDK 2.3. The change in DPDK source is trivial but it will impact > > source compatablilty therefore notification is necessary. > > > > Signed-off-by: Stephen Hemminger > > --- > > doc/guides/rel_notes/deprecation.rst | 5 +++++ > > 1 file changed, 5 insertions(+) > > > > diff --git a/doc/guides/rel_notes/deprecation.rst b/doc/guides/rel_notes/deprecation.rst > > index 1c7ab01..8ecb990 100644 > > --- a/doc/guides/rel_notes/deprecation.rst > > +++ b/doc/guides/rel_notes/deprecation.rst > > @@ -19,3 +19,8 @@ Deprecation Notices > > and table action handlers will be updated: > > the pipeline parameter will be added, the packets mask parameter will be > > either removed (for input port action handler) or made input-only. > > + > > +* librte_ether: The structure ether_addr in DPDK will be replaced > > + by using the standard header file . The structure > > + size will be the same (no ABI impact), but the structure field name > > + will change from addr_bytes[] to ether_addr_octet[]. > > > > I hope there is some other reason/benefit besides getting rid of a > three-line custom struct definition. It may be a trivial > s/addr_bytes/ether_addr_octet/ change but it touches a lot of places all > over the DPDK codebase alone, and for 3rd party developers such (at > least seemingly) gratuitous renames are really irritating. > > - Panu - > It allows dropping dependency on cmdline in several places in code (by using ether_ntoa instead). The problem was a day 0 choice in DPDK to define their own struct's everywhere.