{"id":2225276,"url":"http://patchwork.ozlabs.org/api/patches/2225276/?format=json","web_url":"http://patchwork.ozlabs.org/project/uboot/patch/20260420192520.1444749-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":"<20260420192520.1444749-2-rs@ti.com>","list_archive_url":null,"date":"2026-04-20T19:25:15","name":"[PATCHv4,1/6] lmb: allocation flags macro documentation","commit_ref":null,"pull_url":null,"state":"superseded","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/20260420192520.1444749-2-rs@ti.com/mbox/","series":[{"id":500668,"url":"http://patchwork.ozlabs.org/api/series/500668/?format=json","web_url":"http://patchwork.ozlabs.org/project/uboot/list/?series=500668","date":"2026-04-20T19:25:18","name":"various memory related fixups","version":1,"mbox":"http://patchwork.ozlabs.org/series/500668/mbox/"}],"comments":"http://patchwork.ozlabs.org/api/patches/2225276/comments/","check":"pending","checks":"http://patchwork.ozlabs.org/api/patches/2225276/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=xfuYRzVS;\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=\"xfuYRzVS\";\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 server-signature ECDSA (secp384r1) server-digest SHA384)\n\t(No client certificate requested)\n\tby legolas.ozlabs.org (Postfix) with ESMTPS id 4fzwSf1W7Pz1yHB\n\tfor ; Tue, 21 Apr 2026 05:25:54 +1000 (AEST)","from h2850616.stratoserver.net (localhost [IPv6:::1])\n\tby phobos.denx.de (Postfix) with ESMTP id 40D9E84366;\n\tMon, 20 Apr 2026 21:25:36 +0200 (CEST)","by phobos.denx.de (Postfix, from userid 109)\n id AA2C38439E; Mon, 20 Apr 2026 21:25:33 +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 9C9798435B\n for ; Mon, 20 Apr 2026 21:25:30 +0200 (CEST)","from MW4PR04CA0317.namprd04.prod.outlook.com (2603:10b6:303:82::22)\n by SA1PR10MB6413.namprd10.prod.outlook.com (2603:10b6:806:258::21)\n with Microsoft SMTP Server (version=TLS1_2,\n cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.9818.32; Mon, 20 Apr\n 2026 19:25:24 +0000","from MWH0EPF000C6193.namprd02.prod.outlook.com\n (2603:10b6:303:82:cafe::b8) by MW4PR04CA0317.outlook.office365.com\n (2603:10b6:303:82::22) with Microsoft SMTP Server (version=TLS1_3,\n cipher=TLS_AES_256_GCM_SHA384) id 15.20.9791.48 via Frontend Transport; Mon,\n 20 Apr 2026 19:25:24 +0000","from lewvzet201.ext.ti.com (198.47.23.195) by\n MWH0EPF000C6193.mail.protection.outlook.com (10.167.249.107) with Microsoft\n SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id\n 15.20.9791.48 via Frontend Transport; Mon, 20 Apr 2026 19:25:24 +0000","from DLEE213.ent.ti.com (157.170.170.116) 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; Mon, 20 Apr\n 2026 14:25:23 -0500","from DLEE204.ent.ti.com (157.170.170.84) by DLEE213.ent.ti.com\n (157.170.170.116) with Microsoft SMTP Server (version=TLS1_2,\n cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.2.2562.20; Mon, 20 Apr\n 2026 14:25:23 -0500","from lelvem-mr05.itg.ti.com (10.180.75.9) by DLEE204.ent.ti.com\n (157.170.170.84) 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; Mon, 20 Apr 2026 14:25:23 -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 63KJPNh43399024;\n Mon, 20 Apr 2026 14:25:23 -0500"],"X-Spam-Checker-Version":"SpamAssassin 3.4.2 (2018-09-13) on phobos.denx.de","X-Spam-Level":"","X-Spam-Status":"No, score=-2.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=ham\n autolearn_force=no version=3.4.2","ARC-Seal":"i=1; a=rsa-sha256; s=arcselector10001; d=microsoft.com; cv=none;\n b=F+NNudGmsqvdwhIybUhEk+4y7qRk9BZJ3UjaPHvhWD1ixpaUp3PXetHQpPqw8G1i9Qv0mvwyjQcglcFRB2IwHax5/UdOe5kjToTaKpicVMRpDiert9qrgysdWvBqjR9etRRJsXnq52RzRLAvXQWg87fsy07XC9GFEaoWmBt7sfiYxHvWDDEX5Cgukja8LCQom3FiAj91x6T2+5FS/z9csJrIZIz9mHukK3jDJAH3foFQ6LHTaGpb1Y4EmMEAGJpFSd9ad6aFlrU18YB3gdk6Pi3ZKsjTz/dPLAbOkM+GX/rE0EDGHnn2I42t17tYj4JpwHE3iXe6Ge3SEig/G4O1Gg==","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=MXDloI1kWfNskPImrOGto0uHPd4VQM+HoEUhXTjC7DI=;\n b=YnsIJ/rPB1Cxjz2fRH75yj7Du+Nvwv7Cp4XOP1bMTE0bRvwhEaCLvwBIcWcgkrQ5KJmy+j4Iw0TeaosZQo+1Vlmrc0YQySUhmkGVOuLx+EK/KjmOSFMB2TXV4MdmtjahD0edTxq+x/eGsfSIi8gVeBUUGTl2SnFWXy9Bc693hjCaJeWFCgLZCmzvDXb04QvyB3NlX55VQKp+GbBQZFvLL5GZ9CJm0utIqmFDyRtW+hTJ7G9WZdDdf0MwP2QoS+OHB8JdMSKCalUyi+7L6Ebkx1RKezzce2u4ioNeiVA5szQXeT1ai91jwnkqoTp1awufQIfszxTuyo70flBn3u7c6g==","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=MXDloI1kWfNskPImrOGto0uHPd4VQM+HoEUhXTjC7DI=;\n b=xfuYRzVSGB39GklDUJJdD9zQTO32OyrNLQ+vX+kvztIyhMMqRKGJjJz1bLc73wyp5dyiM/q/EDYUBBFOIFdGImrW2uFa0HZADnXTV9o7AI0UAnPK4Pcn1O3Q0KbU6uylZXsDSAMuqMedSeFRRnJrcHu9AaKN2AnjrXeWjiX18+U=","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":"[PATCHv4 1/6] lmb: allocation flags macro documentation","Date":"Mon, 20 Apr 2026 14:25:15 -0500","Message-ID":"<20260420192520.1444749-2-rs@ti.com>","X-Mailer":"git-send-email 2.53.0","In-Reply-To":"<20260420192520.1444749-1-rs@ti.com>","References":"<20260420192520.1444749-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":"MWH0EPF000C6193:EE_|SA1PR10MB6413:EE_","X-MS-Office365-Filtering-Correlation-Id":"a43f76ed-249f-4ec3-ce83-08de9f129225","X-MS-Exchange-SenderADCheck":"1","X-MS-Exchange-AntiSpam-Relay":"0","X-Microsoft-Antispam":"BCL:0;\n ARA:13230040|82310400026|36860700016|376014|1800799024|56012099003|22082099003|18002099003;","X-Microsoft-Antispam-Message-Info":"\n CO0yK+7j+aEzk5//ATRwXQMto/TfALKQk9Sjn8eIUZNe2zkNduArpr4Bd0u/I3TCkhmM2lcOLI+ZjHEtVQ6It3jrL4MbToKRLc0TkUaS7kp1HZNYMIq/arwB65wFwEX9Yxj1mKh/Vf2dFZloiNooHGg8PmNhbczrlvZiOEOskWSMIVvU83A3ry30ru5sPkltj4JYe7LKBJeqPH50viw/dOYFiYyuRpIzK5Zd51JkEitIAhHsdDMSq6HgtuY36CzjH3nQMEPxmdvBrQtYRypC0JocsABNKY12AUQvnXoMeXbWlDZkq9PZRUNjdycPVw/54mP7OiM49p8xqjve/NZwzaHU9TopTb4uVUwNSZXzn8zG8rKLDcnisbnZ868VKK7HxmTF5Svq0KKOUdeA11i64LtWidj7loxPth/CDvwnsssdVfUgFuXGzpgXvr8KJJqrXbpunv0VRT1nEpDaUr9NkweuN5xNxiJsPLSzrEZGaPMvyf72oPLz9e8HRvqeA61wMrX9v4z4EDYqWyNehMTtqPUCjdtqgPoC097IsirIw/ddK2Oabpmrog+y1b1HtUaIhae53mL5qaDBwyRLrtOq7SdYc80XSWSHbWJBNtda9l1FZQVooLYNzY4PArQ5a29hZmJafkzD06EEnz9COvfO2IyHUoy5+mhgqQ9DwdD1d+MDzE6ctsbALifneLS2uwcSK1Acf5lsYVR07JZvDfQrpWBNw+3CJH5v+YAsOZw73SIU8eQEHZ+8+YF+aOdsWWD4ZtVszIsi6pKQBR8MUkDdlg==","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)(82310400026)(36860700016)(376014)(1800799024)(56012099003)(22082099003)(18002099003);\n DIR:OUT; SFP:1101;","X-MS-Exchange-AntiSpam-MessageData-ChunkCount":"1","X-MS-Exchange-AntiSpam-MessageData-0":"\n EwExxjKTdfBSaplAPf/XG3rPtWCTyDcqZSSb/d+MXoOD2UMT7RJLZb4Wx8C4B7hNuL0UGODBV1Qtyoj7OQA6RbNRNwOk8qX6Mmxqpy2Dv+VWwkoWiH8FMYublR6m4bXZBHgxKe6dvtJZ7ftuUt66rb4ndPBdQeD+J96ch/6xqe/+7MGegtWbVIFErif+rE5+hzno+ifR3Uz4j+X9I7+7l/qPrLujsX8kfCAOWBnYIxRwFc+cUVDBhbRK6/42iOx5CkzU8UaL864fIDWIHYprQUNhxOMs6S7dAgPD+DVYe5dl56OsJehPbG1bqQ3wseyZaE5FSgr/Ufx7KsAROoIgmJ3J4qqgNLxn1H+/B5HHV7uFdcgqozyekXNcf+rufNFa1UmfGAGkW2LrP1pT6QLPK5psGN0Bg4yEcV0056iSciNsWKfpETYxyTI4z5fCMF1m","X-OriginatorOrg":"ti.com","X-MS-Exchange-CrossTenant-OriginalArrivalTime":"20 Apr 2026 19:25:24.2083 (UTC)","X-MS-Exchange-CrossTenant-Network-Message-Id":"\n a43f76ed-249f-4ec3-ce83-08de9f129225","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 MWH0EPF000C6193.namprd02.prod.outlook.com","X-MS-Exchange-CrossTenant-AuthAs":"Anonymous","X-MS-Exchange-CrossTenant-FromEntityHeader":"HybridOnPrem","X-MS-Exchange-Transport-CrossTenantHeadersStamped":"SA1PR10MB6413","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 \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":["PATCHv4","1/6"]}