From patchwork Thu Sep 28 05:16:47 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Jerin Jacob X-Patchwork-Id: 132074 X-Patchwork-Delegate: thomas@monjalon.net Return-Path: 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]) by inbox.dpdk.org (Postfix) with ESMTP id 3D50D4265B; Thu, 28 Sep 2023 07:17:03 +0200 (CEST) Received: from mails.dpdk.org (localhost [127.0.0.1]) by mails.dpdk.org (Postfix) with ESMTP id C71BA402AC; Thu, 28 Sep 2023 07:17:02 +0200 (CEST) Received: from mx0b-0016f401.pphosted.com (mx0b-0016f401.pphosted.com [67.231.156.173]) by mails.dpdk.org (Postfix) with ESMTP id 0C9A340277; Thu, 28 Sep 2023 07:17:00 +0200 (CEST) Received: from pps.filterd (m0045851.ppops.net [127.0.0.1]) by mx0b-0016f401.pphosted.com (8.17.1.19/8.17.1.19) with ESMTP id 38RHP3VR012953; Wed, 27 Sep 2023 22:17:00 -0700 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=marvell.com; h=from : to : cc : subject : date : message-id : mime-version : content-transfer-encoding : content-type; s=pfpt0220; bh=7vWm/tOD75VedkfDg+IRiGagFCH/V5285Mst80i97+8=; b=AxmMvIUtE2cG3CaXoQXKHPgFkX5sMeAJ2RhknGyMCYOnNaOOzwMZezvLf0nwNnfI4dFO z/Urta1PKi70VBN5ANqeWlLP6zkvNur0MTpztR4I6jhAWqjG0FV5nIQ/BXR1fx46XZTZ uZSDZa8HnQTWfhtR5GBNBCrVTUPwO2vIGAfxQ6i6cUzENL8f9O9J1SZLxUXxwHVnZ4yO Nic6AKf4O0RPof6xBfrRKHyK1k93yAZ8lybH3Hs15l6oKY1/erEIPmQgakRPgb1jotgI gOSurRN4NVrXz1APvGjX/I/ZOSwE3nb1eOWwhaZlcxSINQnNGlWHez3seTna+NFw9lC2 zg== Received: from dc5-exch01.marvell.com ([199.233.59.181]) by mx0b-0016f401.pphosted.com (PPS) with ESMTPS id 3tcrrs22cy-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-SHA384 bits=256 verify=NOT); Wed, 27 Sep 2023 22:17:00 -0700 Received: from DC5-EXCH01.marvell.com (10.69.176.38) by DC5-EXCH01.marvell.com (10.69.176.38) with Microsoft SMTP Server (TLS) id 15.0.1497.48; Wed, 27 Sep 2023 22:16:58 -0700 Received: from maili.marvell.com (10.69.176.80) by DC5-EXCH01.marvell.com (10.69.176.38) with Microsoft SMTP Server id 15.0.1497.48 via Frontend Transport; Wed, 27 Sep 2023 22:16:58 -0700 Received: from jerin-lab.marvell.com (jerin-lab.marvell.com [10.28.34.14]) by maili.marvell.com (Postfix) with ESMTP id 68BCF5C68EE; Wed, 27 Sep 2023 22:16:56 -0700 (PDT) From: To: CC: , Jerin Jacob Subject: [dpdk-dev] [PATCH] doc: define qualification criteria for external library Date: Thu, 28 Sep 2023 10:46:47 +0530 Message-ID: <20230928051648.562526-1-jerinj@marvell.com> X-Mailer: git-send-email 2.42.0 MIME-Version: 1.0 X-Proofpoint-ORIG-GUID: icYTvpjj-j9PHa3lxRon_9NKsjXc35_W X-Proofpoint-GUID: icYTvpjj-j9PHa3lxRon_9NKsjXc35_W X-Proofpoint-Virus-Version: vendor=baseguard engine=ICAP:2.0.267,Aquarius:18.0.980,Hydra:6.0.619,FMLib:17.11.176.26 definitions=2023-09-28_02,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 List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: dev-bounces@dpdk.org From: Jerin Jacob Define qualification criteria for external library based on a Techboard meeting minutes [1]. [1] http://mails.dpdk.org/archives/dev/2019-June/135847.html Signed-off-by: Jerin Jacob --- doc/guides/contributing/index.rst | 1 + doc/guides/contributing/library_dependency.rst | 17 +++++++++++++++++ 2 files changed, 18 insertions(+) create mode 100644 doc/guides/contributing/library_dependency.rst diff --git a/doc/guides/contributing/index.rst b/doc/guides/contributing/index.rst index dcb9b1fbf0..e5a8c2b0a3 100644 --- a/doc/guides/contributing/index.rst +++ b/doc/guides/contributing/index.rst @@ -15,6 +15,7 @@ Contributor's Guidelines documentation unit_test new_library + library_dependency patches vulnerability stable diff --git a/doc/guides/contributing/library_dependency.rst b/doc/guides/contributing/library_dependency.rst new file mode 100644 index 0000000000..9170525d47 --- /dev/null +++ b/doc/guides/contributing/library_dependency.rst @@ -0,0 +1,17 @@ +.. SPDX-License-Identifier: BSD-3-Clause + Copyright(c) 2023 Marvell. + +Library dependency +================== + +This document defines the qualification criteria for external libraries that may be +used as dependencies in DPDK drivers or libraries. + +- **Free availability**: The library must be freely available to build in either source or binary + form, with a preference for source form. + +- **Compiler compatibility**: The library must be able to compile with a DPDK supported compiler + for the given execution environment. For example, For Linux, the library must be able to compile + with GCC and/or clang. + +- **Documentation**: The library must have adequate documentation for the steps to build it.