{"id":2226634,"url":"http://patchwork.ozlabs.org/api/patches/2226634/?format=json","web_url":"http://patchwork.ozlabs.org/project/uboot/patch/20260422170946.3394481-2-rs@ti.com/","project":{"id":18,"url":"http://patchwork.ozlabs.org/api/projects/18/?format=json","name":"U-Boot","link_name":"uboot","list_id":"u-boot.lists.denx.de","list_email":"u-boot@lists.denx.de","web_url":null,"scm_url":null,"webscm_url":null,"list_archive_url":"","list_archive_url_format":"","commit_url_format":""},"msgid":"<20260422170946.3394481-2-rs@ti.com>","list_archive_url":null,"date":"2026-04-22T17:09:41","name":"[PATCHv5,1/6] lmb: allocation flags macro documentation","commit_ref":null,"pull_url":null,"state":"new","archived":false,"hash":"fa6e65c148d858fe245c9f8c4dcc03ede15cd87c","submitter":{"id":88727,"url":"http://patchwork.ozlabs.org/api/people/88727/?format=json","name":"Randolph Sapp","email":"rs@ti.com"},"delegate":{"id":68728,"url":"http://patchwork.ozlabs.org/api/users/68728/?format=json","username":"xypron","first_name":"Heinrich","last_name":"Schuchardt","email":"xypron.glpk@gmx.de"},"mbox":"http://patchwork.ozlabs.org/project/uboot/patch/20260422170946.3394481-2-rs@ti.com/mbox/","series":[{"id":501048,"url":"http://patchwork.ozlabs.org/api/series/501048/?format=json","web_url":"http://patchwork.ozlabs.org/project/uboot/list/?series=501048","date":"2026-04-22T17:09:42","name":"various memory related fixups","version":1,"mbox":"http://patchwork.ozlabs.org/series/501048/mbox/"}],"comments":"http://patchwork.ozlabs.org/api/patches/2226634/comments/","check":"pending","checks":"http://patchwork.ozlabs.org/api/patches/2226634/checks/","tags":{},"related":[],"headers":{"Return-Path":"","X-Original-To":"incoming@patchwork.ozlabs.org","Delivered-To":"patchwork-incoming@legolas.ozlabs.org","Authentication-Results":["legolas.ozlabs.org;\n\tdkim=pass (1024-bit key;\n unprotected) header.d=ti.com header.i=@ti.com header.a=rsa-sha256\n header.s=selector1 header.b=LWy2DR2g;\n\tdkim-atps=neutral","legolas.ozlabs.org;\n spf=pass (sender SPF authorized) smtp.mailfrom=lists.denx.de\n (client-ip=2a01:238:438b:c500:173d:9f52:ddab:ee01; helo=phobos.denx.de;\n envelope-from=u-boot-bounces@lists.denx.de; receiver=patchwork.ozlabs.org)","phobos.denx.de;\n dmarc=pass (p=quarantine dis=none) header.from=ti.com","phobos.denx.de;\n spf=pass smtp.mailfrom=u-boot-bounces@lists.denx.de","phobos.denx.de;\n\tdkim=pass (1024-bit key;\n unprotected) header.d=ti.com header.i=@ti.com header.b=\"LWy2DR2g\";\n\tdkim-atps=neutral","phobos.denx.de;\n dmarc=pass (p=quarantine dis=none) header.from=ti.com","phobos.denx.de; spf=pass smtp.mailfrom=rs@ti.com"],"Received":["from phobos.denx.de (phobos.denx.de\n [IPv6:2a01:238:438b:c500:173d:9f52:ddab:ee01])\n\t(using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)\n\t key-exchange x25519)\n\t(No client certificate requested)\n\tby legolas.ozlabs.org (Postfix) with ESMTPS id 4g15Mr3SLXz1y2d\n\tfor ; Thu, 23 Apr 2026 03:10:48 +1000 (AEST)","from h2850616.stratoserver.net (localhost [IPv6:::1])\n\tby phobos.denx.de (Postfix) with ESMTP id E2F32843FB;\n\tWed, 22 Apr 2026 19:10:17 +0200 (CEST)","by phobos.denx.de (Postfix, from userid 109)\n id EEB7E84370; Wed, 22 Apr 2026 19:10:09 +0200 (CEST)","from SJ2PR03CU001.outbound.protection.outlook.com\n (mail-westusazlp170120002.outbound.protection.outlook.com\n [IPv6:2a01:111:f403:c001::2])\n (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits))\n (No client certificate requested)\n by phobos.denx.de (Postfix) with ESMTPS id 8FF78843C5\n for ; Wed, 22 Apr 2026 19:10:07 +0200 (CEST)","from DS7PR03CA0322.namprd03.prod.outlook.com (2603:10b6:8:2b::29) by\n DM6PR10MB4251.namprd10.prod.outlook.com (2603:10b6:5:21d::13) with\n Microsoft\n SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id\n 15.20.9846.20; Wed, 22 Apr 2026 17:10:01 +0000","from CY4PEPF0000EDD7.namprd03.prod.outlook.com\n (2603:10b6:8:2b:cafe::d) by DS7PR03CA0322.outlook.office365.com\n (2603:10b6:8:2b::29) with Microsoft SMTP Server (version=TLS1_3,\n cipher=TLS_AES_256_GCM_SHA384) id 15.20.9791.48 via Frontend Transport; Wed,\n 22 Apr 2026 17:10:01 +0000","from lewvzet201.ext.ti.com (198.47.23.195) by\n CY4PEPF0000EDD7.mail.protection.outlook.com (10.167.241.203) with Microsoft\n SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id\n 15.20.9846.18 via Frontend Transport; Wed, 22 Apr 2026 17:09:57 +0000","from DLEE208.ent.ti.com (157.170.170.97) by lewvzet201.ext.ti.com\n (10.4.14.104) with Microsoft SMTP Server (version=TLS1_2,\n cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.2.2562.20; Wed, 22 Apr\n 2026 12:09:57 -0500","from DLEE205.ent.ti.com (157.170.170.85) by DLEE208.ent.ti.com\n (157.170.170.97) with Microsoft SMTP Server (version=TLS1_2,\n cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.2.2562.20; Wed, 22 Apr\n 2026 12:09:57 -0500","from lelvem-mr05.itg.ti.com (10.180.75.9) by DLEE205.ent.ti.com\n (157.170.170.85) with Microsoft SMTP Server (version=TLS1_2,\n cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.2.2562.20 via Frontend\n Transport; Wed, 22 Apr 2026 12:09:57 -0500","from rs-desk.dhcp.ti.com (rs-desk.dhcp.ti.com [128.247.81.39])\n by lelvem-mr05.itg.ti.com (8.18.1/8.18.1) with ESMTP id 63MH9uPL2769561;\n Wed, 22 Apr 2026 12:09:57 -0500"],"X-Spam-Checker-Version":"SpamAssassin 3.4.2 (2018-09-13) on phobos.denx.de","X-Spam-Level":"","X-Spam-Status":"No, score=-1.1 required=5.0 tests=BAYES_00,DKIMWL_WL_HIGH,\n DKIM_SIGNED,DKIM_VALID,DKIM_VALID_AU,DKIM_VALID_EF,FORGED_SPF_HELO,\n RCVD_IN_DNSWL_BLOCKED,SPF_HELO_PASS,T_SPF_PERMERROR autolearn=no\n autolearn_force=no version=3.4.2","ARC-Seal":"i=1; a=rsa-sha256; s=arcselector10001; d=microsoft.com; cv=none;\n b=cayies+RJoIsLLtliOzAUQt+MuoWXzYGGcAMTGZThGnb81BUjPZj9zUwYo+8r5uSs2Gd7JBnXTuITX+uWy22ltEOaXfL4hx3BTrvTxeGuQvq0bEw8852IJUeyfB8h7iOJPLNuGkYhrffWZ5bMMfORWcbvMg+jsVIs2ARh9GbMPnzlAuCZ6iAk1To1ptpkrjWYB5EGvRpD0R6nClajT8zVDScnsdDl2UMqSX6fbF6rLR7kJOGuxg9TtdE0HXhgKjwRAIBjj1bp2NwRyXqWKv8TzGyuJFguhGkwAUbwYL1c5SXqOqvkr2GupKlAUuyJTuJAmez9W+vrwHc/Rvb9trNiQ==","ARC-Message-Signature":"i=1; a=rsa-sha256; c=relaxed/relaxed; d=microsoft.com;\n s=arcselector10001;\n h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-AntiSpam-MessageData-ChunkCount:X-MS-Exchange-AntiSpam-MessageData-0:X-MS-Exchange-AntiSpam-MessageData-1;\n bh=TPQEel4MmKWS16hH+JoHX9OgeVT3Jy8Rj7QqUqrZxuQ=;\n b=KMEyUWu60akxwj6EkeN7Dnu4tLR+ZPJIXQ/a4MEKsLOOEj1lF01jKTxpH52VifaqG1LM0MyrvsnQzWjSjnw/X62TGSuLt8zg/MLwk93nE6xifR9S5cea8KErqOBcgve0po6zIyprxf2erWxqowCtsBW/gxhUNUK9OdOrqDHqcVW5mK+lw8K90nYypC92Ei2rO7ZiqsL4HKr6n4UXZ49YBY5VePeEbEiB2yQveqjFjCuQXadhMatXrD4LwVD8Ks1ZimuE0eGHZC1ZE7GqMX/QDU9qnltK6NkJgOTlnZ5NJ69ABIFMI9CWEUnzooDOzQpjU/6EI2CQK9ehOO/DJAUxhg==","ARC-Authentication-Results":"i=1; mx.microsoft.com 1; spf=pass (sender ip is\n 198.47.23.195) smtp.rcpttodomain=lists.denx.de smtp.mailfrom=ti.com;\n dmarc=pass (p=quarantine sp=none pct=100) action=none header.from=ti.com;\n dkim=none (message not signed); arc=none (0)","DKIM-Signature":"v=1; a=rsa-sha256; c=relaxed/relaxed; d=ti.com; s=selector1;\n h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck;\n bh=TPQEel4MmKWS16hH+JoHX9OgeVT3Jy8Rj7QqUqrZxuQ=;\n b=LWy2DR2g1olyynTVrshLzSN8QGs5qnhhPulKVQyFVyJxXOQxYWUqBnVNPuerDEmpGzXEB8cucemG10/LKS+LYiF5Ug0PhW0fIjTlUPNW9YmeHG2ejSteM7t/tsSxHkbeBCjDXYO/hnwGS9/z1qRs0O7YDBjDTShWxL0uGNS7UWU=","X-MS-Exchange-Authentication-Results":"spf=pass (sender IP is 198.47.23.195)\n smtp.mailfrom=ti.com; dkim=none (message not signed) header.d=none;\n dmarc=pass\n action=none header.from=ti.com;","Received-SPF":"Pass (protection.outlook.com: domain of ti.com designates\n 198.47.23.195 as permitted sender) receiver=protection.outlook.com;\n client-ip=198.47.23.195; helo=lewvzet201.ext.ti.com; pr=C","From":"","To":", ,\n , , ,\n , , ,\n ","CC":"","Subject":"[PATCHv5 1/6] lmb: allocation flags macro documentation","Date":"Wed, 22 Apr 2026 12:09:41 -0500","Message-ID":"<20260422170946.3394481-2-rs@ti.com>","X-Mailer":"git-send-email 2.53.0","In-Reply-To":"<20260422170946.3394481-1-rs@ti.com>","References":"<20260422170946.3394481-1-rs@ti.com>","MIME-Version":"1.0","Content-Transfer-Encoding":"8bit","Content-Type":"text/plain","X-C2ProcessedOrg":"333ef613-75bf-4e12-a4b1-8e3623f5dcea","X-EOPAttributedMessage":"0","X-MS-PublicTrafficType":"Email","X-MS-TrafficTypeDiagnostic":"CY4PEPF0000EDD7:EE_|DM6PR10MB4251:EE_","X-MS-Office365-Filtering-Correlation-Id":"cc8aff14-3a0b-4649-58cc-08dea091fb14","X-MS-Exchange-SenderADCheck":"1","X-MS-Exchange-AntiSpam-Relay":"0","X-Microsoft-Antispam":"BCL:0;\n ARA:13230040|376014|1800799024|82310400026|36860700016|18002099003|22082099003|56012099003;","X-Microsoft-Antispam-Message-Info":"\n zdjw6liZh6JlW59mu95fIdDgVsY5VH8yGuIiIrQDfS9I7Ow4XywD2ZcUyjZ0GclNBbXG0wYkOlbeU07RYDnWeD7y4qhgUVx735iCBebvt2u3DX9/iljbN/+HiCsCQjM/aNVU1rmF0RitDrCgbmJVSDt/z/nJEj/MjuJObaMqMfC+XwPEL586isWGjKQQu8P7oCMMsyzDC1Hy7Oo3J3AZOiD/6z9RGdcCU3bcTOHGwVLqF7AZkDym2UDrlj3VFuaqjp2mqIGdmixdcm7bhTwFYRvlQZ0eSKimE5XfUXVvyiKRTJMgKgAMpjC0Ds98QgoeIIO8RKauL7TnenuiVuW79cXLhl8/mdUXsuNiTriCOeZvXFhSPagXBZdjiBI2C2CpLo327aNW+7SQ3c1BSqWRSwWPXltKdSL75CFaZJHwN+1DKeinQkg/RB0/kQv9k+0HAZ8pKR3OizN+S4e14aGuE1rEwgMifLdaTR0EakcM0Ai2aKTsO5dRW21XpODqfi2HsZ9RmZjQKziPoGCWjmm3aI5ovLZxI8SMuYaL/TaYt/F3YgKKXHebmimEPXQ7+EbwjyM/C6x62rvOkozLpPVXs7yaWX2MJcu9gsCEQfulJuzmH+IcFWzU6mxMufkSQiH/ArEJMF05k+46IX6bXKhyNsOMEeoqw1VQNo5qKgDBX1gLXfxFXGtaBgnpx4u++fS6UHAjXC5JQmbwnVogX2CPkanp0UJUiIY1bHJtTbcYdG4ghCsx4eIxyZ0H9zd1GO6Z7s4cjR8Q7ksro06TEUZUTQ==","X-Forefront-Antispam-Report":"CIP:198.47.23.195; CTRY:US; LANG:en; SCL:1; SRV:;\n IPV:NLI; SFV:NSPM; H:lewvzet201.ext.ti.com; PTR:InfoDomainNonexistent;\n CAT:NONE;\n SFS:(13230040)(376014)(1800799024)(82310400026)(36860700016)(18002099003)(22082099003)(56012099003);\n DIR:OUT; SFP:1101;","X-MS-Exchange-AntiSpam-MessageData-ChunkCount":"1","X-MS-Exchange-AntiSpam-MessageData-0":"\n U+/NwEfe5tVWuXOVtWzZu5SXY5SW0RAQ66uXytD23fz4COnrP6W0AWN2SjG4FoHVWftzKTFiyL7O8Z/kg4zc1GgQjOOWdQv2dwthdTAa/inzEU9x74gWVUxEbxhzWTZuONTVj4zJr76uY/XIdV6o575x5IholF0bBbc2cSvC2S6BI/qvbsiLhcKWKIIbL3nRvepqjEa+tS6IZsteifmxtVA+WsOX4RxBUKPH1nKk9or1J8+eam9BEU55QX4pjP1uY6xekTS/dbTb3ufXOL2USCBzpeUdcULH6utwCLgN1CQcFDgOZOsT5oyr+JQIXQuefojRnBi6k0IYSqaYpWnjk4X5rZUQdzwTuHo4MxMpLud83qa5xpJlP+o/S8RyCGVakR3b9gTjVH0VYjAMJpnE6owJSq2ZemKVH9QadKSwr33RcB7ei2N9VumbUugpGC3j","X-OriginatorOrg":"ti.com","X-MS-Exchange-CrossTenant-OriginalArrivalTime":"22 Apr 2026 17:09:57.5471 (UTC)","X-MS-Exchange-CrossTenant-Network-Message-Id":"\n cc8aff14-3a0b-4649-58cc-08dea091fb14","X-MS-Exchange-CrossTenant-Id":"e5b49634-450b-4709-8abb-1e2b19b982b7","X-MS-Exchange-CrossTenant-OriginalAttributedTenantConnectingIp":"\n TenantId=e5b49634-450b-4709-8abb-1e2b19b982b7; Ip=[198.47.23.195];\n Helo=[lewvzet201.ext.ti.com]","X-MS-Exchange-CrossTenant-AuthSource":"\n CY4PEPF0000EDD7.namprd03.prod.outlook.com","X-MS-Exchange-CrossTenant-AuthAs":"Anonymous","X-MS-Exchange-CrossTenant-FromEntityHeader":"HybridOnPrem","X-MS-Exchange-Transport-CrossTenantHeadersStamped":"DM6PR10MB4251","X-BeenThere":"u-boot@lists.denx.de","X-Mailman-Version":"2.1.39","Precedence":"list","List-Id":"U-Boot discussion ","List-Unsubscribe":",\n ","List-Archive":"","List-Post":"","List-Help":"","List-Subscribe":",\n ","Errors-To":"u-boot-bounces@lists.denx.de","Sender":"\"U-Boot\" ","X-Virus-Scanned":"clamav-milter 0.103.8 at phobos.denx.de","X-Virus-Status":"Clean"},"content":"From: Randolph Sapp \n\nUpdate the allocation flags inline documentation to follow the kernel\nobject like macro documentation specification.\n\nUse active voice for the short descriptions.\n\nSigned-off-by: Randolph Sapp \nReviewed-by: Ilias Apalodimas \nReviewed-by: Simon Glass \n---\n include/lmb.h | 30 +++++++++++++++++++++++++-----\n 1 file changed, 25 insertions(+), 5 deletions(-)","diff":"diff --git a/include/lmb.h b/include/lmb.h\nindex 5d5f037ccb9..ed472e9ef2e 100644\n--- a/include/lmb.h\n+++ b/include/lmb.h\n@@ -19,16 +19,36 @@\n #define LMB_ALIST_INITIAL_SIZE\t4\n \n /**\n- * DOC: Memory region attribute flags.\n+ * define LMB_NONE - no special request\n *\n- * %LMB_NONE: No special request\n- * %LMB_NOMAP: Don't add to MMU configuration\n- * %LMB_NOOVERWRITE: The memory region cannot be overwritten/re-reserved\n- * %LMB_NONOTIFY: Do not notify other modules of changes to this memory region\n+ * LMB Memory region attribute flag to indicate that there are no special\n+ * requests for this region. Normally used as a placeholder value.\n */\n #define LMB_NONE 0\n+\n+/**\n+ * define LMB_NOMAP - do not add to MMU configuration\n+ *\n+ * LMB Memory region attribute flag to indicate that the region will not be\n+ * mapped by LMB. Normally used for reserved regions.\n+ */\n #define LMB_NOMAP BIT(1)\n+\n+/**\n+ * define LMB_NOOVERWRITE - do not overwrite/re-reserve\n+ *\n+ * LMB Memory region attribute flag to indicate that the region will not be\n+ * overwritten or re-reserved. Normally used for reserved regions.\n+ */\n #define LMB_NOOVERWRITE BIT(2)\n+\n+/**\n+ * define LMB_NONOTIFY - do not notify other modules of changes\n+ *\n+ * LMB Memory region attribute flag to indicate that the region will not notify\n+ * downstream allocators (currently just the EFI allocator) of changes to this\n+ * region through lmb_map_update_notify().\n+ */\n #define LMB_NONOTIFY BIT(3)\n \n /**\n","prefixes":["PATCHv5","1/6"]}