From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org Received: from gabe.freedesktop.org (gabe.freedesktop.org [131.252.210.177]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.lore.kernel.org (Postfix) with ESMTPS id 52CABC04FFE for ; Thu, 2 May 2024 19:56:48 +0000 (UTC) Received: from gabe.freedesktop.org (localhost [127.0.0.1]) by gabe.freedesktop.org (Postfix) with ESMTP id 1450A10F6C4; Thu, 2 May 2024 19:56:48 +0000 (UTC) Authentication-Results: gabe.freedesktop.org; dkim=pass (2048-bit key; unprotected) header.d=intel.com header.i=@intel.com header.b="LTqFDK0G"; dkim-atps=neutral Received: from mgamail.intel.com (mgamail.intel.com [198.175.65.20]) by gabe.freedesktop.org (Postfix) with ESMTPS id EF7BB10F64C for ; Thu, 2 May 2024 19:56:45 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=intel.com; i=@intel.com; q=dns/txt; s=Intel; t=1714679806; x=1746215806; h=from:to:cc:subject:date:message-id:in-reply-to: references:mime-version:content-transfer-encoding; bh=WSDIPvDjIL7ZQVzW9jKb5QKwZmSIJt+lkao5NnJzogw=; b=LTqFDK0G6GLcfrvf5yOKM3bTYndp4nKmFQUREfvSJYUPHNhyjlRFtD1j AGxustGxevlA5CdhfXjDNtm5ZMlH7StXfGRcAzPXs5w+oBNbvZrO9II/Y mR0zdSQul6nIyoK91oVrqa98FCFZ4h08Ed4ww4O/MVyMZGf8P6+YKyo/k Y4eGfxrql8AUhcnJFIqstJ7Nyu/89E0FqEQc26WvQ1uEnev++CwtVFe5H 7652r03Ej+Vq8jvqNxjlj1TUlQfoOL/7XYzlb9XLSmUme5jtXjyBuP1fD A4+z49RHZw5MGGO4gooozbQQG6Za1fCSq0AcF/UQy/U09R5Lh6ZdmRlyN g==; X-CSE-ConnectionGUID: ZDx4It2bQAeF0DOts5/K3g== X-CSE-MsgGUID: Ovb1MkTTToaAr9yLPVv0qQ== X-IronPort-AV: E=McAfee;i="6600,9927,11062"; a="10296669" X-IronPort-AV: E=Sophos;i="6.07,247,1708416000"; d="scan'208";a="10296669" Received: from orviesa001.jf.intel.com ([10.64.159.141]) by orvoesa112.jf.intel.com with ESMTP/TLS/ECDHE-RSA-AES256-GCM-SHA384; 02 May 2024 12:56:38 -0700 X-CSE-ConnectionGUID: i6uU0XLlSMeRsh5r0aDE3Q== X-CSE-MsgGUID: nHqiZz1qTd66EplGxLvMMQ== X-ExtLoop1: 1 X-IronPort-AV: E=Sophos;i="6.07,247,1708416000"; d="scan'208";a="64670651" Received: from mwajdecz-mobl.ger.corp.intel.com ([10.246.17.255]) by smtpauth.intel.com with ESMTP/TLS/ECDHE-RSA-AES256-GCM-SHA384; 02 May 2024 12:56:37 -0700 From: Michal Wajdeczko To: intel-xe@lists.freedesktop.org Cc: Michal Wajdeczko , Andy Shevchenko , Lucas De Marchi Subject: [PATCH v2 1/2] drm/xe: Add helpers for manipulating macro arguments Date: Thu, 2 May 2024 21:56:18 +0200 Message-Id: <20240502195619.2483-2-michal.wajdeczko@intel.com> X-Mailer: git-send-email 2.21.0 In-Reply-To: <20240502195619.2483-1-michal.wajdeczko@intel.com> References: <20240502195619.2483-1-michal.wajdeczko@intel.com> MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-BeenThere: intel-xe@lists.freedesktop.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: Intel Xe graphics driver List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: intel-xe-bounces@lists.freedesktop.org Sender: "Intel-xe" Define generic helpers that will replace private definitions used by the RTP code and will allow reuse by the new code. Put them in new xe_args.h file (instead of infamous xe_macros.h) as once we find more potential users outside of the Xe driver we may want to move all of these macros as-is to linux/args.h. Signed-off-by: Michal Wajdeczko Cc: Andy Shevchenko Cc: Lucas De Marchi --- v2: don't pollute linux/args.h yet (Andy) --- drivers/gpu/drm/xe/xe_args.h | 114 +++++++++++++++++++++++++++++++++++ 1 file changed, 114 insertions(+) create mode 100644 drivers/gpu/drm/xe/xe_args.h diff --git a/drivers/gpu/drm/xe/xe_args.h b/drivers/gpu/drm/xe/xe_args.h new file mode 100644 index 000000000000..6899fcc9405d --- /dev/null +++ b/drivers/gpu/drm/xe/xe_args.h @@ -0,0 +1,114 @@ +/* SPDX-License-Identifier: MIT */ +/* + * Copyright © 2023 Intel Corporation + */ + +#ifndef _XE_ARGS_H_ +#define _XE_ARGS_H_ + +#include + +/** + * CALL_ARGS - Invoke a macro, but allow parameters to be expanded beforehand. + * @f: name of the macro to invoke + * @args: arguments for the macro + * + * This macro allows calling macros which names might generated or we want to + * make sure it's arguments will be correctly expanded. + * + * Example: + * + * #define foo X,Y,Z,Q + * #define bar COUNT_ARGS(foo) + * #define buz CALL_ARGS(COUNT_ARGS, foo) + * + * With above definitions bar expands to 1 while buz expands to 4. + */ +#define CALL_ARGS(f, args...) __CALL_ARGS(f, args) +#define __CALL_ARGS(f, args...) f(args) + +/** + * DROP_FIRST - Returns all arguments except the first one. + * @args: arguments + * + * This helper macro allows manipulation the argument list before passing it + * to the next level macro. + * + * Example: + * + * #define foo X,Y,Z,Q + * #define bar CALL_ARGS(COUNT_ARGS, DROP_FIRST(foo)) + * + * With above definitions bar expands to 3. + */ +#define DROP_FIRST(args...) __DROP_FIRST(args) +#define __DROP_FIRST(a, b...) b + +/** + * PICK_FIRST - Returns the first argument. + * @args: arguments + * + * This helper macro allows manipulation the argument list before passing it + * to the next level macro. + * + * Example: + * + * #define foo X,Y,Z,Q + * #define bar PICK_FIRST(foo) + * + * With above definitions bar expands to X. + */ +#define PICK_FIRST(args...) __PICK_FIRST(args) +#define __PICK_FIRST(a, b...) a + +/** + * PICK_LAST - Returns the last argument. + * @args: arguments + * + * This helper macro allows manipulation the argument list before passing it + * to the next level macro. + * + * Like COUNT_ARGS() this macro works up to 12 arguments. + * + * Example: + * + * #define foo X,Y,Z,Q + * #define bar PICK_LAST(foo) + * + * With above definitions bar expands to Q. + */ +#define PICK_LAST(args...) __PICK_ARG(COUNT_ARGS(args), args) +#define __PICK_ARG(n, args...) CALL_ARGS(CONCATENATE(PICK_ARG, n), args) +#define PICK_ARG1(args...) PICK_FIRST(args) +#define PICK_ARG2(args...) PICK_ARG1(DROP_FIRST(args)) +#define PICK_ARG3(args...) PICK_ARG2(DROP_FIRST(args)) +#define PICK_ARG4(args...) PICK_ARG3(DROP_FIRST(args)) +#define PICK_ARG5(args...) PICK_ARG4(DROP_FIRST(args)) +#define PICK_ARG6(args...) PICK_ARG5(DROP_FIRST(args)) +#define PICK_ARG7(args...) PICK_ARG6(DROP_FIRST(args)) +#define PICK_ARG8(args...) PICK_ARG7(DROP_FIRST(args)) +#define PICK_ARG9(args...) PICK_ARG8(DROP_FIRST(args)) +#define PICK_ARG10(args...) PICK_ARG9(DROP_FIRST(args)) +#define PICK_ARG11(args...) PICK_ARG10(DROP_FIRST(args)) +#define PICK_ARG12(args...) PICK_ARG11(DROP_FIRST(args)) + +/** + * ARGS_SEP_COMMA - Definition of a comma character. + * + * This definition can be used in cases where any intermediate macro expects + * fixed number of arguments, but we want to pass more arguments which can + * be properly evaluated only by the next level macro. + * + * Example: + * + * #define foo(f) f(X) f(Y) f(Z) f(Q) + * #define bar DROP_FIRST(foo(ARGS_SEP_COMMA __stringify)) + * #define buz CALL_ARGS(COUNT_ARGS, DROP_FIRST(foo(ARGS_SEP_COMMA))) + * + * With above definitions bar expands to + * "X", "Y", "Z", "Q" + * and buz expands to 4. + */ +#define ARGS_SEP_COMMA , + +#endif /* _LINUX_ARGS_H */ -- 2.43.0