From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mails.dpdk.org (mails.dpdk.org [217.70.189.124]) by inbox.dpdk.org (Postfix) with ESMTP id EB37646282; Thu, 20 Feb 2025 21:32:10 +0100 (CET) Received: from mails.dpdk.org (localhost [127.0.0.1]) by mails.dpdk.org (Postfix) with ESMTP id 2230D402DB; Thu, 20 Feb 2025 21:32:07 +0100 (CET) Received: from linux.microsoft.com (linux.microsoft.com [13.77.154.182]) by mails.dpdk.org (Postfix) with ESMTP id 6DA03402B2 for ; Thu, 20 Feb 2025 21:32:04 +0100 (CET) Received: by linux.microsoft.com (Postfix, from userid 1213) id A118B203EC16; Thu, 20 Feb 2025 12:32:03 -0800 (PST) DKIM-Filter: OpenDKIM Filter v2.11.0 linux.microsoft.com A118B203EC16 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=linux.microsoft.com; s=default; t=1740083523; bh=qRjjU6VA7xE2EPdFQDIwYi/ZGMgkOIoQ+DRie4YnGjM=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=aApr6/SrucE9V0r337Md+FHqhSDZyqNv+9tGc7vK26G4RZaeWZ+A36tfMW7rztl/R TMsaC1EbnZzKOiJMDiIxFLAAMeVkqsYvkRaXrl7duIoofs5DDXFqTN0mhicN0TcGV8 lUGr8285hg83GGAFmWNWdwguzq3xDBBnfMs8Nbm4= From: Andre Muezerie To: andremue@linux.microsoft.com Cc: dev@dpdk.org Subject: [PATCH v3 1/6] doc: update guide on versioning macros Date: Thu, 20 Feb 2025 12:31:43 -0800 Message-Id: <1740083508-6703-2-git-send-email-andremue@linux.microsoft.com> X-Mailer: git-send-email 1.8.3.1 In-Reply-To: <1740083508-6703-1-git-send-email-andremue@linux.microsoft.com> References: <1739224265-4158-1-git-send-email-andremue@linux.microsoft.com> <1740083508-6703-1-git-send-email-andremue@linux.microsoft.com> X-BeenThere: dev@dpdk.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: DPDK patches and discussions List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: dev-bounces@dpdk.org Added explanation about new macro MAP_STATIC_BASE_SYMBOL. Signed-off-by: Andre Muezerie --- doc/guides/contributing/abi_versioning.rst | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/doc/guides/contributing/abi_versioning.rst b/doc/guides/contributing/abi_versioning.rst index 7afd1c1886..1179445da3 100644 --- a/doc/guides/contributing/abi_versioning.rst +++ b/doc/guides/contributing/abi_versioning.rst @@ -151,6 +151,11 @@ The macros exported are: fully qualified function ``p``, so that if a symbol becomes versioned, it can still be mapped back to the public symbol name. +* ``MAP_STATIC_BASE_SYMBOL(b, p)``: Declare the base symbol ``b``, and map it + to the fully qualified function ``p``, so that if a symbol becomes versioned, + it can still be mapped back to the public symbol name. Used for compatibility + with MSVC. + * ``__vsym``: Annotation to be used in a declaration of the internal symbol ``be`` to signal that it is being used as an implementation of a particular version of symbol ``b``. @@ -397,6 +402,7 @@ defined, we add this ... } MAP_STATIC_SYMBOL(struct rte_acl_ctx *rte_acl_create(const struct rte_acl_param *param, int debug), rte_acl_create_v22); + MAP_STATIC_BASE_SYMBOL(rte_acl_create, rte_acl_create_v22); That tells the compiler that, when building a static library, any calls to the symbol ``rte_acl_create`` should be linked to ``rte_acl_create_v22`` -- 2.48.1.vfs.0.0