Received-SPF: pass (google.com: domain of linux-kernel+bounces-171918-linux.lists.archive=gmail.com@vger.kernel.org designates 147.75.199.223 as permitted sender) client-ip=147.75.199.223;
From: Erick Archer <erick.archer@outlook.com>
To: Kees Cook <keescook@chromium.org>,
	Alexey Dobriyan <adobriyan@gmail.com>,
	Erick Archer <erick.archer@outlook.com>,
	Miguel Ojeda <ojeda@kernel.org>,
	Nathan Chancellor <nathan@kernel.org>,
	Dmitry Antipov <dmantipov@yandex.ru>,
	"Gustavo A. R. Silva" <gustavoars@kernel.org>,
	Justin Stitt <justinstitt@google.com>,
	Sven Eckelmann <sven@narfation.org>
Cc: Alexander Lobakin <aleksander.lobakin@intel.com>,
	linux-kernel@vger.kernel.org,
	linux-hardening@vger.kernel.org
Subject: [PATCH v2] uapi: stddef.h: Provide UAPI macros for __counted_by_{le, be}
Date: Tue,  7 May 2024 19:33:18 +0200
Message-ID:
 <AS8PR02MB72372E45071E8821C07236F78BE42@AS8PR02MB7237.eurprd02.prod.outlook.com>
Content-Transfer-Encoding: 8bit
Content-Type: text/plain
Precedence: bulk
MIME-Version: 1.0
X-MS-Exchange-MessageSentRepresentingType: 1
X-MS-PublicTrafficType: Email
X-MS-TrafficTypeDiagnostic: AS8PR02MB7237:EE_|GV1PR02MB8356:EE_
X-MS-Office365-Filtering-Correlation-Id: 37e67849-0667-4f71-b6c7-08dc6ebbd5dc
X-Microsoft-Antispam:
	BCL:0;ARA:14566002|461199019|1602099003|3412199016|440099019|1710799017;
X-Microsoft-Antispam-Message-Info:
	XgQ6rhZXbr6KoOTUiOOAMqaQwrtn0D+6rCwPs33x6BMYiqQhOrW+5FGgnkXzO3a14YsoZUt3DEC9xpaY8CQTflg5RgCx+XpVWdWYzhDsZHmzJ1LusvsbMt9/qdyLRmjBAKEHarcOiMganJW4yarpZR9rNA5jr0H4nNwUmoMCPt1/GxQQE/AhmTjB6ey5mgdO7m5JISmwRngB4KwO/AYcSS1GcJHi71LSaCg1BSKbCqD83SjVf76Wi51+SALxhgfv7+gOUjWT6wR05tlHtaSRAgngKY8dC3nkoEQNnGRFyCXFVB482QBtTxdOtsJpGV0lgcfCx27urxdjvBVx/tWHGQIteOA+iZTlqOE8xXKgJMtZTPfvjmMgoe96fm/x5WltZ4AcbHUwJDiFeCqEyQsbcoC7dKTvAIgMmmdBUs1BMPlqpV1OfUGGX8hS1WFcaM4iD4Olzy0RF9NokwvemGCOjx0qiTnba62rsYTT8bWvFUMzcpUxnPOKr0//mTO3q31LohpvTePNGjMOXbQx9H8Wknn3W0uC6V749dO/0xeRNFzuWvEVGatouaNLMvX6f5vJ94FNoRfzqi3aLQ8q7dwMjgeIxsTh7n61JLTqZXKBe/5/OcKBN7IyBg9sABTXXVbIRLfBjvyRb/z0byIdCfNXbQIp8SBQSnm6IfuXPNOXdK/DYPq4efAuOpCwtja/D7Gx9OZz9ybkrXA7omQZOs2EEQ==
