From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from dpdk.org (dpdk.org [92.243.14.124]) by inbox.dpdk.org (Postfix) with ESMTP id 63A20A0350; Wed, 1 Jul 2020 17:16:58 +0200 (CEST) Received: from [92.243.14.124] (localhost [127.0.0.1]) by dpdk.org (Postfix) with ESMTP id E32A21D15E; Wed, 1 Jul 2020 17:16:57 +0200 (CEST) Received: from mga14.intel.com (mga14.intel.com [192.55.52.115]) by dpdk.org (Postfix) with ESMTP id 0B8A51D16D for ; Wed, 1 Jul 2020 17:16:56 +0200 (CEST) IronPort-SDR: QZfyW0KfxmwqN7n0zJ3DEUz6wVhih7eRLPf9gdy0LaykCY6ZQw07CCH9dHsXHO3sQdWpZHQeL0 wtfIX4foDEEg== X-IronPort-AV: E=McAfee;i="6000,8403,9668"; a="145680655" X-IronPort-AV: E=Sophos;i="5.75,300,1589266800"; d="scan'208";a="145680655" X-Amp-Result: SKIPPED(no attachment in message) X-Amp-File-Uploaded: False Received: from orsmga005.jf.intel.com ([10.7.209.41]) by fmsmga103.fm.intel.com with ESMTP/TLS/ECDHE-RSA-AES256-GCM-SHA384; 01 Jul 2020 08:16:55 -0700 IronPort-SDR: UEhl4KeQbsx1/zxDGPAMMGxXftjLyIJvI5D+PzHVylOU1XfU2tOCztq3SpHZYH7p6bo5KmxeQV /abk5XLyMTCg== X-IronPort-AV: E=Sophos;i="5.75,300,1589266800"; d="scan'208";a="455138007" Received: from bricha3-mobl.ger.corp.intel.com ([10.251.80.77]) by orsmga005-auth.jf.intel.com with ESMTP/TLS/ECDHE-RSA-AES256-SHA; 01 Jul 2020 08:16:54 -0700 Date: Wed, 1 Jul 2020 16:16:51 +0100 From: Bruce Richardson To: Thomas Monjalon Cc: dev@dpdk.org, david.marchand@redhat.com, ktraynor@redhat.com, bluca@debian.org, sunil.pai.g@intel.com Message-ID: <20200701151651.GG595@bricha3-MOBL.ger.corp.intel.com> References: <20200429100831.398-1-bruce.richardson@intel.com> <20200630141433.818517-1-bruce.richardson@intel.com> <20200630141433.818517-6-bruce.richardson@intel.com> <7587667.Wdl7rU7Jnr@thomas> MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <7587667.Wdl7rU7Jnr@thomas> Subject: Re: [dpdk-dev] [PATCH v3 5/7] build/pkg-config: output driver libs first for static build 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" On Wed, Jul 01, 2020 at 04:42:33PM +0200, Thomas Monjalon wrote: > 30/06/2020 16:14, Bruce Richardson: > > When calling pkg-config --static --libs, pkg-config will always output the > > regular libs first, and then the extra libs from libraries.private field, > > s/libraries.private/Libs.private/ > > > since the assumption is that those are additional dependencies for building > > statically that the .a files depend upon. > > > > However, for DPDK, we only link the driver files for static builds, and > > those need to come *before* the regular libraries. To get this result, we > > need two pkgconfig files for DPDK, one for the shared libs, and a second > > for the static libs and drivers, which depends upon the first. Using a > > dependency means that the shared libs are printed only after the > > libraries.private field rather than before. > > s/libraries.private/Libs.private/ > > > Without this patch, the linking works in DPDK because in all cases we > > specify the libraries after the drivers in the Libs.private line, ensuring > > that the references to the libs from the drivers can be resolved. The > > current output is therefore of the form, "(shared)libs, drivers, > > (static)libs", while after this patch the output is, "drivers, > > (static)libs, (shared)libs". The former case will not work if we use the > > --whole-archive flag on the static libs as it will lead to duplicate > > definitions due to some references having been previously resolved from the > > shared libraries. By ensuring the shared libraries come last in the link > > link, this issue does not occur, as duplicate references when linking the > > shared libs will be ignored. > > > > Signed-off-by: Bruce Richardson > > Acked-by: Luca Boccassi > > Acked-by: Sunil Pai G > > --- > > +# When calling pkg-config --static --libs, pkg-config will always output the > > +# regular libs first, and then the extra libs from libraries.private field, > > +# since the assumption is that those are additional dependencies for building > > +# statically that the .a files depend upon. However, for DPDK, we only link > > +# the driver files for static builds, and those need to come *before* the > > +# regular libraries. To get this result, we need two pkgconfig files for DPDK, > > +# one for the shared libs, and a second for the static libs and drivers, which > > +# depends upon the first. Using a dependency means that the shared libs are > > +# printed only after the libraries.private field rather than before. > > This is not obvious. In order to avoid messing it up in future, > I suggest this longer reword: > > # When calling pkg-config --static --libs, pkg-config will always output the > # regular libs first, and then the extra libs from Libs.private field, > # since the assumption is that those are additional dependencies for building > # statically that the .a files depend upon. The output order of .pc fields is: > # Cflags Libs Libs.private Requires Requires.private > # The fields Requires* are for package names. > # The flags of the DPDK libraries must be defined in Libs* fields. > # However, the DPDK drivers are linked only in static builds (Libs.private), > # and those need to come *before* the regular libraries (Libs field). > # This requirement is satisfied by moving the regular libs in a separate file > # included in the field Requires (after Libs.private). > # Another requirement is to allow linking dependencies as shared libraries, > # while linking static DPDK libraries and drivers. It is satisfied by > # listing the static files in Libs.private with the explicit syntax -l:libfoo.a. > # As a consequence, the regular DPDK libraries are already listed as static > # in the field Libs.private. The second occurences of DPDK libraries, > # included from Requires and used for shared library linkage case, > # are skipped in the case of static linkage thanks to the flag --as-needed. > > # Link order summary: > # libdpdk.Libs.private: whole-archive(static drivers/libs), drivers deps flags > # libdpdk.Requires: libdpdk-libs package > # libdpdk-libs.Libs: as-needed(shared libs) > # libdpdk-libs.Libs.private: libs deps flags > # libdpdk.pc.Requires.private: deps packages > > > If you agree, I could change this comment while merging. > I would add my Signed-off ;) > This seems generally ok, but probably should just be added as part of patch #7 when all parts of the above have been applied. Couple of comments: * One small nit is that cflags are not output as part of the --libs call, so you can remove them from the list on line 5 of the comment. They aren't really relevant to this comment/essay. * I find the link-order summary to actually be more confusing than helpful. I think the text block is explanatory enough. It just confuses things introducing the extra details of what goes in the requires-private or libs-private of the libdpdk.pc file. That's just regular stuff, unrelated to the changes or to DPDK special-case of needing private libs first. /Bruce