From patchwork Wed Sep 5 19:07:50 2018 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Grant Likely X-Patchwork-Id: 10589299 Return-Path: Received: from mail.wl.linuxfoundation.org (pdx-wl-mail.web.codeaurora.org [172.30.200.125]) by pdx-korg-patchwork-2.web.codeaurora.org (Postfix) with ESMTP id 0E143139B for ; Wed, 5 Sep 2018 19:08:53 +0000 (UTC) Received: from mail.wl.linuxfoundation.org (localhost [127.0.0.1]) by mail.wl.linuxfoundation.org (Postfix) with ESMTP id E20EC2A4B6 for ; Wed, 5 Sep 2018 19:08:52 +0000 (UTC) Received: by mail.wl.linuxfoundation.org (Postfix, from userid 486) id D1BA62A56F; Wed, 5 Sep 2018 19:08:52 +0000 (UTC) X-Spam-Checker-Version: SpamAssassin 3.3.1 (2010-03-16) on pdx-wl-mail.web.codeaurora.org X-Spam-Level: X-Spam-Status: No, score=-2.9 required=2.0 tests=BAD_ENC_HEADER,BAYES_00, DKIM_SIGNED,DKIM_VALID,MAILING_LIST_MULTI,RCVD_IN_DNSWL_NONE autolearn=ham version=3.3.1 Received: from bombadil.infradead.org (bombadil.infradead.org [198.137.202.133]) (using TLSv1.2 with cipher AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by mail.wl.linuxfoundation.org (Postfix) with ESMTPS id 8F6312A4B6 for ; Wed, 5 Sep 2018 19:08:48 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=lists.infradead.org; s=bombadil.20170209; h=Sender: Content-Transfer-Encoding:Content-Type:Cc:List-Subscribe:List-Help:List-Post: List-Archive:List-Unsubscribe:List-Id:MIME-Version:Message-Id:Date:Subject:To :From:Reply-To:Content-ID:Content-Description:Resent-Date:Resent-From: Resent-Sender:Resent-To:Resent-Cc:Resent-Message-ID:In-Reply-To:References: List-Owner; bh=4e7Td5MClrdoByg1NbSm0oq9QCmjmS2GZyAoj3ufink=; b=OJV7Ci5FfxI5GE YubCUlWhDIg5OICpIZ3iXSjOkuNwyrzQUySHzkpo7dv2SolWsUAWOzY1LN2vkocLSou5Vwa5b3cqC ndD0YeWimJZn9RUWeZpIyZRsMyRk/6QWKyzNoA+mWX2Ddp/sOUJBpO7rdN5mUz842zCes+rmPcbjU NJHYHB3nimdXzwGxlhdURMZzBe3rW5eZ/jhNYEKQhbY1fHE2oDK48ahcnX3NFCimKhC4MaRC2DEGq +afT7T9lRQk72nsZdo9VKNHQR7jRV9ZVSC9IpRP1gDYMJ8yzXvfhXYFM23FinZhENwuEuWo/az8r1 XdUZk9/hXTMGQUe03dSA==; Received: from localhost ([127.0.0.1] helo=bombadil.infradead.org) by bombadil.infradead.org with esmtp (Exim 4.90_1 #2 (Red Hat Linux)) id 1fxdAQ-00036x-J0; Wed, 05 Sep 2018 19:08:42 +0000 Received: from mail-ve1eur02on0625.outbound.protection.outlook.com ([2a01:111:f400:fe06::625] helo=EUR02-VE1-obe.outbound.protection.outlook.com) by bombadil.infradead.org with esmtps (Exim 4.90_1 #2 (Red Hat Linux)) id 1fxdAM-00035N-7w for linux-arm-kernel@lists.infradead.org; Wed, 05 Sep 2018 19:08:40 +0000 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=armh.onmicrosoft.com; s=selector1-arm-com; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=oHQTdXQFIXZQJNvJPoP8YZu74qbLRrq/PeIYygvt1KQ=; b=Oj/+RqFnTvyY4nHLoeEpnRepHbO/AjKB5Zqyc/Y79HQaE2Ckk5Y5lGsG793ohPQBHZI7hOZjYbchOkSVS2NMw9XQk/2Gndh8zeqGC97oLmeuCc3wL+3Ql12ptfi9tWjwq2Mro5Z3niLmUZ0uzYwbXpgYElbp/kgUjX05AHpZvVc= Authentication-Results: spf=none (sender IP is ) smtp.mailfrom=Grant.Likely@arm.com; Received: from tiffany.arm.com (217.140.96.140) by AM5PR0801MB1746.eurprd08.prod.outlook.com (2603:10a6:203:3b::12) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.1101.16; Wed, 5 Sep 2018 19:08:22 +0000 From: Grant Likely To: linux-efi@vger.kernel.org, linux-kernel@vger.kernel.org, linux-arm-kernel@lists.infradead.org Subject: [PATCH] efi_stub: update documentation on dtb= parameter Date: Wed, 5 Sep 2018 20:07:50 +0100 Message-Id: <20180905190750.4566-1-grant.likely@arm.com> X-Mailer: git-send-email 2.11.0 MIME-Version: 1.0 X-Originating-IP: [217.140.96.140] X-ClientProxiedBy: AM5PR04CA0001.eurprd04.prod.outlook.com (2603:10a6:206:1::14) To AM5PR0801MB1746.eurprd08.prod.outlook.com (2603:10a6:203:3b::12) X-MS-PublicTrafficType: Email X-MS-Office365-Filtering-Correlation-Id: 0370c700-a457-43cc-87bf-08d61362f340 X-MS-Office365-Filtering-HT: Tenant X-Microsoft-Antispam: BCL:0; PCL:0; RULEID:(7020095)(4652040)(8989137)(4534165)(4627221)(201703031133081)(201702281549075)(8990107)(5600074)(711020)(4618075)(2017052603328)(7153060)(7193020); SRVR:AM5PR0801MB1746; X-Microsoft-Exchange-Diagnostics: 1; AM5PR0801MB1746; 3:HC+NMsryCqVktYvve5VA33FgvjQNfqVNoF0r8WhIHMgwJ3ae+FxIOwEwnJJiSGnvQ55v5fomiLgTQB9KC1d76lbcbR2ZF48GytUGqh7HfIvEHBiANOLwOZmx+zAcXcV5b0nwh1yr/75GLLZNk/UccSK93UDitFcoX+s8aiaqTg/DcUMX5Al3bEMsjjMhcaOhvEP8s28dDvdRO8XQA93QO+oU0bWN6jI6jbGye16LiI64O1K+G9z5RTC3zjHEwzjA; 25:Fabbhh1U+bmg2tTqIlipci2n467EfeG5z+t699Iym/3+kL3z1cEj2rdOt27afLTtehKbYNKdTY++wtrnk4Uc4y4+rfQZdBhwgqreIAAfvJk1cO+Pth9Rcd1E4/hSxd7K/j/RFVX9eoSnEgTCw8xjP8AQwZLJD+gQXEaT7+j/5IMXOEWtFKB1bCiW08JsRdcjUxg+RGBQty5PINu/9L/OlH50RRwhpGjVh7Uq/XbR2Ith4bJ2S9HY3jEjobfpKegCiptIOZLTvOQXCw4ztk3mOmyYOQTP2SrH9xlbnhq2Fcn85M0Dcx3saeCPjoLjvBv/AbVBvBgnT/DqTCSHo1+v+A==; 31:MNCSRC/s4YTXLZwO7cvoH0R1huGio45g3PY6AXaRiqqwhm3OQzIvsfm0fT7AoGc+T8ZraRF6jZcho1dIoBWa05FdfXII//Po+M+mPnlCSmk4SUjj45/kVCB4mv63xIlBMjy6oW3epzZMyTHlCt5OoWL3u+Ol7VHh6RwSSxpkRm0xGchfln4KQBQyAl0SqvWiZcmpBZqB5jnXHKc2928aCL2pgFDUTW2wIU91w/MAHpo= X-MS-TrafficTypeDiagnostic: AM5PR0801MB1746: X-Microsoft-Exchange-Diagnostics: 1; AM5PR0801MB1746; 20:P7oStKk8lGny9VMpZdVy7ot0f1ChCabR2XBjrtM3Xf6ICYk43s97kLXJjbWt9WKjQCekP9q8nsq06OojhbF7Pj3mR9QaBuxnjp4j1QWgVEdGi6K62dPJGLQ7GzqKcS4PRbESFH4hi7rv/La8pDzT3x2UT0vV5d85oSWF08wBjo/YFsKXOm4ZzgusuiYQPWSasb8I307AkCTw5VAsDkjKUhQeuZOhB032DJcqxWR9IrgkByrqPqeyePoi4jlTIqlrYGTMNUq/ZeYErMBRAJ7L7DTVfmXB6MP0ooSoKGZr99amIFS9BarAsqEL18hvnGoGD6xJjtvhsgAKvqzS7KVLnks35XDhn4t/5+WNFfXwWwtJKvafKNwJnxPmtonBAZU3Gc2ZXLsyTH9WRcTzUUkeB4vHATfQV1Jke0hyayRLsQIfPcFYTgCs4f+FdQvICRa3j6qm54684MsYCXvTa1ohheR5V+DzmBWpcTRzpBKFywPor7WC90JR+1zxehOjcUi7; 4:sgCuqApXXPBSCKEEXDhCQibfNnGfJy2zKYDc3qjjmEfGyNQLYRRcjOjiwckFoqblrUUr0ojSdgnqia3uz1RLOz1UgDqHZ4NHvUhdCxMSIMoCvwUA/0Rd+AVncpsxPIHjCR1HQb8rLUvZvpPCVpG/TRQDHfCz2c0bOBKhBYbOf8xwHGeTWuZacsN4URH3XQyJS3E+O0Nb+9KDCpuaS8Zg+xXmrJ1gvenOtXyCusLsTdMxfab8514CM6Q3im236ssiootJ/dkrazU9DEb/5t1KQVeVDnaH6/ygE3t1ElJ1MWLcFEfgUgTcLGiog1cmT/81ZnNH/HdVlGir4AV0PxoU7WX9r7Pw6k4jLjjYwoSBluE= X-Microsoft-Antispam-PRVS: X-Exchange-Antispam-Report-Test: UriScan:(180628864354917)(103651359005742); X-MS-Exchange-SenderADCheck: 1 X-Exchange-Antispam-Report-CFA-Test: BCL:0; PCL:0; RULEID:(8211001083)(6040522)(2401047)(8121501046)(5005006)(823301075)(10201501046)(93006095)(93001095)(3231311)(944501410)(52105095)(3002001)(6055026)(149027)(150027)(6041310)(201703131423095)(201702281528075)(20161123555045)(201703061421075)(201703061406153)(20161123558120)(20161123560045)(20161123564045)(20161123562045)(201708071742011)(7699016); SRVR:AM5PR0801MB1746; BCL:0; PCL:0; RULEID:; SRVR:AM5PR0801MB1746; X-Forefront-PRVS: 078693968A X-Forefront-Antispam-Report: SFV:NSPM; SFS:(10009020)(396003)(39860400002)(366004)(136003)(376002)(346002)(189003)(199004)(40434004)(44832011)(5660300001)(486006)(575784001)(6486002)(6666003)(7416002)(1857600001)(14444005)(5024004)(105586002)(68736007)(106356001)(186003)(305945005)(47776003)(7736002)(86362001)(54906003)(956004)(2616005)(476003)(16526019)(316002)(72206003)(53416004)(26005)(2906002)(50466002)(81156014)(81166006)(53936002)(15650500001)(386003)(97736004)(48376002)(8676002)(51416003)(50226002)(6116002)(36756003)(52116002)(66066001)(1076002)(4326008)(25786009)(3846002)(478600001)(8936002)(7696005)(8746002); DIR:OUT; SFP:1101; SCL:1; SRVR:AM5PR0801MB1746; H:tiffany.arm.com; FPR:; SPF:None; LANG:en; PTR:InfoNoRecords; MX:1; A:1; Received-SPF: None (protection.outlook.com: arm.com does not designate permitted sender hosts) X-Microsoft-Exchange-Diagnostics: =?us-ascii?Q?1; AM5PR0801MB1746; 23:Pk+cNiFdF0rZkRg5+2SraWEDaw+5riBAz3lcHlu?= uAhb8z3IC63769wOqpfABC7qUHQe53ngP0+T9q+1r/OzdjjDLsraPff5ZwjutGrT95ckZ19kURgvdjKc2K5fIfzcHcG8Qyvqd/WJ9D+cR5WR1Rrk0ZE/LTwAVxluxwDHBgmxhfpHnIR3O19lQc6wO0ODpaa3F3dpSawgyo3pG5OGxt7yYMttLoFx6esVvFybgxLjBO1Ft9ecmk3ufJnZf+G45L2u+VgoeJ4DcKVyXa/+2EDHSzk/FBhWGzRYcf2L8XwOBo7+aBzeDVmby/VhLIGkdAVOh00sBSahgMWhgTNwjRdeAs/GWLHg3vj8p0qNVbGls9seHzyxoyfmH86a9BnHUPVmCJQUu6xARsKuwtaW7q907MtEjaNWj383vMSyGROYRTFGCz2LgzPnIoopuaQirA/S5OrHXlfQE2kUJAARzP2GcQPebcsU4anWhG84DU+dIKGx3D6YoAWo9bvaRFDn1VZCMqKRCVkThWL9OIx8UcKNyKKdBRipG2k5yfSk2Q6URycAL8drVfywkUmQ3me1MPCqK+bYmcOWCKxRHx9rjDdA8e3tUV1uajcl1/QcLfHFGuoGHUQi7VzXuzzZs9cf1TYi32yr7qMxPX4sI0s3icvGxytHG8ldj4KAMIVXT1hb6/bKDIapD/JuUI6Ao9kaPz2J4Xyqw4gILj/uojQ1g/2+dvGDzqBcz8uuWpFdG7axIW/4hpmMhc34ZtQ1YsUQih/3f/7ciwbgl9yXRrCwF6kbOX4wbMT5IHdmOZonNGkUZMuwzaaimtClsBz9Ud32LPw5HqviOlzEv3b3QUTHdL4l+fpytB1Ws8q9ue4wxNfkb1WCrY3fK4pm8oxRNMJ59QrcJODXjgu67Ojdo74BVAuTVu1tnpOmf0LMrd/Gx9MoN6cwwaFq+xkjw/9bTPByVFXlDOOHJ7NCPT9rSTcHwzxnV4DUlut7x90uryFcRnX/U8m+Tb3tTt7TeeMNwUD67WEWcO9DtUZOQp9/f4QxMnnortHuLa2sBidNQSy58MNdCXWVsEOnNMfvdmjA8qqJfaRr+M38yTewnHG0/2lC6fvfCh8PPTsy7i8xXSCnhnSBo7CPcFzC1ve88z+Dbh1z6JxeQXwRQHJ+tvJjYCQREp5takosXod/LazrPso+FpFcJaEIf04sJP0rwXxKwiBhtr6NBvKrBJRdCjh/GjAh07wsz+xFz+hIdnCu0tMqPqPzTPK+ZH+Tw257QH2dHUjnhQcfaKTS5ksh3wFOWkpcai+2zXIOJnZ1NC3/Yd0R5eIXIYI50A51BjpbHMPcNUCex X-Microsoft-Antispam-Message-Info: /NxM8jHkVIMFdZ9uJNZ6NqU4/ixJxyPh1FTQvJLRiJlUb/eDmf85NxXhRAx+yGcy08d5r1ktAGl/4iTgIYV2J85+NDsjv/Jvy5YgRNG+uvORlK2dK8/srE/FQOrNAY+UiqFPV1MWdevPb3O1K8F/TsUdtDGFJkGyLvAs/NYMedLzz8bIhf4cxDv0qGj87OHmigmU+02s/8DU+WYI5HhMSa7s+zEXwVWeFVv8aLVBVz+bnHWjO5lWiow7tVg3kJ7HhY523QnqXgeaxRjI6Jm6LLqpFGvlPOQ+IIRwervI/pobidmfaTbImTwbH+YMiVpmKTG15ntPCspoL8YKxumWW3XZ9I6fao1cD1dJ8ZFR65E= X-Microsoft-Exchange-Diagnostics: 1; AM5PR0801MB1746; 6:gyWJ3jh4ZJuAMmShETniJHAQnEsXT2xXDkxtAaIs7rhSQSCXS/OqDRG5UyjQ+d72UUv40pbd2blCDab6wTAJaJKYL6ox+WJygoKUAk1Bjl700AZwXStOiTr5q1+Yii3JCalsjKAeA15Yc9ruYs+h48TjEN7sSLFMbTNChwHdFIra68ewItRBccAUNQGPv6kzCLGu76MnRREqcO+LgaWSLNC91n8pX0kvQEheYwkkMKlZXympkRk+9gIPm6C4nRt/N07d8sqtCUWe3qGdLt4SnB6Cbqs+7JZJGJlqyn+OQ2u7358p3oExXGh1RGetr/mm8og2Kx8dTjkjwDaYqWQ1t8e5mr5fh/MwlwyajIysZGAep0BXka3MpHllUXovHdSzZpkGMUhms/FAB/DxiVGXBYGvBQbEOaj+nzWrXKf9kN2jwL8n0IbYOfVc2WSpuiqMMooxrdK89HLOBJwQtZO6iw==; 5:0XNZMJYyPtkRgq7LJAc7yj0F5Qma5DyQQHSlaufxOeHw9gN7vp0BZZMIdJz23p0HjHf0vi3ZMBqg1jkMQYwPcRHS9WGxeJoPNwYoGVI67ZImSd63IiorFeEVeHUYhumX/dhohh9IPA3UzetDNFTHs8fD4p8o/R17ot865BBbeX4=; 7:yG390Zkyg6RkgDQ2aXfBDff8mVp0jEeOuCmW0O/ttmoLp96fYlXcaB4mI3AbLy60MLxo7dqJIVOYwjEKyFxh4vIX1pdZak4EhzCk6s8I0hSZi6HsutEmHMcTON2XK5HbpRIa+PJ569RZTYdneXrvCmGQwMjGQwEciQWkdrkT/YGa0cNmOardy2UxtkYKp0Iba6ZaSWlbWoh3uAFeJEhbPifrkmizJWtFmxlLrW+6FpPQDeLcwXT6hVr0mFPTsClq SpamDiagnosticOutput: 1:99 SpamDiagnosticMetadata: NSPM X-OriginatorOrg: arm.com X-MS-Exchange-CrossTenant-OriginalArrivalTime: 05 Sep 2018 19:08:22.0037 (UTC) X-MS-Exchange-CrossTenant-Network-Message-Id: 0370c700-a457-43cc-87bf-08d61362f340 X-MS-Exchange-CrossTenant-FromEntityHeader: Hosted X-MS-Exchange-CrossTenant-Id: f34e5979-57d9-4aaa-ad4d-b122a662184d X-MS-Exchange-Transport-CrossTenantHeadersStamped: AM5PR0801MB1746 X-CRM114-Version: 20100106-BlameMichelson ( TRE 0.8.0 (BSD) ) MR-646709E3 X-CRM114-CacheID: sfid-20180905_120838_502124_30BEEA0E X-CRM114-Status: GOOD ( 12.97 ) X-BeenThere: linux-arm-kernel@lists.infradead.org X-Mailman-Version: 2.1.21 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Cc: Jonathan Corbet , arnd@arndb.de, scott.branden@broadcom.com, catalin.marinas@arm.com, Ard Biesheuvel , will.deacon@arm.com, agraf@suse.de, leif.lindholm@linaro.org, Grant Likely , olof@lixom.net Sender: "linux-arm-kernel" Errors-To: linux-arm-kernel-bounces+patchwork-linux-arm=patchwork.kernel.org@lists.infradead.org X-Virus-Scanned: ClamAV using ClamSMTP The dtb= parameter is no longer the primary mechanism for providing a devicetree to the kernel. Now either firmware or the boot selector (ex. Grub) should provide the devicetree and dtb= should only be used for debug or when using firmware that doesn't understand DT. Update the EFI stub documentation to reflect the current usage. Signed-off-by: Grant Likely Cc: Ard Biesheuvel Cc: Jonathan Corbet Acked-by: Leif Lindholm Reviewed-by: Alexander Graf Acked-by: Olof Johansson --- Documentation/efi-stub.txt | 17 ++++++++++++++--- 1 file changed, 14 insertions(+), 3 deletions(-) -- 2.11.0 IMPORTANT NOTICE: The contents of this email and any attachments are confidential and may also be privileged. If you are not the intended recipient, please notify the sender immediately and do not disclose the contents to any other person, use it for any purpose, or store or copy the information in any medium. Thank you. diff --git a/Documentation/efi-stub.txt b/Documentation/efi-stub.txt index 41df801f9a50..833edb0d0bc4 100644 --- a/Documentation/efi-stub.txt +++ b/Documentation/efi-stub.txt @@ -83,7 +83,18 @@ is passed to bzImage.efi. The "dtb=" option ----------------- -For the ARM and arm64 architectures, we also need to be able to provide a -device tree to the kernel. This is done with the "dtb=" command line option, -and is processed in the same manner as the "initrd=" option that is +For the ARM and arm64 architectures, a device tree must be provided to +the kernel. Normally firmware shall supply the device tree via the +EFI CONFIGURATION TABLE. However, the "dtb=" command line option can +be used to override the firmware supplied device tree, or to supply +one when firmware is unable to. + +Please note: Firmware adds runtime configuration information to the +device tree before booting the kernel. If dtb= is used to override +the device tree, then any runtime data provided by firmware will be +lost. The dtb= option should only be used either as a debug tool, or +as a last resort when a device tree is not provided in the EFI +CONFIGURATION TABLE. + +"dtb=" is processed in the same manner as the "initrd=" option that is described above.