X-MS-Exchange-AntiSpam-MessageData-ChunkCount: 1
X-MS-Exchange-AntiSpam-MessageData-0:
	=?us-ascii?Q?ZWnb+0twHxtYnUGPINYQKwvGeDVbIBIQ7woB36DWqDfX3q2chZRLPHFEmWjc?=
 =?us-ascii?Q?6DLVW0PZBGTwoxE43nuZT33nsVTSP18BZwVzofPS5UsEZpTlxl28CDB8aeVo?=
 =?us-ascii?Q?aQjiGGeBJkPdyFxwQP19KSNWtKCi2+g31Z7lsnVC0BUHpjXTKP5YiJ+kQBPr?=
 =?us-ascii?Q?R1bF6BBTcEbrO4Gv8PBl1GFeM8dB/5AEG3TaefbYHT+M0CWy58I7pCgA1paG?=
 =?us-ascii?Q?7clMIm4fT6a79kpFGevQ41hu4QRAXLkiAivERZExcSigyc+j+LBP+h5nO4qF?=
 =?us-ascii?Q?DAnik+VHyAyRbweWLgD5uGuroWef2QqN0UgL9AkTFPKAbfbgde1SMO4If4kr?=
 =?us-ascii?Q?K9scVvRYkB1TF4ORtt3JqS8yRIq+l7kxH/Aiq7XEdI+fiskOIERfXmQYH4wh?=
 =?us-ascii?Q?zWejgl5cFT/h6zqenB3FQ1UHIZxOdYco8MRF78XnwNoGwTkG/BYW9YhZE+dq?=
 =?us-ascii?Q?hAoEOUMf2V9upKER9kxG2o9x3ZJS9ajTB7jAYVKpT1ED0fVQ8pxgcyd5KUqA?=
 =?us-ascii?Q?82IjpoMZQWmCca8Q82A5FKFOXAuooHa/BxnmIdx4pv6TNF2v6EQjQwEx9fjH?=
 =?us-ascii?Q?2koQAKcoPaSAMEPDYInZjADUYkg26QqkNl614uKI4xUMArQD8ITXdcN7KrdG?=
 =?us-ascii?Q?0DRYJ/YvuRhfLx7OGbUKNQUjP6GnsL1276VvGqwaY/FaS5kdFZ/0D3mjwtUQ?=
 =?us-ascii?Q?IR9RveuEp+cnnaLK1Ty8rYEBFI7Zk8O8nX+bgtSAxXf8PPJbFJ5n/0cNX/PP?=
 =?us-ascii?Q?js6PQDDjjSRsS9hezoqkd+z1Z9lbw+cWWNvMXe+zhSxkLTxT4ZXjQKEoEpfs?=
 =?us-ascii?Q?wW2EIR7QhiQTBw1p7IldEZ3Sgt/RfFc0I+J8DiBwcGhH2QNO+5hIOkSxx+iS?=
 =?us-ascii?Q?v1o2EzhHptncvxppZkOqAJ9t+jtPL0EeXaUrGMPmzg3lpPhDSO3L86/tdcpa?=
 =?us-ascii?Q?4uOoA+Ve8YkMCSYdbt4UO6YuMAi/c9iX/mmfp+QoFE6RL4O8OS/1i7n2Vdlu?=
 =?us-ascii?Q?ylkFfBmzSWFwCeNWM2G4pd/rjoXUqQ1dO3NlcaOQOj+hbW+WRhBwK2T1Baii?=
 =?us-ascii?Q?FJ3fRKgZ8GL4ciiV/htEiHtTSm1ibAtyBf9ZolcmwJYXxLWf+IAIN5ZpzI4H?=
 =?us-ascii?Q?a0ftTWWS6I57JZjf4nyDLTegicj33tl8vmkXoMd0swxD0n353jAU7Eih+4UE?=
 =?us-ascii?Q?hgmdkZNu19YqGhRyjSefwHLXWPg9/i5zmQAA72v0jMDXVdiSHHTk5yd+WlV0?=
 =?us-ascii?Q?EoGgtxJK0FXJp6wEfZam?=
X-OriginatorOrg: outlook.com
X-MS-Exchange-CrossTenant-Network-Message-Id: 37e67849-0667-4f71-b6c7-08dc6ebbd5dc
X-MS-Exchange-CrossTenant-AuthSource: AS8PR02MB7237.eurprd02.prod.outlook.com
X-MS-Exchange-CrossTenant-AuthAs: Internal
X-MS-Exchange-CrossTenant-OriginalArrivalTime: 07 May 2024 17:33:41.7057
 (UTC)
X-MS-Exchange-CrossTenant-FromEntityHeader: Hosted
X-MS-Exchange-CrossTenant-Id: 84df9e7f-e9f6-40af-b435-aaaaaaaaaaaa
X-MS-Exchange-CrossTenant-RMS-PersistedConsumerOrg:
	00000000-0000-0000-0000-000000000000
X-MS-Exchange-Transport-CrossTenantHeadersStamped: GV1PR02MB8356

This commit can be considered an addition to commit ca7e324e8ad3
("compiler_types: add Endianness-dependent __counted_by_{le,be}") [1].

In the commit referenced above the __counted_by_{le,be}() attributes
were defined based on platform's endianness with the goal to that the
structures contain flexible arrays at the end, and the counter for,
can be annotated with these attributes.

So, this commit only provide UAPI macros for UAPI structs that will
gain annotations for __counted_by_{le, be} attributes. And it is the
previous step to be able to use these attributes in UAPI.

Link: https://lore.kernel.org/r/20240327142241.1745989-2-aleksander.lobakin@intel.com
Suggested-by: Sven Eckelmann <sven@narfation.org>
Signed-off-by: Erick Archer <erick.archer@outlook.com>
---
Changes in v2:
- Add the "Suggested_by:" tag.
- Update the commit message to better explain the goal (Miguel Ojeda).

Previous versions:
v1 -> https://lore.kernel.org/linux-hardening/AS8PR02MB7237CD9ECBF7907AD8B1CC938B1C2@AS8PR02MB7237.eurprd02.prod.outlook.com/

Hi everyone,

The goal of this commit is to be able to accept this another one [1].
And as Kees suggested in this mail [2] we need to land this patch before
the other because we will need __counted_by_be() in UAPI.

[1] https://lore.kernel.org/linux-hardening/AS8PR02MB72371F89D188B047410B755E8B192@AS8PR02MB7237.eurprd02.prod.outlook.com/
[2] https://lore.kernel.org/linux-hardening/202405060924.4001F77D@keescook/
---
 include/uapi/linux/stddef.h | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/include/uapi/linux/stddef.h b/include/uapi/linux/stddef.h
index 2ec6f35cda32..58154117d9b0 100644
--- a/include/uapi/linux/stddef.h
+++ b/include/uapi/linux/stddef.h
@@ -55,4 +55,12 @@
 #define __counted_by(m)
 #endif
 
+#ifndef __counted_by_le
+#define __counted_by_le(m)
+#endif
+
+#ifndef __counted_by_be
+#define __counted_by_be(m)
+#endif
+
 #endif /* _UAPI_LINUX_STDDEF_H */
-- 
2.25.1