Patch Detail
get:
Show a patch.
patch:
Update a patch.
put:
Update a patch.
GET /api/patches/132075/?format=api
https://patches.dpdk.org/api/patches/132075/?format=api", "web_url": "https://patches.dpdk.org/project/dpdk/patch/20230928054036.645183-1-jerinj@marvell.com/", "project": { "id": 1, "url": "https://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": "<20230928054036.645183-1-jerinj@marvell.com>", "list_archive_url": "https://inbox.dpdk.org/dev/20230928054036.645183-1-jerinj@marvell.com", "date": "2023-09-28T05:40:35", "name": "[v2] doc: define qualification criteria for external library", "commit_ref": null, "pull_url": null, "state": "superseded", "archived": true, "hash": "0e5f1745424eb04a0d86df4b392a834ff2ffc3ae", "submitter": { "id": 1188, "url": "https://patches.dpdk.org/api/people/1188/?format=api", "name": "Jerin Jacob Kollanukkaran", "email": "jerinj@marvell.com" }, "delegate": { "id": 1, "url": "https://patches.dpdk.org/api/users/1/?format=api", "username": "tmonjalo", "first_name": "Thomas", "last_name": "Monjalon", "email": "thomas@monjalon.net" }, "mbox": "https://patches.dpdk.org/project/dpdk/patch/20230928054036.645183-1-jerinj@marvell.com/mbox/", "series": [ { "id": 29666, "url": "https://patches.dpdk.org/api/series/29666/?format=api", "web_url": "https://patches.dpdk.org/project/dpdk/list/?series=29666", "date": "2023-09-28T05:40:35", "name": "[v2] doc: define qualification criteria for external library", "version": 2, "mbox": "https://patches.dpdk.org/series/29666/mbox/" } ], "comments": "https://patches.dpdk.org/api/patches/132075/comments/", "check": "success", "checks": "https://patches.dpdk.org/api/patches/132075/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 mails.dpdk.org (mails.dpdk.org [217.70.189.124])\n\tby inbox.dpdk.org (Postfix) with ESMTP id 87CC24265B;\n\tThu, 28 Sep 2023 07:40:48 +0200 (CEST)", "from mails.dpdk.org (localhost [127.0.0.1])\n\tby mails.dpdk.org (Postfix) with ESMTP id 145F7402AC;\n\tThu, 28 Sep 2023 07:40:48 +0200 (CEST)", "from mx0b-0016f401.pphosted.com (mx0b-0016f401.pphosted.com\n [67.231.156.173])\n by mails.dpdk.org (Postfix) with ESMTP id D82494027D;\n Thu, 28 Sep 2023 07:40:45 +0200 (CEST)", "from pps.filterd (m0045851.ppops.net [127.0.0.1])\n by mx0b-0016f401.pphosted.com (8.17.1.19/8.17.1.19) with ESMTP id\n 38RHOhZl012344; Wed, 27 Sep 2023 22:40:45 -0700", "from dc5-exch02.marvell.com ([199.233.59.182])\n by mx0b-0016f401.pphosted.com (PPS) with ESMTPS id 3tcrrs2484-1\n (version=TLSv1.2 cipher=ECDHE-RSA-AES256-SHA384 bits=256 verify=NOT);\n Wed, 27 Sep 2023 22:40:45 -0700", "from DC5-EXCH02.marvell.com (10.69.176.39) by DC5-EXCH02.marvell.com\n (10.69.176.39) with Microsoft SMTP Server (TLS) id 15.0.1497.48;\n Wed, 27 Sep 2023 22:40:43 -0700", "from maili.marvell.com (10.69.176.80) by DC5-EXCH02.marvell.com\n (10.69.176.39) with Microsoft SMTP Server id 15.0.1497.48 via Frontend\n Transport; Wed, 27 Sep 2023 22:40:43 -0700", "from jerin-lab.marvell.com (jerin-lab.marvell.com [10.28.34.14])\n by maili.marvell.com (Postfix) with ESMTP id 643205C68EE;\n Wed, 27 Sep 2023 22:40:41 -0700 (PDT)" ], "DKIM-Signature": "v=1; a=rsa-sha256; c=relaxed/relaxed; d=marvell.com;\n h=from : to : cc :\n subject : date : message-id : in-reply-to : references : mime-version :\n content-transfer-encoding : content-type; s=pfpt0220;\n bh=dLCaDUT82fur9+NQdBBEHJ1cBZLAintN9e9UJYYjzE4=;\n b=Vlgx6q2jgey/ObwhdYhxg8LGq7WthC79lCAbTZp7AiUkzqWh4VcfX//o+kzl/aD83Ybc\n qlTS8jh9KhHh7hc6GNeJueghdDKxIEjvaXEijaPja3XDASHljJb8fFL/ypytIzPOsjc9\n IOnIoyiJiP9VbKyz+X7Io/i0re9+1kVSkFcWivb3gPAGCshJBuz3HRYnjxiEAKBYGBlh\n aKNg9PciJIIsZZ7lVI8UiPij1n/dc8fq12nwefeVaVG8QXGaLpg6jDAyq0soTu7bqD6/\n hIzZ34RUSy0t77IbdKG6pitd01ognb2te9IKLODA+i4NC+ii4T5HhGGYAlIB4hj4Rut7 sA==", "From": "<jerinj@marvell.com>", "To": "<dev@dpdk.org>", "CC": "<techboard@dpdk.org>, Jerin Jacob <jerinj@marvell.com>", "Subject": "[dpdk-dev] [PATCH v2] doc: define qualification criteria for external\n library", "Date": "Thu, 28 Sep 2023 11:10:35 +0530", "Message-ID": "<20230928054036.645183-1-jerinj@marvell.com>", "X-Mailer": "git-send-email 2.42.0", "In-Reply-To": "<20230928051648.562526-1-jerinj@marvell.com>", "References": "<20230928051648.562526-1-jerinj@marvell.com>", "MIME-Version": "1.0", "Content-Transfer-Encoding": "8bit", "Content-Type": "text/plain", "X-Proofpoint-ORIG-GUID": "9ooq6wJtXQ56sMVbJAj7Y7TesnpQNdXS", "X-Proofpoint-GUID": "9ooq6wJtXQ56sMVbJAj7Y7TesnpQNdXS", "X-Proofpoint-Virus-Version": "vendor=baseguard\n engine=ICAP:2.0.267,Aquarius:18.0.980,Hydra:6.0.619,FMLib:17.11.176.26\n definitions=2023-09-28_03,2023-09-27_01,2023-05-22_02", "X-BeenThere": "dev@dpdk.org", "X-Mailman-Version": "2.1.29", "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" }, "content": "From: Jerin Jacob <jerinj@marvell.com>\n\nDefine qualification criteria for external library\nbased on a techboard meeting minutes [1] and past\nlearnings from mailing list discussion.\n\n[1]\nhttp://mails.dpdk.org/archives/dev/2019-June/135847.html\n\nSigned-off-by: Jerin Jacob <jerinj@marvell.com>\n---\nv2:\n- Added \"Meson build integration\" and \"Code readability\" sections.\n\n doc/guides/contributing/index.rst | 1 +\n .../contributing/library_dependency.rst | 23 +++++++++++++++++++\n 2 files changed, 24 insertions(+)\n create mode 100644 doc/guides/contributing/library_dependency.rst", "diff": "diff --git a/doc/guides/contributing/index.rst b/doc/guides/contributing/index.rst\nindex dcb9b1fbf0..e5a8c2b0a3 100644\n--- a/doc/guides/contributing/index.rst\n+++ b/doc/guides/contributing/index.rst\n@@ -15,6 +15,7 @@ Contributor's Guidelines\n documentation\n unit_test\n new_library\n+ library_dependency\n patches\n vulnerability\n stable\ndiff --git a/doc/guides/contributing/library_dependency.rst b/doc/guides/contributing/library_dependency.rst\nnew file mode 100644\nindex 0000000000..687a3b6cef\n--- /dev/null\n+++ b/doc/guides/contributing/library_dependency.rst\n@@ -0,0 +1,23 @@\n+.. SPDX-License-Identifier: BSD-3-Clause\n+ Copyright(c) 2023 Marvell.\n+\n+Library dependency\n+==================\n+\n+This document defines the qualification criteria for external libraries that may be\n+used as dependencies in DPDK drivers or libraries.\n+\n+- **Free availability**: The library must be freely available to build in either source or binary\n+ form, with a preference for source form.\n+\n+- **Compiler compatibility**: The library must be able to compile with a DPDK supported compiler\n+ for the given execution environment. For example, For Linux, the library must be able to compile\n+ with GCC and/or clang.\n+\n+- **Documentation**: Must have adequate documentation for the steps to build it.\n+\n+- **Meson build integration**: The library must have standard method like ``pkg-config``\n+ for seamless integration with DPDK's build environment.\n+\n+- **Code readability**: When the depended library is optional, use stubs to reduce the ``ifdef``\n+ clutter to enable better code readability.\n", "prefixes": [ "v2" ] }{ "id": 132075, "url": "