Patch Detail
get:
Show a patch.
patch:
Update a patch.
put:
Update a patch.
GET /api/patches/69744/?format=api
{ "id": 69744, "url": "http://patches.dpdk.org/api/patches/69744/?format=api", "web_url": "http://patches.dpdk.org/project/dpdk/patch/1588669009-995-1-git-send-email-mdr@ashroe.eu/", "project": { "id": 1, "url": "http://patches.dpdk.org/api/projects/1/?format=api", "name": "DPDK", "link_name": "dpdk", "list_id": "dev.dpdk.org", "list_email": "dev@dpdk.org", "web_url": "http://core.dpdk.org", "scm_url": "git://dpdk.org/dpdk", "webscm_url": "http://git.dpdk.org/dpdk", "list_archive_url": "https://inbox.dpdk.org/dev", "list_archive_url_format": "https://inbox.dpdk.org/dev/{}", "commit_url_format": "" }, "msgid": "<1588669009-995-1-git-send-email-mdr@ashroe.eu>", "list_archive_url": "https://inbox.dpdk.org/dev/1588669009-995-1-git-send-email-mdr@ashroe.eu", "date": "2020-05-05T08:56:48", "name": "[v2] abi: document reasons behind the three part versioning", "commit_ref": null, "pull_url": null, "state": "accepted", "archived": true, "hash": "320476e024a09bfb49831d9097cc3a88c1f46c1d", "submitter": { "id": 1310, "url": "http://patches.dpdk.org/api/people/1310/?format=api", "name": "Ray Kinsella", "email": "mdr@ashroe.eu" }, "delegate": { "id": 1, "url": "http://patches.dpdk.org/api/users/1/?format=api", "username": "tmonjalo", "first_name": "Thomas", "last_name": "Monjalon", "email": "thomas@monjalon.net" }, "mbox": "http://patches.dpdk.org/project/dpdk/patch/1588669009-995-1-git-send-email-mdr@ashroe.eu/mbox/", "series": [ { "id": 9826, "url": "http://patches.dpdk.org/api/series/9826/?format=api", "web_url": "http://patches.dpdk.org/project/dpdk/list/?series=9826", "date": "2020-05-05T08:56:48", "name": "[v2] abi: document reasons behind the three part versioning", "version": 2, "mbox": "http://patches.dpdk.org/series/9826/mbox/" } ], "comments": "http://patches.dpdk.org/api/patches/69744/comments/", "check": "success", "checks": "http://patches.dpdk.org/api/patches/69744/checks/", "tags": {}, "related": [], "headers": { "Return-Path": "<dev-bounces@dpdk.org>", "X-Original-To": "patchwork@inbox.dpdk.org", "Delivered-To": "patchwork@inbox.dpdk.org", "Received": [ "from dpdk.org (dpdk.org [92.243.14.124])\n\tby inbox.dpdk.org (Postfix) with ESMTP id 7B17DA04B8;\n\tTue, 5 May 2020 10:57:07 +0200 (CEST)", "from [92.243.14.124] (localhost [127.0.0.1])\n\tby dpdk.org (Postfix) with ESMTP id 569D11D42A;\n\tTue, 5 May 2020 10:57:07 +0200 (CEST)", "from qrelay228.mxroute.com (qrelay228.mxroute.com [172.82.139.228])\n by dpdk.org (Postfix) with ESMTP id 504E71D177\n for <dev@dpdk.org>; Tue, 5 May 2020 10:57:06 +0200 (CEST)", "from filter003.mxroute.com ([168.235.111.26]\n 168-235-111-26.cloud.ramnode.com)\n (Authenticated sender: mN4UYu2MZsgR)\n by qrelay228.mxroute.com (ZoneMTA) with ESMTPA id 171e40d86c0000add6.001\n for <dev@dpdk.org>; Tue, 05 May 2020 08:57:03 +0000", "from galaxy.mxroute.com (unknown [23.92.70.113])\n by filter003.mxroute.com (Postfix) with ESMTPS id 6F3AC60007;\n Tue, 5 May 2020 08:56:58 +0000 (UTC)", "from [192.198.151.44] (helo=localhost)\n by galaxy.mxroute.com with esmtpsa (TLSv1.2:ECDHE-RSA-AES128-GCM-SHA256:128)\n (Exim 4.91) (envelope-from <mdr@ashroe.eu>)\n id 1jVsxA-0002fC-Ok; Tue, 05 May 2020 04:29:25 -0400" ], "X-Zone-Loop": "8f03b52e05a8937f7717bc9f3105e8534b626f37975c", "X-Originating-IP": "[168.235.111.26]", "From": "Ray Kinsella <mdr@ashroe.eu>", "To": "dev@dpdk.org", "Cc": "stable@dpdk.org, thomas@monjalon.net, Ray Kinsella <mdr@ashroe.eu>,\n Bruce Richardson <bruce.richardson@intel.com>,\n Neil Horman <nhorman@tuxdriver.com>,\n John McNamara <john.mcnamara@intel.com>,\n Marko Kovacevic <marko.kovacevic@intel.com>", "Date": "Tue, 5 May 2020 09:56:48 +0100", "Message-Id": "<1588669009-995-1-git-send-email-mdr@ashroe.eu>", "X-Mailer": "git-send-email 2.7.4", "In-Reply-To": "<1587636728-1619-1-git-send-email-mdr@ashroe.eu>", "References": "<1587636728-1619-1-git-send-email-mdr@ashroe.eu>", "X-AuthUser": "mdr@ashroe.eu", "Subject": "[dpdk-dev] [PATCH v2] abi: document reasons behind the three part\n\tversioning", "X-BeenThere": "dev@dpdk.org", "X-Mailman-Version": "2.1.15", "Precedence": "list", "List-Id": "DPDK patches and discussions <dev.dpdk.org>", "List-Unsubscribe": "<https://mails.dpdk.org/options/dev>,\n <mailto:dev-request@dpdk.org?subject=unsubscribe>", "List-Archive": "<http://mails.dpdk.org/archives/dev/>", "List-Post": "<mailto:dev@dpdk.org>", "List-Help": "<mailto:dev-request@dpdk.org?subject=help>", "List-Subscribe": "<https://mails.dpdk.org/listinfo/dev>,\n <mailto:dev-request@dpdk.org?subject=subscribe>", "Errors-To": "dev-bounces@dpdk.org", "Sender": "\"dev\" <dev-bounces@dpdk.org>" }, "content": "Clarify the reasons behind the three part version numbering scheme.\nDocuments the fixes made in f26c2b3.\n\nFixes: f26c2b39b271 (\"build: fix soname info for 19.11 compatibility\")\n\nSigned-off-by: Ray Kinsella <mdr@ashroe.eu>\nSigned-off-by: Bruce Richardson <bruce.richardson@intel.com>\n---\nv2:\n* Added \"fixes\" to commit message.\n\n doc/guides/contributing/abi_policy.rst | 3 ++-\n doc/guides/rel_notes/release_20_05.rst | 12 ++++++++++++\n 2 files changed, 14 insertions(+), 1 deletion(-)\n\n--\n2.7.4", "diff": "diff --git a/doc/guides/contributing/abi_policy.rst b/doc/guides/contributing/abi_policy.rst\nindex 05ca959..86e7dd9 100644\n--- a/doc/guides/contributing/abi_policy.rst\n+++ b/doc/guides/contributing/abi_policy.rst\n@@ -39,7 +39,8 @@ General Guidelines\n releases, over a number of release cycles. This change begins with\n maintaining ABI stability through one year of DPDK releases starting from\n DPDK 19.11. This policy will be reviewed in 2020, with intention of\n- lengthening the stability period.\n+ lengthening the stability period. Additional implementation detail can be\n+ found in the :ref:`release notes <20_05_abi_changes>`.\n\n What is an ABI?\n ~~~~~~~~~~~~~~~\ndiff --git a/doc/guides/rel_notes/release_20_05.rst b/doc/guides/rel_notes/release_20_05.rst\nindex ab20a7d..b2839dc 100644\n--- a/doc/guides/rel_notes/release_20_05.rst\n+++ b/doc/guides/rel_notes/release_20_05.rst\n@@ -245,6 +245,7 @@ API Changes\n ``rte_mempool_populate_virt()`` changed to return 0 instead of -EINVAL\n when there is not enough room to store one object.\n\n+.. _20_05_abi_changes:\n\n ABI Changes\n -----------\n@@ -261,6 +262,17 @@ ABI Changes\n Also, make sure to start the actual text at the margin.\n =========================================================\n\n+* The soname for each stable ABI version should be just the ABI version major\n+ number without the minor number. Unfortunately both major and minor were used\n+ in the v19.11 release, causing version v20.x releases to be incompatible with\n+ ABI v20.0.\n+\n+ The `commit f26c2b3\n+ <https://git.dpdk.org/dpdk/commit/?id=f26c2b39b271cdcd857ba518c5e48c78cb1c30af>`_\n+ fixed the issue by switching from 2-part to 3-part ABI version numbers so that\n+ we can keep v20.0 as soname and using the final digits to identify the DPDK\n+ 20.x releases which are ABI compatible.\n+\n * No ABI change that would break compatibility with DPDK 20.02 and 19.11.\n\n\n", "prefixes": [ "v2" ] }