From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mail-wm0-f47.google.com (mail-wm0-f47.google.com [74.125.82.47]) by dpdk.org (Postfix) with ESMTP id 2E0041B2E2 for ; Mon, 5 Feb 2018 15:34:12 +0100 (CET) Received: by mail-wm0-f47.google.com with SMTP id 141so26206628wme.3 for ; Mon, 05 Feb 2018 06:34:12 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=6wind-com.20150623.gappssmtp.com; s=20150623; h=date:from:to:cc:subject:message-id:references:mime-version :content-disposition:in-reply-to; bh=NIRxWflATGnBpGkqAxgispttlRgEFKWUwfUwdmh/M6M=; b=ZHA6cAdQ7ZjbFLzKi/yYOBFS02iC1AnQ6AyIiA35Qu0eW7vdkj18GbJ/KMC8baj1DB wrO/vDJC276YaWfjJmJ3W3Jx3fvDRzpBTmw1DnszTPosWRGJhisv7wPiXHcTF5NMSAaH Naf+8uBhHWbodTQVSrynllRR0cRfYKoRqVeOmjkKxCBe5eZVC0Caf47YWGx1MgNGDWxp y9r9elhBJDfozROsr7KHoJFNfWI/V3CO4saiTAk0LSJJld9Mg7gzx767zCqqkgwrBSvA TMb1Nnogj1pN2ATsIZWA4d25DSsjT96vso6hfNd9By0zpO+yDBydOMNgR/+adl1FyEB4 504Q== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:date:from:to:cc:subject:message-id:references :mime-version:content-disposition:in-reply-to; bh=NIRxWflATGnBpGkqAxgispttlRgEFKWUwfUwdmh/M6M=; b=WevWlVzlTDth7zWdU1aLS6PCA5TwYYvat5mLDO57zofkR9lJy/bDj1b6Rx7P8mqyP/ 7Oyx7utrN6K2g2KfpHD3jtGP7zrcS3/WC8ufstiiPoBm53grjsKGkYxKrtn2RkjF4J8g UKxd1z9Vl1Sh8Y6KsvaulV2JE6CGvvJvAckT/uazvhzQfI2Q0QVw+iIeku8HWjKB6Opp aCTeMfwqaH5LaF2gXGVWYvkStK1rcBdZCRFFFAgIFL7dwSXJS24pBSlCI/+HoVHIRCJn e71I7llRJ4xjjR6m7Uj50fjXpwFXNyzLjMYGet+cT63f+fWkhKUjIfmptU7baMb0aiF9 yZPg== X-Gm-Message-State: AKwxytcySpN/tDvJwl3EcVlwO2Oo3ano67Lp9Eqcj1PW63LlMGXEtXfg /YQsPZPndo2o90mA/O7VO9nj/A== X-Google-Smtp-Source: AH8x2257ZfHXHLRnWjiCZ2JqcZfXoUJElRRnmB2+cTTGSqF7EZixEWRBF9WJwS2JhCSeRajh8n7Meg== X-Received: by 10.28.29.81 with SMTP id d78mr39029471wmd.65.1517841251890; Mon, 05 Feb 2018 06:34:11 -0800 (PST) Received: from 6wind.com (host.78.145.23.62.rev.coltfrance.com. [62.23.145.78]) by smtp.gmail.com with ESMTPSA id t14sm5904833wmc.23.2018.02.05.06.34.11 (version=TLS1_2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128); Mon, 05 Feb 2018 06:34:11 -0800 (PST) Date: Mon, 5 Feb 2018 15:33:58 +0100 From: Adrien Mazarguil To: Thomas Monjalon , Shahaf Shuler Cc: Marcelo Ricardo Leitner , "Van Haaren, Harry" , "dev@dpdk.org" , Nelio Laranjeiro Message-ID: <20180205143358.GI4256@6wind.com> References: <20180202144736.8239-1-adrien.mazarguil@6wind.com> <20180205125806.GE27676@localhost.localdomain> <20180205134446.GG4256@6wind.com> <1992025.8JADqR79Gx@xps> MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <1992025.8JADqR79Gx@xps> Subject: Re: [dpdk-dev] [PATCH v2 3/4] net/mlx: version rdma-core glue libraries 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: , X-List-Received-Date: Mon, 05 Feb 2018 14:34:12 -0000 On Mon, Feb 05, 2018 at 03:16:21PM +0100, Thomas Monjalon wrote: > 05/02/2018 14:44, Adrien Mazarguil: > > On Mon, Feb 05, 2018 at 10:58:06AM -0200, Marcelo Ricardo Leitner wrote: > > > On Mon, Feb 05, 2018 at 12:24:23PM +0000, Van Haaren, Harry wrote: > > > > > From: dev [mailto:dev-bounces@dpdk.org] On Behalf Of Marcelo Ricardo Leitner > > > > > Sent: Monday, February 5, 2018 12:14 PM > > > > > To: Adrien Mazarguil > > > > > Cc: Thomas Monjalon ; dev@dpdk.org; Shahaf Shuler > > > > > ; Nelio Laranjeiro > > > > > Subject: Re: [dpdk-dev] [PATCH v2 3/4] net/mlx: version rdma-core glue > > > > > libraries > > > > > > > > > > On Mon, Feb 05, 2018 at 12:24:02PM +0100, Adrien Mazarguil wrote: > > > > > > On Sun, Feb 04, 2018 at 03:29:38PM +0100, Thomas Monjalon wrote: > > > > > > > 02/02/2018 17:46, Adrien Mazarguil: > > > > > > > > --- a/drivers/net/mlx4/Makefile > > > > > > > > +++ b/drivers/net/mlx4/Makefile > > > > > > > > @@ -33,7 +33,9 @@ include $(RTE_SDK)/mk/rte.vars.mk > > > > > > > > > > > > > > > > # Library name. > > > > > > > > LIB = librte_pmd_mlx4.a > > > > > > > > -LIB_GLUE = librte_pmd_mlx4_glue.so > > > > > > > > +LIB_GLUE = $(LIB_GLUE_BASE).$(LIB_GLUE_VERSION) > > > > > > > > +LIB_GLUE_BASE = librte_pmd_mlx4_glue.so > > > > > > > > +LIB_GLUE_VERSION = 18.02.1 > > > > > > > > > > > > > > You should use the version number of the release, i.e. 18.02.0 > > > > > > > Ideally, you should retrieve it from rte_version.h. > > > > > > > > > > > > Keep in mind this only needs to be updated when the glue API gets > > > > > modified, > > > > > > and this "18.02.1" string may remain unmodified for subsequent DPDK > > > > > > releases, probably as long as the PMD doesn't use any new rdma-core calls. > > > > > > > > > > > > We've already backported this patch to 17.02 and 17.11, both requiring > > > > > > different sets of Verbs calls and thus a different version, hence the > > > > > added > > > > > > "18.02" as a starting point. The last digit may have to be modified > > > > > possibly > > > > > > several times between official DPDK releases while work is being done on > > > > > the > > > > > > PMD (i.e. per commit). > > > > > > > > > > > > In short it's not meant to follow DPDK's public versioning scheme. If you > > > > > > really think it should, doing so will make things more complex in the > > > > > > Makefile, which will have to parse rte_version.h. What's your opinion? > > > > > > > > > > What about appending date +%s output to it? It would be stricter and > > > > > automated. > > > > > > > > Adding current timestamp or date into a build breaks reproducibility of builds, so is > > > > generally not recommended. > > > > > > Then the sha1sum of mlx4_glue.h. > > > With this the size check I mentioned on the other patch would become > > > redundant and unnecessary. > > > > Using a strong hash algorithm to version a library/symbol, while possible, > > seems a bit overkill and results in ugliness: > > > > librte_pmd_mlx4.so.c4ca4eaf2fe975ead83453458f4f56db49e724f3 > > > > Using a weak one like CRC32 for a shorter name poses a risk of > > collision. Moreover the next time someone decides to update all version > > notices or modify a comment will impact that hash. We'd need to isolate the > > symbol definition itself, ignore parameter names in function prototypes and > > only then we may get a somewhat meaningful hash describing a given ABI. > > > > Given the added complexity, is there really a problem with simple version > > numbers we increment every time something gets modified? (Note this is > > already how our .map files work, they're not generated automatically) > > Our map files show the major version where a symbol was introduced. > It is simple because no symbol can be introduced in a minor version. > > > How about keeping things as is? > > You are using 18.02.1 while it is introduced in 18.02.0. > If you don't want to correlate the .so version number with DPDK version > number, maybe that 1, 2, 3 would be a simpler choice (less confusing). I don't really care as long as there's no confusion with their backported counterparts (namely 17.11 and 17.02). I understand the possible confusion for someone who'd grep the sources though. If 18.02.0 is OK in everyone's opinion, let's use that. It satisfies the uniqueness requirement. We'll add a digit or find some other versioning scheme later if necessary. Shahaf, can you make a minor adjustment while applying this series? Both drivers/net/mlx4/Makefile and drivers/net/mlx5/Makefile need to be modified as follows in patch 3/4: -LIB_GLUE_VERSION = 18.02.1 +LIB_GLUE_VERSION = 18.02.0 -- Adrien Mazarguil 6WIND