From patchwork Wed May 17 17:34:00 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Bruce Richardson X-Patchwork-Id: 126948 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 C1F9B42B2C; Wed, 17 May 2023 19:34:12 +0200 (CEST) Received: from mails.dpdk.org (localhost [127.0.0.1]) by mails.dpdk.org (Postfix) with ESMTP id B25A342BDA; Wed, 17 May 2023 19:34:12 +0200 (CEST) Received: from mga09.intel.com (mga09.intel.com [134.134.136.24]) by mails.dpdk.org (Postfix) with ESMTP id 222B542B71; Wed, 17 May 2023 19:34:10 +0200 (CEST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=intel.com; i=@intel.com; q=dns/txt; s=Intel; t=1684344851; x=1715880851; h=from:to:cc:subject:date:message-id:in-reply-to: references:mime-version:content-transfer-encoding; bh=UP8bWXOANoiCqsWFDF7ZgnUPMhh63iQLbR0sdapwDco=; b=KRjISZDHiBXlQ3WocZDyjhtFvUpwvoS0wGSWFpcn3SXqwiV1m3veSvzO 5eVZsYREv81eLEzMr66a8FiRskSmN64PedbMxO+XUrk8VZdnNjqcvXyFT nyPHXcwTIcAsWyIVDpZDQmC5V7L217/Yoeo6T+s+Zu40wMKjM+MIklg6A mWip2Nd8l92D8RX6+ojAvWBhidweqeXTBLfBkoL6wC/seb4UuxysLVZ/e eJeNxmk58SSjwm9vi7V7YOBtWl2yXO0SwecQdQ0npy4hUkGMbmPzB9nNi v+cfjtkHIy8mAYqHYjiHD5fu5NrmVCTs2rCfYjZiBRDYQFI2awRO0BFiW A==; X-IronPort-AV: E=McAfee;i="6600,9927,10713"; a="354129312" X-IronPort-AV: E=Sophos;i="5.99,282,1677571200"; d="scan'208";a="354129312" Received: from fmsmga005.fm.intel.com ([10.253.24.32]) by orsmga102.jf.intel.com with ESMTP/TLS/ECDHE-RSA-AES256-GCM-SHA384; 17 May 2023 10:34:10 -0700 X-ExtLoop1: 1 X-IronPort-AV: E=McAfee;i="6600,9927,10713"; a="1031830082" X-IronPort-AV: E=Sophos;i="5.99,282,1677571200"; d="scan'208";a="1031830082" Received: from silpixa00401385.ir.intel.com ([10.237.214.44]) by fmsmga005.fm.intel.com with ESMTP; 17 May 2023 10:34:08 -0700 From: Bruce Richardson To: dev@dpdk.org Cc: techboard@dpdk.org, Bruce Richardson , Tyler Retzlaff Subject: [PATCH v3] build: announce requirement for C11 Date: Wed, 17 May 2023 18:34:00 +0100 Message-Id: <20230517173400.22858-1-bruce.richardson@intel.com> X-Mailer: git-send-email 2.39.2 In-Reply-To: <20230503151413.14915-1-bruce.richardson@intel.com> References: <20230503151413.14915-1-bruce.richardson@intel.com> MIME-Version: 1.0 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 Add a deprecation notice informing users that we will require a C11 compiler from 23.11 release onwards. This requirement was agreed by technical board to enable use of newer C language features, e.g. standard atomics. [1] [1] http://inbox.dpdk.org/dev/DBAPR08MB58148CEC3E1454E8848A938998AB9@DBAPR08MB5814.eurprd08.prod.outlook.com/ Signed-off-by: Bruce Richardson Acked-by: Tyler Retzlaff Acked-by: Aaron Conole Acked-by: Jerin Jacob Acked-by: Thomas Monjalon --- V3: - add additional detail following discussion on-list V2: - add requirement for stdatomics - fix sphinx formatting --- doc/guides/rel_notes/deprecation.rst | 18 ++++++++++++++++++ 1 file changed, 18 insertions(+) diff --git a/doc/guides/rel_notes/deprecation.rst b/doc/guides/rel_notes/deprecation.rst index dcc1ca1696..6955f02248 100644 --- a/doc/guides/rel_notes/deprecation.rst +++ b/doc/guides/rel_notes/deprecation.rst @@ -11,6 +11,24 @@ here. Deprecation Notices ------------------- +* C Compiler: From DPDK 23.11 onwards, + building DPDK will require a C compiler which supports the C11 standard, + including support for C11 standard atomics. + + More specifically, the requirements will be: + + * Support for flag "-std=c11" (or similar) + * __STDC_NO_ATOMICS__ is *not defined* when using c11 flag + + Please note: + + * C11, including standard atomics, is supported from GCC version 5 onwards, + and is the default language version in that release + (Ref: https://gcc.gnu.org/gcc-5/changes.html) + * C11 is the default compilation mode in Clang from version 3.6, + which also added support for standard atomics + (Ref: https://releases.llvm.org/3.6.0/tools/clang/docs/ReleaseNotes.html) + * kvargs: The function ``rte_kvargs_process`` will get a new parameter for returning key match count. It will ease handling of no-match case.